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

GA

  • ASP.NET Extension - Configuration Secrets

  • Attestation

  • Core

  • Event Grid

  • Form Recognizer

  • Identity

Updates

  • ASP.NET Extension - Configuration Secrets

  • ASP.NET Extension - DataProtection Blobs

  • ASP.NET Extension - DataProtection Keys

  • App Configuration

  • Azure Mixed Reality Authentication

  • Azure Remote Rendering

  • Communication Chat

  • Communication Common

  • Communication Identity

  • Communication Phone Numbers

  • Communication SMS

  • Event Hubs

  • Event Hubs - Event Processor

  • Key Vault - Certificates

  • Key Vault - Keys

  • Key Vault - Secrets

  • Storage - Blobs

  • Storage - Blobs Batch

  • Storage - Common

  • Storage - Files Data Lake

  • Storage - Files Shares

  • Storage - Queues

Beta

  • Azure Object Anchors Conversion

  • Azure Video Analyzer Edge

  • Azure.Communication.NetworkTraversal

  • Azure.IoT.TimeSeriesInsights

  • Cognitive Search

  • ConfidentialLedger

  • Container Registry

  • FarmBeats

  • Key Vault - Administration

  • Key Vault - Certificates

  • Key Vault - Keys

  • Key Vault - Secrets

  • Purview Catalog

  • Purview Scanning

  • Service Bus

  • Storage - Blobs

  • Storage - Blobs Batch

  • Storage - Blobs ChangeFeed

  • Storage - Common

  • Storage - Files Data Lake

  • Storage - Files Shares

  • Storage - Queues

  • Synapse - AccessControl

  • Synapse - Artifacts

  • Synapse - Managed Private Endpoints

  • Synapse - Monitoring

  • Synapse - Spark

  • Tables

  • Text Analytics

  • WebJobs Extensions - Event Grid

  • WebJobs Extensions - Event Hubs

  • WebJobs Extensions - Service Bus

  • WebJobs Extensions - Storage

  • WebJobs Extensions - Storage Blobs

  • WebJobs Extensions - Storage Queues

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
$> dotnet add package Azure.AI.TextAnalytics --version 5.1.0-beta.7
$> dotnet add package Azure.Analytics.Purview.Catalog --version 1.0.0-beta.1
$> dotnet add package Azure.Analytics.Purview.Scanning --version 1.0.0-beta.1
$> dotnet add package Azure.Analytics.Synapse.AccessControl --version 1.0.0-preview.4
$> dotnet add package Azure.Analytics.Synapse.Artifacts --version 1.0.0-preview.9
$> dotnet add package Azure.Analytics.Synapse.Artifacts --version 1.0.0-preview.10
$> dotnet add package Azure.Analytics.Synapse.ManagedPrivateEndpoints --version 1.0.0-beta.3
$> dotnet add package Azure.Analytics.Synapse.Monitoring --version 1.0.0-beta.3
$> dotnet add package Azure.Analytics.Synapse.Spark --version 1.0.0-preview.6
$> dotnet add package Azure.Communication.Chat --version 1.0.1
$> dotnet add package Azure.Communication.Common --version 1.0.1
$> dotnet add package Azure.Communication.Identity --version 1.0.1
$> dotnet add package Azure.Communication.NetworkTraversal --version 1.0.0-beta.1
$> dotnet add package Azure.Communication.PhoneNumbers --version 1.0.1
$> dotnet add package Azure.Communication.Sms --version 1.0.1
$> dotnet add package Azure.Containers.ContainerRegistry --version 1.0.0-beta.2
$> dotnet add package Azure.Core --version 1.14.0
$> dotnet add package Azure.Data.AppConfiguration --version 1.0.3
$> dotnet add package Azure.Data.Tables --version 12.0.0-beta.8
$> dotnet add package Azure.Extensions.AspNetCore.Configuration.Secrets --version 1.1.0
$> dotnet add package Azure.Extensions.AspNetCore.Configuration.Secrets --version 1.2.1
$> dotnet add package Azure.Extensions.AspNetCore.DataProtection.Blobs --version 1.2.1
$> dotnet add package Azure.Extensions.AspNetCore.DataProtection.Keys --version 1.0.3
$> dotnet add package Azure.Identity --version 1.4.0
$> dotnet add package Azure.IoT.TimeSeriesInsights --version 1.0.0-beta.1
$> dotnet add package Azure.Media.VideoAnalyzer.Edge --version 1.0.0-beta.2
$> dotnet add package Azure.Media.VideoAnalyzer.Edge --version 1.0.0-beta.3
$> dotnet add package Azure.Media.VideoAnalyzer.Edge --version 1.0.0-beta.4
$> dotnet add package Azure.Messaging.EventGrid --version 4.2.0
$> dotnet add package Azure.Messaging.EventHubs --version 5.4.1
$> dotnet add package Azure.Messaging.EventHubs.Processor --version 5.4.1
$> dotnet add package Azure.Messaging.ServiceBus --version 7.2.0-beta.3
$> dotnet add package Azure.MixedReality.Authentication --version 1.0.1
$> dotnet add package Azure.MixedReality.ObjectAnchors.Conversion --version 0.2.0-beta.1
$> dotnet add package Azure.MixedReality.RemoteRendering --version 1.0.1
$> dotnet add package Azure.Search.Documents --version 11.3.0-beta.2
$> dotnet add package Azure.Security.Attestation --version 1.0.0
$> dotnet add package Azure.Security.KeyVault.Administration --version 4.0.0-beta.5
$> dotnet add package Azure.Security.KeyVault.Certificates --version 4.1.1
$> dotnet add package Azure.Security.KeyVault.Certificates --version 4.2.0-beta.6
$> dotnet add package Azure.Security.KeyVault.Keys --version 4.1.1
$> dotnet add package Azure.Security.KeyVault.Keys --version 4.2.0-beta.6
$> dotnet add package Azure.Security.KeyVault.Secrets --version 4.1.1
$> dotnet add package Azure.Security.KeyVault.Secrets --version 4.2.0-beta.5
$> dotnet add package Azure.Storage.Blobs --version 12.9.0-beta.4
$> dotnet add package Azure.Storage.Blobs --version 12.8.4
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.6.0-beta.4
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.5.2
$> dotnet add package Azure.Storage.Blobs.ChangeFeed --version 12.0.0-preview.12
$> dotnet add package Azure.Storage.Common --version 12.8.0-beta.4
$> dotnet add package Azure.Storage.Common --version 12.7.3
$> dotnet add package Azure.Storage.ConfidentialLedger --version 1.0.0-beta.1
$> dotnet add package Azure.Storage.Files.DataLake --version 12.7.0-beta.4
$> dotnet add package Azure.Storage.Files.DataLake --version 12.6.2
$> dotnet add package Azure.Storage.Files.Shares --version 12.7.0-beta.4
$> dotnet add package Azure.Storage.Files.Shares --version 12.6.2
$> dotnet add package Azure.Storage.Queues --version 12.7.0-beta.4
$> dotnet add package Azure.Storage.Queues --version 12.6.2
$> dotnet add package Azure.Verticals.AgriFood.Farming --version 1.0.0-beta.1
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.EventGrid --version 3.0.0-beta.2
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.0-beta.5
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.ServiceBus --version 5.0.0-beta.3
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage --version 5.0.0-beta.4
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage.Blobs --version 5.0.0-beta.4
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage.Queues --version 5.0.0-beta.4

