The Azure SDK team is pleased to announce our March 2021 client library releases.


  • Azure Mixed Reality Authentication
  • Core
  • Event Grid


  • App Configuration
  • Event Hubs
  • Event Hubs - Event Processor
  • Storage - Blobs
  • Storage - Blobs Batch
  • Storage - Common
  • Storage - Files Data Lake
  • Storage - Files Shares
  • Storage - Queues


  • Azure Communication Chat
  • Azure Communication Common
  • Azure Communication Identity
  • Azure Communication Phone Numbers
  • Azure Communication SMS
  • Form Recognizer
  • Identity
  • IoT Device Update
  • Service Bus
  • Synapse - Artifacts
  • Tables
  • Text Analytics
  • WebJobs Extensions - Event Grid
  • WebJobs Extensions - Service Bus

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.FormRecognizer --version 3.1.0-beta.3
$> dotnet add package Azure.AI.TextAnalytics --version 5.1.0-beta.5
$> dotnet add package Azure.Analytics.Synapse.Artifacts --version 1.0.0-preview.7
$> dotnet add package Azure.Communication.Chat --version 1.0.0-beta.5
$> dotnet add package Azure.Communication.Common --version 1.0.0-beta.5
$> dotnet add package Azure.Communication.Identity --version 1.0.0-beta.5
$> dotnet add package Azure.Communication.PhoneNumbers --version 1.0.0-beta.6
$> dotnet add package Azure.Communication.SMS --version 1.0.0-beta.4
$> dotnet add package Azure.Core --version 1.10.0
$> dotnet add package Azure.Core --version 1.11.0
$> dotnet add package Azure.Data.AppConfiguration --version 1.1.0-beta.1
$> dotnet add package Azure.Data.Tables --version 12.0.0-beta.6
$> dotnet add package Azure.Identity --version 1.4.0-beta.4
$> dotnet add package Azure.IoT.DeviceUpdate --version 1.0.0-beta.2
$> dotnet add package Azure.IoT.ModelsRepository --version 1.0.0-preview.2
$> dotnet add package Azure.Messaging.EventGrid --version 4.0.0
$> dotnet add package Azure.Messaging.EventGrid --version 4.1.0
$> dotnet add package Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents --version 1.0.0-beta.1
$> dotnet add package Azure.Messaging.EventHubs --version 5.3.1
$> dotnet add package Azure.Messaging.EventHubs.Processor --version 5.3.1
$> dotnet add package Azure.MixedReality.Authentication --version 1.0.0
$> dotnet add package Azure.MixedReality.ObjectAnchors.Conversion --version 0.1.0-beta.1
$> dotnet add package Azure.MixedReality.RemoteRendering --version 1.0.0-beta.3
$> dotnet add package Azure.Storage.Blobs --version 12.8.1
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.5.1
$> dotnet add package Azure.Storage.Common --version 12.7.1
$> dotnet add package Azure.Storage.Files.DataLake --version 12.6.1
$> dotnet add package Azure.Storage.Files.Shares --version 12.6.1
$> dotnet add package Azure.Storage.Queues --version 12.6.1
$> dotnet add package Azure.Quantum.Jobs --version 1.0.0-beta.2
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.EventGrid --version 3.0.0-beta.1
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.ServiceBus --version 5.0.0-beta.1


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

Release highlights

Form Recognizer 3.1.0-beta.3 Changelog

New features

  • Added protected constructors for mocking to Operation types, such as TrainingOperation and RecognizeContentOperation.

Text Analytics 5.1.0-beta.5 Changelog

New features

  • Added ability to filter the categories returned in a Personally Identifiable Information recognition with the optional parameter CategoriesFilter in RecognizePiiEntitiesOptions.
  • Added the ability to recognize linked entities under StartAnalyzeBatchActions.
  • Added RecognizeLinkedEntitiesOptions to TextAnalyticsActions.
  • Added RecognizeLinkedEntitiesActionsResults to AnalyzeBatchActionsResult.
  • AnalyzeHealthcareEntitiesResult, now exposes the property EntityRelationsof type HealthcareEntityRelation.
  • Introduced HealthcareEntityRelation class which will determine all the different relations between the entities as Roles.
  • Added HealthcareEntityRelationRole, which exposes Name and Entity of type string and HealthcareEntity respectively.
  • HealthcareEntityAssertion is added to HealthcareEntity which further exposes EntityAssociation, EntityCertainity and EntityConditionality.
  • Added new types under HealthcareRelationType class.

