The Azure SDK team is pleased to announce our July 2024 client library releases.

51 packages released this month.

Stable Packages (25)

  • Azure AI Search

  • Core - Client - Core

  • Functions Extensions - WebPubSub

  • Identity

  • Resource Management - API Management

  • Resource Management - Container Apps

  • Resource Management - Data Protection

  • Resource Management - Key Vault

  • Resource Management - MySQL

  • Resource Management - NetApp Files

  • Resource Management - Network

  • Resource Management - New Relic Observability

  • Resource Management - Oracledatabase

  • Resource Management - Redis

  • Resource Management - Resources

  • Resource Management - Service Fabric Managed Clusters

  • Resource Management - Storage

  • Resource Management - Storage Mover

  • Service Bus

  • Storage - Blobs

  • Storage - Blobs Batch

  • Storage - Common

  • Storage - Files Data Lake

  • Storage - Files Share

  • Storage - Queues

Patch Updates (7)

  • Event Grid

  • Event Hubs

  • Event Hubs - Event Processor

  • Functions extension for Blob Storage

  • Functions extension for Storage Queues

  • Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents

  • Resource Management - Container Service

Beta Packages (16)

  • Communication Email

  • Data Movement

  • Data Movement - Blobs

  • Data Movement - Files Shares

  • Document Translation

  • OpenAI Inference

  • OpenTelemetry AspNetCore

  • OpenTelemetry Exporter

  • Resource Management - Cosmos DB

  • Resource Management - Informaticadatamanagement

  • Resource Management - Oracledatabase

  • Resource Management - SQL

  • Resource Management - Self Help

  • Storage - Blobs ChangeFeed

  • System.ClientModel

  • unknown

Release highlights

Azure AI Search 11.6.0 Changelog

Features Added

  • Added support for 2024-07-01 service version.
  • SemanticSearchOptions now supports SemanticQuery, which allows for specifying a semantic query that is only used for semantic reranking.
  • VectorQuery now supports Oversampling and Weight, which allows for specifying richer configurations on how vector queries affect search results.
  • Added support for VectorizableTextQuery, which allows for passing a text-based query that is vectorized service-side by VectorSearchVectorizers configured on the index so that vectorization doesn’t need to happen before querying.
  • Added support for “bring your own endpoint” with VectorSearchVectorizer, with implementations AzureOpenAIVectorizer and WebApiVectorizer. This enables the service to use a user-provided configuration for vectorizing text, rather than requiring all client-side calls to vectorize before querying, allowing for easier standardization of vectorization.
  • Added support for compression with VectorSearchCompression, with implementations BinaryQuantizationCompression and ScalarQuantizationCompression. This allows for reducing the size of vectors in the index, which can reduce storage costs and improve querying performance.
  • Added support for VectorEncodingFormat, which allows for specifying the encoding format of the vector data.
  • Added support for AzureOpenAIEmbeddingSkill, which is a skill that uses the Azure OpenAI service to create text embeddings during indexing.
  • Added support for index projections with SearchIndexerIndexProjection, which allows for specifying how indexed documents are projected in the index (or indexes).
  • Added support for “narrow” types in SearchFieldDataType. This allows for specifying smaller types for vector fields to reduce storage costs and improve querying performance.
  • Added support for SearchIndexerDataIdentity, which allows for specifying the identity for the data source for the indexer.
  • SearchField and SearchableField now support IsStored and VectorEncodingFormat configurations. IsStored allows for specifying behaviors on how the index will retain vector data (enabling the ability to reduce storage costs), and VectorEncodingFormat allows for specifying the encoding format of the vector data.
  • OcrSkill now supports LineEnding, which allows for specifying the line ending character used by the OCR skill.
  • SplitSkill now supports MaximumPagesToTake and PageOverlapLength, which allows for specifying how the split skill behaves when splitting documents into pages.
  • SearchServiceLimits now supports MaxStoragePerIndexInBytes, which shows the maximum storage allowed per index.

Breaking Changes

  • All service concepts that have been in preview but not included in the 2024-07-01 GA have been removed. This includes concepts such as index aliases, normalizers, Azure Machine Learning skills, hybrid search, and more.

Communication Email 1.1.0-beta.1 Changelog