Feedback

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

Release highlights

ASP.NET Extension - Configuration Secrets 1.1.0 Changelog

Changes

  • Dependency versions updated.

Added

  • The AzureKeyVaultConfigurationProvider was made public.
  • The KeyVaultSecretManager.GetData method was added to allow customizing the way secrets are turned into configuration values.

ASP.NET Extension - Configuration Secrets 1.2.1 Changelog

Changes

Key Bug Fixes
  • Fixes an issues where keys returned from AzureKeyVaultConfigurationProvider were case sensitive.

ASP.NET Extension - DataProtection Blobs 1.2.1 Changelog

Changes

  • Dependency versions updated.
Key Bug Fixes
  • Fixed a bug where referencing an existing empty blob resulted in a failure.

ASP.NET Extension - DataProtection Keys 1.0.3 Changelog

Changes

  • Dependency versions updated.

App Configuration 1.0.3 Changelog

Changes

  • Dependency versions updated.

Attestation 1.0.0 Changelog

Changed

  • Final changes for Azure Attestation Service for .Net, including API review feedback. Mostly code cleanups, but significant improvements to the AttestationToken class.

Azure Mixed Reality Authentication 1.0.1 Changelog

Key Bug Fixes

  • Updated dependency versions.

Azure Object Anchors Conversion 0.2.0-beta.1 Changelog

  • Added error codes to AssetConversionProperties