Breaking changes

  • Renamed AspectSentiment to TargetSentiment.
  • Renamed MinedOpinion to SentenceOpinion.
  • Renamed OpinionSentiment to AssessmentSentiment.
  • For PiiEntity.Category the type of the property is now PiiEntityCategory instead of EntityCategory.
  • Removed RelatedEntities.
  • RecognizePiiEntitiesOptions.Domain is now a nullable type.
  • In StartAnalyzeBatchActions when all actions return status failed the SDK will no longer throw an exception. The request will succeed and the errors will be located at the specific action level.


  • RecognizePiiEntities and TextAnalyticsActions.RecognizePiiEntitiesOptions were always passing PiiEntityDomainType.PHI. Now, it is only passed when requested by the user 19086.

Synapse - Artifacts 1.0.0-preview.7 Changelog


  • Many models classes now have public getters.
  • Added new LibraryClient and associated support types.

Azure Communication Administration is deprecated

  • PhoneNumberAdministrationClient has moved into the new package Azure.Communication.PhoneNumbers and been replaced by PhoneNumberClient.

Azure Communication Chat 1.0.0-beta.5 Changelog

Breaking Changes

  • Added support for communication identifiers instead of raw strings.
  • Removed support for nullable reference types.

Azure Communication Common 1.0.0-beta.5 Changelog

Breaking Changes

  • Updated CommunicationTokenRefreshOptions(bool refreshProactively, Func<CancellationToken, string> tokenRefresher, Func<CancellationToken, ValueTask<string>> asyncTokenRefresher = null, string initialToken = null) to CommunicationTokenRefreshOptions(bool refreshProactively, Func<CancellationToken, string> tokenRefresher). AsyncTokenRefresher and InitialToken are updated to become public properties.

Azure Communication Identity 1.0.0-beta.5 Changelog

Breaking Changes

  • CommunicationIdentityClient.IssueToken and CommunicationIdentityClient.IssueTokenAsync are renamed to GetToken and GetTokenAsync, respectively.
  • CommunicationIdentityClient.CreateUserWithToken and CommunicationIdentityClient.CreateUserWithTokenAsync are renamed to CreateUserAndToken and CreateUserAndTokenAsync, respectively. Their return value is also changed from Tuple<CommunicationUserIdentifier, string> to CommunicationUserIdentifierAndToken.

Azure Communication Phone Numbers 1.0.0-beta.5 Changelog

New features

  • Added PhoneNumbersClient (originally was part of the Azure.Communication.Administration package).
  • Added support for Azure Active Directory Authentication.

Breaking Changes

  • PhoneNumberAdministrationClient has been replaced with PhoneNumbersClient, which has the same functionality but different APIs. To learn more about how PhoneNumbersClient works, refer to the

Azure Communication SMS 1.0.0-beta.4 Changelog

New features

  • Added support to create SmsClient with AzureKeyCredential.
  • Added support to create SmsClient with TokenCredential.
  • Added support for 1:N SMS messaging.
  • Added support for tagging SMS messages.
  • Send method series in SmsClient are idempotent under retry policy.

Breaking Changes

  • Updated Task<Response<SendSmsResponse>> SendAsync(PhoneNumberIdentifier from, PhoneNumberIdentifier to, string message, SendSmsOptions sendSmsOptions = null, CancellationToken cancellationToken = default) to Task<Response<SmsSendResult>> SendAsync(string from, string to, string message, SmsSendOptions options = default)
  • Replaced SendSmsResponse with SmsSendResult

Core 1.10.0 Changelog

Core 1.11.0 Changelog


  • Operation base class for operations that do not return a value.
  • Added Content property to Response which returns the body of the response as a BinaryData if the body is buffered.
  • AzureNamedKeyCredential has been implemented to cover scenarios where services require that a shared key name and the key value be used as a component of the algorithm to form the authorization token.

Key Bug Fixes

  • Check the JsonIgnoreAttribute.Condition property added in .NET 5 when discovering members with JsonObjectSerializer.
  • ETag now returns string.Empty if it is constructed with a null value.
  • Keep-Alive connections are recycled every 300 seconds to observe DNS changes.