Features Added

  • Consumers can now provide their own value for the Operation ID when sending emails. New overloads have been added to EmailClient with the operationId parameter.

Core - Client - Core 1.41.0 Changelog

Bugs Fixed

  • Fixed an issue that could result in BearerTokenAuthenticationPolicy fails to refresh a token, resulting in a OperationCanceledException (#44882).
  • Fixed case where a GeoJSON string could not be deserialized when the BoundingBox JSON value (“bbox”) was set explicitly to null (#44835).

Data Movement 12.0.0-beta.5 Changelog

Bugs Fixed

  • Fixed a bug where ChannelClosedException could occur and be sent as an event to ItemTransferFailed when there was a failure during a transfer.

Breaking Changes

  • Renamed StorageResourceProperties to StorageResourceItemProperties
  • Renamed StorageResourceReadStreamResult.ContentRange to Range
  • Removed the following members from StorageResourceReadStreamResult:
  • AcceptRanges
  • RangeContentHash

Data Movement - Blobs 12.0.0-beta.5 Changelog

Breaking Changes

  • Changed BlobStorageResourceOptions members to be wrapped by DataTransferProperty type to allow preserving. The following members are affected:
  • BlobStorageResourceOptions.ContentType
  • BlobStorageResourceOptions.ContentLanguage
  • BlobStorageResourceOptions.ContentEncoding
  • BlobStorageResourceOptions.ContentDisposition
  • BlobStorageResourceOptions.CacheControl
  • BlobStorageResourceOptions.Metadata
  • Changed BlobStorageResourceContainerOptions.BlobType from Azure.Storage.Blobs.Models.BlobType to DataTransferProperty<Azure.Storage.Blobs.Models.BlobType>

Features Added

  • Added ability to preserve Blob Metadata and properties on Blob to Blob copy.
  • Added ability to preserve Blob Type on Blob Container to Blob Container copy.

Data Movement - Files Shares 12.0.0-beta.2 Changelog

Breaking Changes

  • Removed DownloadTransferValidationOptions and UploadTransferValidationOptions from ShareFileStorageResourceOptions.
  • Removed ShareFileStorageResourceOptions.SmbProperties, use the following instead:
  • ShareFileStorageResourceOptions.FilePermissionKey
  • ShareFileStorageResourceOptions.FileAttributes
  • ShareFileStorageResourceOptions.FileCreatedOn
  • ShareFileStorageResourceOptions.FileLastWrittenOn
  • ShareFileStorageResourceOptions.FileChangedOn
  • Removed ShareFileStorageResourceOptions.HttpHeaders, use the following instead:
  • ShareFileStorageResourceOptions.ContentType
  • ShareFileStorageResourceOptions.ContentLanguage
  • ShareFileStorageResourceOptions.ContentEncoding
  • ShareFileStorageResourceOptions.ContentDisposition
  • ShareFileStorageResourceOptions.CacheControl
  • Changed ShareFileStorageResourceOptions.FileMetadata and DirectoryMetadata to be wrapped by DataTransferProperty type to allow preserving.
  • Removed ShareFileStorageResourceOptions.FilePermissionKey and FilePermissions use ShareFileStorageResourceOptions.FilePermissions instead.`

Features Added

  • Improved upload and copying chunking strategy for large Share Files to improve speed
  • Added ability to preserve Share File Metadata, properties, and Permissions on Share File to Share File copy.

Document Translation 2.0.0-beta.2 Changelog

Features Added

  • Single document translation client can be created using endpoint alone, mainly for SDK to work against containers.

Bugs Fixed

  • SourceInput options which is a part of TranslationInput is now public. This allows users to enter source language, source storage, and document filter prefix and suffix.

Event Grid 4.24.1 Changelog

Bugs Fixed

  • Fixed deserialization bugs in AcsEmailEngagementTrackingReportReceivedEventData and AcsEmailDeliveryReportReceivedEventData system events that caused the DeliveryAttemptTimestamp and UserActionTimeStamp properties to be null.

Event Hubs 5.11.4 Changelog

Bugs Fixed

  • Fixed an error that prevented relative URIs from being used with application properties in the EventData.Properties collection.

  • Fixed an error with ETW logs which caused structured arguments for Id 105 (Event Processor position determined) to be out-of-order with the message format. This also caused the date to render incorrectly for some captures.

Event Hubs - Event Processor 5.11.4 Changelog

Bugs Fixed

  • Fixed an error that prevented relative URIs from being used with application properties in the EventData.Properties collection.

  • Fixed an error with ETW logs which caused structured arguments for Id 105 (Event Processor position determined) to be out-of-order with the message format. This also caused the date to render incorrectly for some captures.

Functions Extensions - WebPubSub 1.7.0 Changelog

Features Added

  • Initial official release

Functions extension for Blob Storage 5.3.1 Changelog

Bugs Fixed

  • Rely on PeekMessagesAsync when calculating message queue length
  • Fixing target base scale instance concurrency for queues
  • Bumped version of Azure.Storage.Blobs to resolve issue where Blob Path was being truncated at ‘#’ character.

Functions extension for Storage Queues 5.3.1 Changelog

Bugs Fixed

  • Rely on PeekMessagesAsync when calculating message queue length
  • Fixing target base scale instance concurrency for queues
  • When grabbing Queue Metrics for amount of messages, will now use the QueueTriggerMetrics.QueueLength instead of the ApproximateMessagesCount for less stale metrics.

Identity 1.12.0 Changelog

Features Added

  • Added AzurePipelinesCredential for authenticating with Azure Pipelines service connections.
  • OnBehalfOfCredential now supports client assertion callbacks for acquiring tokens on behalf of a user.
  • All credentials now support setting RefreshOn value if received from MSAL.
  • ManagedIdentityCredential sets RefreshOn value of half the token lifetime for AccessTokens with an ExpiresOn value greater than 2 hours in the future.
  • ClientAssertionCredentialOptions now supports TokenCachePersistenceOptions for configuring token cache persistence.

Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents 1.0.1 Changelog

Other Changes

  • Updated README.md to reflect the latest changes

OpenAI Inference 2.0.0-beta.2 Changelog

Breaking Changes

  • In support of CancellationTokens in methods, an overriden method signature for streaming chat completions was changed and a new minimum version dependency of 2.0.0-beta.5 is established for the OpenAI dependency. These styles of breaks will be extraordinarily rare.

Bugs Fixed

  • See breaking changes: when streaming chat completions, an error of “Unrecognized request argument supplied: stream_options” is introduced when using Azure.AI.OpenAI 2.0.0-beta.1 with OpenAI 2.0.0-beta.5+. This is fixed with the new version.

Features Added

  • Per changes to the OpenAI .NET client library, most convenience methods now provide the direct ability to provide optional CancellationTokens, removing the need to use protocol methods

OpenTelemetry AspNetCore 1.3.0-beta.1 Changelog

Bugs Fixed

  • Added the LogRecord.CategoryName field to log and exception telemetry. Previously the CategoryName field was omitted, which was inconsistent with expected ILogger behavior, and with Application Insights classic behavior. (#44754)

  • Fixed an issue where a DuplicateKeyException could be thrown if EventId and EventName were present in both LogRecord (LogRecord.EventId, LogRecord.EventName) and LogRecord.Attributes. The method now uses EventId and EventName from LogRecord.Attributes when both are present. If they are not in LogRecord.Attributes, it uses the values from LogRecord.EventId or LogRecord.EventName, preventing the LogRecord from being dropped. (#44748)

OpenTelemetry Exporter 1.4.0-beta.1 Changelog

Features Added

  • Added LoggerProviderBuilder.AddAzureMonitorLogExporter registration extension. (#44617)

Bugs Fixed

  • Added the LogRecord.CategoryName field to log and exception telemetry. Previously the CategoryName field was omitted, which was inconsistent with expected ILogger behavior, and with Application Insights classic behavior. (#44754)

Resource Management - API Management 1.2.0 Changelog

Resource Management - Container Apps 1.2.0 Changelog

Resource Management - Container Service 1.2.2 Changelog

Resource Management - Cosmos DB 1.4.0-beta.10 Changelog

Resource Management - Data Protection 1.5.0 Changelog

Resource Management - Informaticadatamanagement 1.0.0-beta.1 Changelog

Resource Management - Key Vault 1.3.0 Changelog

Resource Management - MySQL 1.1.0 Changelog

Resource Management - NetApp Files 1.6.0 Changelog

Resource Management - Network 1.8.0 Changelog

Resource Management - New Relic Observability 1.1.0 Changelog

Resource Management - Oracledatabase 1.0.0-beta.1 Changelog

Resource Management - Oracledatabase 1.0.0 Changelog

Resource Management - Redis 1.4.0 Changelog

Resource Management - Resources 1.8.0 Changelog

Resource Management - SQL 1.3.0-beta.9 Changelog

Resource Management - Self Help 1.1.0-beta.4 Changelog

Resource Management - Service Fabric Managed Clusters 1.2.0 Changelog

Resource Management - Storage 1.3.0 Changelog

Resource Management - Storage Mover 1.2.0 Changelog

Service Bus 7.18.0 Changelog

Bugs Fixed

  • Fixed an issue that caused connection strings using host names without a scheme to fail parsing and be considered invalid.

  • Fixed an issue where the scheduled enqueue time was not cleared when creating a new message from a received message.

  • Fixed an issue that prevented relative URIs from being used with application properties in the ServiceBusMessage.ApplicationProperties and ServiceBusReceivedMessage.ApplicationProperties collections.

  • Fixed an issue that caused ServiceBusMessageBatch to accept more than the allowed 1mb batch limit when sending to Service Bus entities with large message sizes enabled.

  • Fixed issue where the SupportOrdering property was not being respected when set on CreateTopicOptions.

Storage - Blobs 12.21.0 Changelog

Features Added

  • Includes all features from 12.21.0-beta.1.

Bugs Fixed

  • Fixed bug where storage clients when constructed with URLs with ‘#’ character would truncate the blob name at the ‘#’.

Storage - Blobs Batch 12.18.0 Changelog

Features Added

  • Includes all features from 12.18.0-beta.1.

Storage - Blobs ChangeFeed 12.0.0-preview.46 Changelog

Features Added

  • This release contains bug fixes to improve quality.

Storage - Common 12.20.0 Changelog

Features Added

  • Includes all features from 12.20.0-beta.1.

Storage - Files Data Lake 12.19.0 Changelog

Features Added

  • Includes all features from 12.19.0-beta.1.

Bugs Fixed

  • Fixed bug where storage clients when constructed with URLs with ‘#’ character would truncate the path at the ‘#’.

Storage - Files Share 12.19.0 Changelog

Features Added

  • Includes all features from 12.19.0-beta.1.

Bugs Fixed

  • Fixed bug where storage clients when constructed with URLs with ‘#’ character would truncate the path at the ‘#’.

Storage - Queues 12.19.0 Changelog

Features Added

  • Includes all features from 12.19.0-beta.1.

System.ClientModel 1.1.0-beta.5 Changelog

Features Added

  • Added AsyncPageCollection<T> and PageCollection<T> types as return types from paginated service operations, and ContinuationToken type for resuming collection state across processes.

unknown 1.0.0-beta.1 Changelog

Features Added

  • Initial beta release of Azure.Messaging.EventGrid.SystemEvents.

unknown 1.0.0-beta.1 Changelog

Features Added

New design of track 2 initial commit. This package, Azure.Compute.Batch, replaces Microsoft.Azure.Batch.

This package follows the new Azure SDK guidelines, and provides many core capabilities.

This package is a Public Preview version, so expect incompatible changes in subsequent releases as we improve the product. To provide feedback, submit an issue in our Azure SDK for .NET GitHub repo.

NOTE: For more information about unified authentication, please refer to Microsoft Azure Identity documentation for .NET.

unknown 1.0.0-beta.1 Changelog

Features Added

  • Added support to enable WCF clients to be able to send requests to a CoreWCF service which uses Azure Queue Storage as a transport as a modern replacement to using MSMQ.

unknown 1.0.0-beta.1 Changelog

Features Added

  • Added support to CoreWCF service for Azure Queue Storage to receive requests from clients as a modern replacement to using MSMQ.

Latest Releases

View all the latest versions of .NET packages here.

Installation Instructions

To install any of our packages, please search for them via Manage NuGet Packages... in Visual Studio (with Include prerelease checked) or copy these commands into your terminal:

$> dotnet add package Azure.AI.OpenAI --version 2.0.0-beta.2
$> dotnet add package Azure.AI.Translation.Document --version 2.0.0-beta.2
$> dotnet add package Azure.Communication.Email --version 1.1.0-beta.1
$> dotnet add package Azure.Compute.Batch --version 1.0.0-beta.1
$> dotnet add package Azure.Core --version 1.41.0
$> dotnet add package Azure.Identity --version 1.12.0
$> dotnet add package Azure.Messaging.EventGrid --version 4.24.1
$> dotnet add package Azure.Messaging.EventGrid.SystemEvents --version 1.0.0-beta.1
$> dotnet add package Azure.Messaging.EventHubs --version 5.11.4
$> dotnet add package Azure.Messaging.EventHubs.Processor --version 5.11.4
$> dotnet add package Azure.Messaging.ServiceBus --version 7.18.0
$> dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore --version 1.3.0-beta.1
$> dotnet add package Azure.Monitor.OpenTelemetry.Exporter --version 1.4.0-beta.1
$> dotnet add package Azure.ResourceManager.ApiManagement --version 1.2.0
$> dotnet add package Azure.ResourceManager.AppContainers --version 1.2.0
$> dotnet add package Azure.ResourceManager.ContainerService --version 1.2.2
$> dotnet add package Azure.ResourceManager.CosmosDB --version 1.4.0-beta.10
$> dotnet add package Azure.ResourceManager.DataProtectionBackup --version 1.5.0
$> dotnet add package Azure.ResourceManager.InformaticaDataManagement --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.KeyVault --version 1.3.0
$> dotnet add package Azure.ResourceManager.MySql --version 1.1.0
$> dotnet add package Azure.ResourceManager.NetApp --version 1.6.0
$> dotnet add package Azure.ResourceManager.Network --version 1.8.0
$> dotnet add package Azure.ResourceManager.NewRelicObservability --version 1.1.0
$> dotnet add package Azure.ResourceManager.OracleDatabase --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.OracleDatabase --version 1.0.0
$> dotnet add package Azure.ResourceManager.Redis --version 1.4.0
$> dotnet add package Azure.ResourceManager.Resources --version 1.8.0
$> dotnet add package Azure.ResourceManager.SelfHelp --version 1.1.0-beta.4
$> dotnet add package Azure.ResourceManager.ServiceFabricManagedClusters --version 1.2.0
$> dotnet add package Azure.ResourceManager.Sql --version 1.3.0-beta.9
$> dotnet add package Azure.ResourceManager.Storage --version 1.3.0
$> dotnet add package Azure.ResourceManager.StorageMover --version 1.2.0
$> dotnet add package Azure.Search.Documents --version 11.6.0
$> dotnet add package Azure.Storage.Blobs --version 12.21.0
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.18.0
$> dotnet add package Azure.Storage.Blobs.ChangeFeed --version 12.0.0-preview.46
$> dotnet add package Azure.Storage.Common --version 12.20.0
$> dotnet add package Azure.Storage.DataMovement --version 12.0.0-beta.5
$> dotnet add package Azure.Storage.DataMovement.Blobs --version 12.0.0-beta.5
$> dotnet add package Azure.Storage.DataMovement.Files.Shares --version 12.0.0-beta.2
$> dotnet add package Azure.Storage.Files.DataLake --version 12.19.0
$> dotnet add package Azure.Storage.Files.Shares --version 12.19.0
$> dotnet add package Azure.Storage.Queues --version 12.19.0
$> dotnet add package Microsoft.Azure.Functions.Worker.Extensions.WebPubSub --version 1.7.0
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.AuthenticationEvents --version 1.0.1
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage.Blobs --version 5.3.1
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage.Queues --version 5.3.1
$> dotnet add package Microsoft.CoreWCF.Azure.StorageQueues --version 1.0.0-beta.1
$> dotnet add package Microsoft.WCF.Azure.StorageQueues --version 1.0.0-beta.1
$> dotnet add package System.ClientModel --version 1.1.0-beta.5

Feedback

If you have a bug or feature request for one of the libraries, please file an issue in our repo.