Azure Remote Rendering 1.0.1 Changelog

  • Update dependency versions

Azure Video Analyzer Edge 1.0.0-beta.2 Changelog

Breaking Changes

  • Renamed package from ‘Microsoft.Azure.Media.VideoAnalytics.Edge’ to ‘Azure.Media.VideoAnalyzer.Edge’

Azure Video Analyzer Edge 1.0.0-beta.3 Changelog

  • Update the title and description of the package.

Azure Video Analyzer Edge 1.0.0-beta.4 Changelog

  • Update the title package and updates to readme

Azure.Communication.NetworkTraversal 1.0.0-beta.1 Changelog

This is the first release of Azure Communication Services for Network Traversal. For more information, please see the README.

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

Azure.IoT.TimeSeriesInsights 1.0.0-beta.1 Changelog

New features

Cognitive Search 11.3.0-beta.2 Changelog

Added

  • Added support for Semantic Search, which is a collection of query-related capabilities that add semantic relevance and language understanding to search results.
  • Added support for Knowledge Store, which is a feature of Azure Cognitive Search that persists output from an AI enrichment pipeline for independent analysis or downstream processing.

Communication Chat 1.0.1 Changelog

Bug Fixes

  • Changed DateTime.MinValue to DateTimeOffset.MinValue in sample code
  • Fixed the bug where Message type is defaulting to text

Communication Common 1.0.1 Changelog

  • Dependency versions updated.

Communication Identity 1.0.1 Changelog

  • Dependency versions updated.

Communication Phone Numbers 1.0.1 Changelog

  • Dependency versions updated.

Communication SMS 1.0.1 Changelog

  • Dependency versions updated.

ConfidentialLedger 1.0.0-beta.1 Changelog

  • Initial package

Container Registry 1.0.0-beta.2 Changelog

Features Added

  • Added support for accessing ACR anonymously via two new constructors on ContainerRegistryClient.
  • Added caching of the ACR refresh token during the authentication token exchange to reduce per operation network calls to the service.
  • Updated API to have a single client as an entry point, ContainerRegistryClient, with two helper classes, ContainerRepository and RegistryArtifact, for resource-specific service calls.
  • Added strongly typed string constants for ArtifactArchitecture and ArtifactOperatingSystem.
  • Renamed methods operating on a manifest to have Manifest in their names.

Breaking Changes

  • Removed ContainerRepositoryClient.
  • Renamed GetRepositories to GetRepositoryNames on ContainerRegistryClient.

Core 1.14.0 Changelog

Added

  • Added additional methods to BearerTokenAuthenticationPolicy, which enables creation of authentication policies that can handle challenges.

Event Grid 4.2.0 Changelog

New Features

  • Added the following new system events:
    • PolicyInsightsPolicyStateChangedEventData
    • PolicyInsightsPolicyStateCreatedEventData
    • PolicyInsightsPolicyStateDeletedEventData
    • StorageAsyncOperationInitiatedEventData
    • StorageBlobTierChangedEventData

Event Hubs 5.4.1 Changelog

Changes

New Features
  • EventProcessor<TPartition> will now perform validation of core configuration and permissions at startup, in order to attempt to detect unrecoverable problems more deterministically.

  • Partition initialization for EventProcessor<TPartition> has been optimized for better performance.