App Configuration 1.1.0-beta.1 Changelog


New features
  • Added SecretReferenceConfigurationSetting type to represent a configuration setting that references a KeyVault Secret.
  • Added FeatureFlagConfigurationSetting type to represent a configuration setting that controls a feature flag.
  • Added AddSyncToken to ConfigurationClient to be able to provide external synchronization tokens.

Tables 12.0.0-beta.6 Changelog


  • Changed major version number to 12 to indicate this is the latest Tables package across all legacy versions and for cross-language consistency.
  • TableClient and TableServiceClient now accept AzureSasCredential for SAS token scenarios rather than requiring developers to build the URI manually.

Key Bug Fixes

  • Fixed an issue that prevented start/end row key and partition key values from being used in Sas tokens


  • Added TableUriBuilder
  • Added a constructor to TableSasBuilder and TableAccountSasBuilder that accepts a Uri with a Sas token

Identity 1.4.0-beta.4 Changelog

Fixes and Improvements

  • Added the [Serializable] attribute to all custom exception types.

Breaking Changes

  • Update the default value of ExcludeSharedTokenCacheCredential on DefaultAzureCredentialsOptions to true, to exclude the SharedTokenCacheCredential from the DefaultAzureCredential by default. See

Event Grid 4.0.0 Changelog

New features

  • Added single send overloads to allow sending a single event for each event type.

Breaking Changes

  • Moved CloudEvent into Azure.Core package.
  • Changed custom events to be represented as BinaryData rather than Objects.
  • Removed Serializer option from EventGridPublisherOptions as serialization can be customized through BinaryData.

EventGrid CloudNativeCloudEvents Changelog

New features

  • Added Bridge library to allow sending CloudNative CloudEvents using Azure Event Grid.

Event Hubs 5.3.1 Changelog

  • Minor bug fixes and enhancements.

Event Hubs - Event Processor 5.3.1 Changelog

  • Minor bug fixes and enhancements.

Azure Mixed Reality Authentication 1.0.0 Changelog

  • First stable release.

Azure Remote Rendering 1.0.0-beta.3 Changelog

  • Allow the STS endpoint to be customized.
  • Changed constructors to align with guidance.

Azure Object Anchors Conversion 0.1.0-beta.1 Changelog

  • Initial client

IoT Device Update 1.0.0-beta.2 Changelog

  • Update root namespace from Azure.Iot.DeviceUpdate to Azure.IoT.DeviceUpdate

    WebJobs Extensions - Event Grid 3.0.0-beta.1 Changelog

  • The initial release of Microsoft.Azure.WebJobs.Extensions.EventGrid 3.0.0

Event Grid 4.1.0 Changelog

New Features

  • Added new Azure Communication Services system events.


  • Fixed system mapping for AcsChatParticipantAddedToThread and AcsChatParticipantRemovedFromThread.

WebJobs Extensions - Service Bus 5.0.0-beta.1 Changelog

  • The initial release of Microsoft.Azure.WebJobs.Extensions.ServiceBus 5.0.0

Storage - Queues 12.6.1 Changelog

  • Fixed bug where ClientDiagnostics’s DiagnosticListener was leaking resources.

Storage - Files Data Lake 12.6.1 Changelog

  • Fixed bug where ClientDiagnostics’s DiagnosticListener was leaking resources.

Storage - Files Shares 12.6.1 Changelog

  • Fixed bug where ClientDiagnostics’s DiagnosticListener was leaking resources.

Storage - Common 12.7.1 Changelog

  • This release contains bug fixes to improve quality.

Storage - Blobs Batch 12.5.1 Changelog

  • Fixed bug where ClientDiagnostics’s DiagnosticListener was leaking resources.

Storage - Blobs 12.8.1 Changelog

  • Fixed bug where ClientDiagnostics’s DiagnosticListener was leaking resources.

Azure.Quantum.Jobs 1.0.0-beta.2 Changelog

  • Fixed a bug where the client was unable to authenticate using Interactive or Service Principal credentials (issue #19588)

Azure.IoT.ModelsRepository 1.0.0-preview.2 Changelog

Breaking changes

  • Changing the package namespace from Azure.IoT.ModelsRepository to Azure.IoT.ModelsRepository

Latest Releases

View all the latest versions of .NET packages here.