Key Bug Fixes
  • Dependencies have been updated to resolve security warnings for CVE-2021-26701. (The Event Hubs client library does not make use of the vulnerable components, directly or indirectly)

  • Event Hubs client types will now surface a consistent exception when a shared connection was closed while still in use.

Event Hubs - Event Processor 5.4.1 Changelog

Changes

New Features
  • EventProcessor<TPartition> will now perform validation of core configuration and permissions at startup, in order to attempt to detect unrecoverable problems more deterministically.

  • Partition initialization for EventProcessor<TPartition> has been optimized for better performance.

Key Bug Fixes
  • Dependencies have been updated to resolve security warnings for CVE-2021-26701. (The Event Hubs client library does not make use of the vulnerable components, directly or indirectly)

FarmBeats 1.0.0-beta.1 Changelog

New Features

  • Initial Preview Release of the Azure FarmBeats client library for .NET

Form Recognizer 3.1.0 Changelog

New Features

  • This General Availability (GA) release marks the stability of the changes introduced in package versions 3.1.0-beta.1 through 3.1.0-beta.4.
  • Updated the FormRecognizerModelFactory class to support missing model types for mocking.
  • Added support for service version 2.0. This can be specified in the FormRecognizerClientOptions object under the ServiceVersion enum. By default the SDK targets latest supported service version.

Breaking changes

  • The client defaults to the latest supported service version, which currently is 2.1.
  • Renamed Id for Identity in all the StartRecognizeIdDocuments functionalities. For example, the name of the method is now StartRecognizeIdentityDocuments.
  • Renamed the model ReadingOrder to FormReadingOrder.
  • The model TextAppearance now includes the properties StyleName and StyleConfidence that were part of the TextStyle object.
  • Removed the model TextStyle.
  • Renamed the method AsCountryCode to AsCountryRegion.
  • Removed type FieldValueGender.
  • Removed value Gender from the model FieldValuetype.

Identity 1.4.0 Changelog

New Features

  • By default, the MSAL Public Client Client Capabilities are populated with “CP1” to enable support for Continuous Access Evaluation (CAE). This indicates to AAD that your application is CAE ready and can handle the CAE claim challenge. This capability can be disabled, if necessary, by either setting an AppContext switch named “Azure.Identity.DisableCP1” to true or by setting the environment variable; “AZURE_IDENTITY_DISABLE_CP1” to “true”. Note: AppContext switches can also be configured via configuration like below:
<ItemGroup>
    <RuntimeHostConfigurationOption Include="Azure.Identity.DisableCP1" Value="true" />
</ItemGroup> 

Fixes and improvements

  • The Microsoft Authentication Library (MSAL) dependency versions have been updated to the latest
    • Microsoft.Identity.Client version 4.30.1, Microsoft.Identity.Client.Extensions.Msal version 2.18.4.

Key Vault - Administration 4.0.0-beta.5 Changelog

Changed

  • Updated dependency versions

Key Vault - Certificates 4.1.1 Changelog

Changed

  • Updated dependency versions

Key Vault - Certificates 4.2.0-beta.6 Changelog

Changed

  • Updated dependency versions

Key Vault - Keys 4.1.1 Changelog

Changed

  • Updated dependency versions

Key Vault - Keys 4.2.0-beta.6 Changelog

Changed

  • Updated dependency versions

Key Vault - Secrets 4.1.1 Changelog

Changed

  • Updated dependency versions

Key Vault - Secrets 4.2.0-beta.5 Changelog

Changed

  • Updated dependency versions

Purview Catalog 1.0.0-beta.1 Changelog

New Features

  • Initial preview release of the Azure Purview Catalog client library for .NET

Purview Scanning 1.0.0-beta.1 Changelog

New Features

  • Initial preview release of the Purview Scanning client library for .NET

Service Bus 7.2.0-beta.3 Changelog

Added

  • Added SubQueue option to ServiceBusProcessorOptions to allow for processing the deadletter queue
  • Added Verbose event source events for the following scenarios that previously had Error events which resulted in unnecessary noise in application logs:
    • Accepting a session times out because there are no sessions available.
    • TaskCanceledException occurs while stopping the processor.

Storage - Blobs 12.9.0-beta.4 Changelog

  • Added support for service version 2020-08-04.
  • Added WithCustomerProvidedKey() and WithEncryptionScope() to BlobClient, BlobBaseClient, AppendBlobClient, and PageBlobClient.
  • BlobLeaseClient now remembers the Lease ID after a lease change.
  • Fixed bug where clients would sometimes throw a NullReferenceException when calling GenerateSas() with a BlobSasBuilder parameter.
  • Fixed bug where BlobBaseClient.Exists() would not function correctly on blobs encrypted with CPK.
  • Includes all updates and fixes from 12.8.2 and 12.8.3

Storage - Blobs 12.8.4 Changelog

  • Fixed bug where Client Side Encryption during large transactions (greater than max int value) would throw an exception.

Storage - Blobs Batch 12.6.0-beta.4 Changelog

  • Added support for service version 2020-08-04.
  • This release contains bug fixes to improve quality.

Storage - Blobs Batch 12.5.2 Changelog

  • This release contains bug fixes to improve quality.

Storage - Blobs ChangeFeed 12.0.0-preview.12 Changelog

  • This release contains bug fixes to improve quality.

Storage - Common 12.8.0-beta.4 Changelog

  • Added ability to specify server timeout.
  • Deprecated property AccountSasBuilder.Version, so when generating SAS will always use the latest Storage Service SAS version.

Storage - Common 12.7.3 Changelog

  • This release contains bug fixes to improve quality.

Storage - Files Data Lake 12.7.0-beta.4 Changelog

  • Added support for service version 2020-08-04.
  • Added support for Soft Delete for Hierarchical-Namespace enabled accounts.
  • DataLakeLeaseClient now remembers the Lease ID after a lease change.
  • Fixed bug where clients would sometimes throw a NullReferenceException when calling GenerateSas() with a DataLakeSasBuilder parameter.
  • Deprecated property DataLakeSasBuilder.Version, so when generating SAS will always use the latest Storage Service SAS version.

Storage - Files Data Lake 12.6.2 Changelog

  • This release contains bug fixes to improve quality.

Storage - Files Shares 12.7.0-beta.4 Changelog

  • Added support for service version 2020-08-04.
  • Added support for Share and Share Snapshot Lease.
  • DataLakeLeaseClient now remembers the Lease ID after a lease change.
  • Fixed bug where clients would sometimes throw a NullReferenceException when calling GenerateSas() with a ShareSasBuilder parameter.
  • Deprecated property ShareSasBuilder.Version, so when generating SAS will always use the latest Storage Service SAS version.

Storage - Files Shares 12.6.2 Changelog

  • This release contains bug fixes to improve quality.

Storage - Queues 12.7.0-beta.4 Changelog

  • Fixed bug where clients would sometimes throw a NullReferenceException when calling GenerateSas() with a QueueSasBuilder parameter.
  • Deprecated property QueueSasBuilder.Version, so when generating SAS will always use the latest Storage Service SAS version.

Storage - Queues 12.6.2 Changelog

  • This release contains bug fixes to improve quality.

Synapse - AccessControl 1.0.0-preview.4 Changelog

Key Bug Fixes

  • Updated dependency versions.

Synapse - Artifacts 1.0.0-preview.9 Changelog

Key Bug Fixes

  • Updated dependency versions.
  • Improved deserialization of optional parameters (https://github.com/Azure/azure-sdk-for-net/issues/20051)

Synapse - Artifacts 1.0.0-preview.10 Changelog

Key Bug Fixes

  • LibraryRestClient.Append method now includes comp parameter (https://github.com/Azure/azure-rest-api-specs/pull/13841)

Synapse - Managed Private Endpoints 1.0.0-beta.3 Changelog

Key Bug Fixes

  • Updated dependency versions.

Synapse - Monitoring 1.0.0-beta.3 Changelog

Key Bug Fixes

  • Updated dependency versions.

Synapse - Spark 1.0.0-preview.6 Changelog

Key Bug Fixes

  • Updated dependency versions.

Tables 12.0.0-beta.8 Changelog

Breaking Changes

  • Eliminated the TableTransactionalBatch type and added the TableTransactionAction type.
    • Submitting a batch transaction is now accomplished via the TableClient.SubmitTransaction or TableClient.SubmitTransactionAsync methods which accepts an IEnumerable<TableTransactionAction>.
  • TableClient.SubmitTransaction and TableClient.SubmitTransactionAsync now return Response<IReadOnlyList<Response>> rather than TableBatchResponse.
    • TableBatchResponse.GetResponseForEntity is no longer necessary as the responses can now be correlated directly between the Response<IReadOnlyList<Response>> and the list of TableTransactionActions provided to the submit method.

Changed

  • Failed batch transaction operations now throw TableTransactionFailedException which contains a FailedTransactionActionIndex property to indicate which TableTransactionAction caused the failure.

Added

  • Added TableOdataFilter to assist with odata string filter quoting and escaping.

Key Bug Fixes

  • Merge operations no longer fail for Cosmos table endpoints.

Text Analytics 5.1.0-beta.7 Changelog

New features

  • Added property DisableServiceLogs to TextAnalyticsRequestOptions.
  • Added support for Sentiment Analysis as an action type for StartAnalyzeBatchActions.
  • Changed type of IncludeOpinionMining to bool?.

Breaking changes

  • The client defaults to the latest supported service version, which currently is 3.1-preview.5.
  • Renamed type TextElementsV8 to TextElementV8 in model StringIndexType.

WebJobs Extensions - Event Grid 3.0.0-beta.2 Changelog

Changes

New Features
  • Binding to the CloudEvent type is now supported.

WebJobs Extensions - Event Hubs 5.0.0-beta.5 Changelog

Changes

Key Bug Fixes
  • The web proxy specified in configuration is now respected.
New Features
  • Added support for specifying accountName or blobServiceUri for the checkpoint connection.

WebJobs Extensions - Service Bus 5.0.0-beta.3 Changelog

Added

  • Added JsonSerializerSettings property to ServiceBusOptions.

Breaking Changes

  • Made Constants class internal.
  • Made ServiceBusWebJobsStartup class internal.
  • Renamed EntityType to ServiceBusEntityType.
  • Removed receiver parameter from MessageProcessor constructor.
  • Removed client parameter from SessionMessageProcessor constructor.

Key Bug Fixes

  • The web proxy specified in configuration is now respected.
  • Binding to JObject is now supported.

WebJobs Extensions - Storage 5.0.0-beta.4 Changelog

Please refer to Microsoft.Azure.WebJobs.Extension.Storage.Blobs and Microsoft.Azure.WebJobs.Extension.Storage.Queues for detailed list of changes.

WebJobs Extensions - Storage Blobs 5.0.0-beta.4 Changelog

  • Added new configuration formats so extensions that need multiple storage services can specify them in one connection configuration.

Sample config:

{
    "MyStorageConnection1": {
        "blobServiceUri": "https://<my_account>.blob.core.windows.net",
        "queueServiceUri": "https://<my_account>.queue.core.windows.net"
    },

    "MyStorageConnection2": {
        "accountName": "<my_account>"
    }
}

WebJobs Extensions - Storage Queues 5.0.0-beta.4 Changelog

  • Fixed bug where custom implementations of IQueueProcessorFactory could overwrite each other settings.
  • Added new configuration formats so extensions that need multiple storage services can specify them in one connection configuration.

Sample config:

{
    "MyStorageConnection1": {
        "blobServiceUri": "https://<my_account>.blob.core.windows.net",
        "queueServiceUri": "https://<my_account>.queue.core.windows.net"
    },

    "MyStorageConnection2": {
        "accountName": "<my_account>"
    }
}

Latest Releases

View all the latest versions of .NET packages here.