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

GA

  • Core

  • Identity

  • Question Answering

  • Schema Registry

  • Service Bus

  • Tables

  • Web PubSub

  • WebJobs Extensions - Event Grid

  • WebJobs Extensions - Event Hubs

  • WebJobs Extensions - Service Bus

  • WebJobs Extensions - Web PubSub

Updates

  • Monitor Query

  • Tables

Beta

  • Azure Video Analyzer Edge

  • Azure.Analytics.Purview.Administration

  • Communication Identity

  • Container Registry

  • Conversation Analysis

  • Core Spatial

  • Core Spatial Newtonsoft Json

  • Document Translation

  • Event Hubs

  • Event Hubs - Event Processor

  • Form Recognizer

  • Key Vault - Administration

  • Key Vault - Certificates

  • Key Vault - Keys

  • Key Vault - Secrets

  • Purview Catalog

  • Purview Scanning

  • Resource Management - Compute

  • Resource Management - Core

  • Resource Management - KeyVault

  • Resource Management - Network

  • Resource Management - Resources

  • Resource Management - Storage

  • Schema Registry - Avro

  • Storage - Blobs

  • Storage - Blobs Batch

  • Storage - Blobs ChangeFeed

  • Storage - Common

  • Storage - Files Data Lake

  • Storage - Files Shares

  • Storage - Queues

  • Synapse - Artifacts

  • Text Analytics

  • WebJobs Extensions - Event Grid

  • WebJobs Extensions - Web PubSub

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 4.0.0-beta.2
$> dotnet add package Azure.AI.Language.Conversations --version 1.0.0-beta.1
$> dotnet add package Azure.AI.Language.QuestionAnswering --version 1.0.0
$> dotnet add package Azure.AI.TextAnalytics --version 5.2.0-beta.2
$> dotnet add package Azure.AI.Translation.Document --version 1.0.0-beta.6
$> dotnet add package Azure.Analytics.Purview.Administration --version 1.0.0-beta.1
$> dotnet add package Azure.Analytics.Purview.Catalog --version 1.0.0-beta.2
$> dotnet add package Azure.Analytics.Purview.Scanning --version 1.0.0-beta.2
$> dotnet add package Azure.Analytics.Synapse.Artifacts --version 1.0.0-preview.12
$> dotnet add package Azure.Communication.Identity --version 1.1.0-beta.1
$> dotnet add package Azure.Containers.ContainerRegistry --version 1.1.0-beta.2
$> dotnet add package Azure.Containers.ContainerRegistry --version 1.1.0-beta.3
$> dotnet add package Azure.Core --version 1.21.0
$> dotnet add package Azure.Data.SchemaRegistry --version 1.0.0
$> dotnet add package Azure.Data.Tables --version 12.2.1
$> dotnet add package Azure.Data.Tables --version 12.3.0
$> dotnet add package Azure.Identity --version 1.5.0
$> dotnet add package Azure.Media.VideoAnalyzer.Edge --version 1.0.0-beta.5
$> dotnet add package Azure.Messaging.EventHubs --version 5.7.0-beta.1
$> dotnet add package Azure.Messaging.EventHubs.Processor --version 5.7.0-beta.1
$> dotnet add package Azure.Messaging.ServiceBus --version 7.5.0
$> dotnet add package Azure.Messaging.WebPubSub --version 1.0.0
$> dotnet add package Azure.Monitor.Query --version 1.0.1
$> dotnet add package Azure.ResourceManager --version 1.0.0-beta.5
$> dotnet add package Azure.ResourceManager.Compute --version 1.0.0-beta.3
$> dotnet add package Azure.ResourceManager.KeyVault --version 1.0.0-beta.3
$> dotnet add package Azure.ResourceManager.Network --version 1.0.0-beta.3
$> dotnet add package Azure.ResourceManager.Resources --version 1.0.0-beta.3
$> dotnet add package Azure.ResourceManager.Storage --version 1.0.0-beta.3
$> dotnet add package Azure.Security.KeyVault.Administration --version 4.1.0-beta.2
$> dotnet add package Azure.Security.KeyVault.Certificates --version 4.3.0-beta.2
$> dotnet add package Azure.Security.KeyVault.Keys --version 4.3.0-beta.2
$> dotnet add package Azure.Security.KeyVault.Keys --version 4.3.0-beta.3
$> dotnet add package Azure.Security.KeyVault.Secrets --version 4.3.0-beta.2
$> dotnet add package Azure.Storage.Blobs --version 12.11.0-beta.1
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.8.0-beta.1
$> dotnet add package Azure.Storage.Blobs.ChangeFeed --version 12.0.0-preview.17
$> dotnet add package Azure.Storage.Common --version 12.10.0-beta.1
$> dotnet add package Azure.Storage.Files.DataLake --version 12.9.0-beta.1
$> dotnet add package Azure.Storage.Files.Shares --version 12.9.0-beta.1
$> dotnet add package Azure.Storage.Queues --version 12.9.0-beta.1
$> dotnet add package Microsoft.Azure.Core.Spatial --version 1.2.0-beta.1
$> dotnet add package Microsoft.Azure.Core.Spatial.NewtonsoftJson --version 1.1.0-beta.1
$> dotnet add package Microsoft.Azure.Data.SchemaRegistry.ApacheAvro --version 1.0.0-beta.4
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.EventGrid --version 3.0.0-beta.4
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.EventGrid --version 3.0.0
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.0
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.ServiceBus --version 5.0.0
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.ServiceBus --version 5.1.0
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.WebPubSub --version 1.0.0-beta.4
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.WebPubSub --version 1.0.0

Feedback

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

Release highlights

Azure Video Analyzer Edge 1.0.0-beta.5 Changelog

  • Added device discovery and device detail request for ONVIF enabled devices.
  • Added Remote Device Adapter configuration for ingesting video in a private network
  • Added retention policy to VideoSink

Azure.Analytics.Purview.Administration 1.0.0-beta.1 Changelog

New Features

  • Initial preview release of the Azure Purview Administration client library for .NET
  • Provides operations for Purview Account and MetadataPolicies services

Communication Identity 1.1.0-beta.1 Changelog

  • Updated version of Identity API to enable to build custom Teams endpoint using M365 Teams identities

Container Registry 1.1.0-beta.2 Changelog

Features Added

  • Added an overload for UploadManifest(Async) method that takes the manifest Stream` as an input.
  • Added methods in ContainerRegistryModelFactory that create instances of DownloadBlobResult, DownloadManifestResult, UploadBlobResult and UploadManifestResult for mocking.
  • Added DownloadManifestOptions type to allow callers to pass-in either a tag or a digest in DownloadManifest(Async).
  • Added ManifestStream as a property in DownloadManifestResult that contains the raw manifest stream from the service response.

Breaking Changes

  • Changed DownloadManifest(Async) method to take DownloadManifestOptions as an input parameter. This allows callers to pass-in either a tag or a digest as the manifest identifier.

Container Registry 1.1.0-beta.3 Changelog

Features Added

Conversation Analysis 1.0.0-beta.1 Changelog

  • Initial release.

Core 1.21.0 Changelog

  • Added RequestContext and ErrorOptions types to aid in configuring requests.
  • Added ContentType strongly-typed string to allow operation callers to specify the content type of a request.

Core Spatial 1.2.0-beta.1 Changelog

Features Added

  • Added converter support for the following types (#24367):
  • GeographyLineString
  • GeographyPolygon
  • GeographyMultiPoint
  • GeographyMultiLineString
  • GeographyMultiPolygon
  • GeographyCollection

Core Spatial Newtonsoft Json 1.1.0-beta.1 Changelog

Features Added

  • Added converter support for the following types (#24367):
  • GeographyLineString
  • GeographyPolygon
  • GeographyMultiPoint
  • GeographyMultiLineString
  • GeographyMultiPolygon
  • GeographyCollection

Document Translation 1.0.0-beta.6 Changelog

Breaking Changes

  • Removed types DocumentTranslationError and DocumentTranslationErrorCode. These affected the classes DocumentStatusResult and TranslationStatusResult. Errors in both classes are now exposed as ResponseError.
  • Renamed method DocumentStatus to DocumentStatusResult in DocumentTranslationModelFactory, which now takes a BinaryData type instead of DocumentTranslationError.
  • Renamed method TranslationStatus to TranslationStatusResult in DocumentTranslationModelFactory, which now takes a BinaryData type instead of DocumentTranslationError.

Event Hubs 5.7.0-beta.1 Changelog

Features Added

  • The EventHubBufferedProducerClient is being introduced, intended to allow for efficient publishing of events without having to explicitly manage batches in the application. More information can be found in its design document.

Event Hubs - Event Processor 5.7.0-beta.1 Changelog

Other Changes

  • Added additional heuristics for the EventProcessorClient load balancing cycle to help discover issues that can impact processor performance and stability; these validations will produce warnings should potential concerns be found.

  • EventProcessorClient will now log a verbose message indicating what event position was chosen to read from when initializing a partition.

Form Recognizer 4.0.0-beta.2 Changelog

Bugs Fixed

  • BuildModelOperation and CopyModelOperation correctly populate the PercentCompleted property, instead of always having a value of 0.

Identity 1.5.0 Changelog

Bugs Fixed

  • Fixed issue with AuthorizationCodeCredential not specifying correct redirectUrl (Issue #24183)

Key Vault - Administration 4.1.0-beta.2 Changelog

Features Added

  • Support multi-tenant authentication against Managed HSM when using Azure.Identity 1.5.0 or newer. (#18359)

Key Vault - Certificates 4.3.0-beta.2 Changelog

Features Added

  • Added KeyVaultCertificateIdentifier.TryCreate to parse certificate URIs without throwing an exception when invalid. (#23146)
  • Support multi-tenant authentication against Key Vault and Managed HSM when using Azure.Identity 1.5.0 or newer. (#18359)

Bugs Fixed

  • Added certificate version to distributed tracing. (#12907)
  • Added DownloadCertificateOptions to pass X509KeyStorageFlags appropriate for different host applications. (#23016)

Key Vault - Keys 4.3.0-beta.2 Changelog

Features Added

  • Added JsonWebKeyConverter to support serializing and deserializing a JsonWebKey to a RFC 7517 JWK. (#16155)
  • Added KeyClient.GetCryptographyClient to get a CryptographyClient that uses the same options, policies, and pipeline as the KeyClient that created it. (#23786)
  • Added KeyRotationPolicy class and new methods including KeyClient.GetKeyRotationPolicy, KeyClient.RotateKey, and KeyClient.UpdateKeyRotationPolicy.
  • Added KeyVaultKeyIdentifier.TryCreate to parse key URIs without throwing an exception when invalid. (#23146)
  • Support multi-tenant authentication against Key Vault and Managed HSM when using Azure.Identity 1.5.0 or newer. (#18359)

Bugs Fixed

  • Added key version to distributed tracing. (#12907)

Key Vault - Keys 4.3.0-beta.3 Changelog

Breaking Changes

  • Changed return type from RandomBytes to byte[] on KeyClient.GetRandomBytes and GetRandomBytesAsync.
  • Renamed KeyReleasePolicy.Data to KeyReleasePolicy.EncodedPolicy and changed property type from byte[] to BinaryData.
  • Renamed name and version parameters on KeyClient.GetCryptographyClient to keyName and keyVersion, respectively.
  • Renamed target parameter on KeyClient.ReleaseKey and ReleaseKeyAsync to targetAttestationToken.

Key Vault - Secrets 4.3.0-beta.2 Changelog

Features Added

  • Added KeyVaultSecretIdentifier.TryCreate to parse secret URIs without throwing an exception when invalid. (#23146)
  • Support multi-tenant authentication against Key Vault and Managed HSM when using Azure.Identity 1.5.0 or newer. (#18359)

Bugs Fixed

  • Added secret version to distributed tracing. (#12907)

Monitor Query 1.0.1 Changelog

Bugs Fixed

  • NaN, +inf, and -inf double values can now be retrieved from LogsQueryResult

Purview Catalog 1.0.0-beta.2 Changelog

New Features

  • Added PurviewCollections and PurviewLineages operations.

Purview Scanning 1.0.0-beta.2 Changelog

Breaking Changes

  • Removed GetChildren in PurviewDataSourceClient.
  • Removed GetUnparentedDataSources in PurviewScanningServiceClient.
  • Changed CreateOrUpdateScanRuelset to CreateOrUpdateScanRuleset in PurviewScanningServiceClient to fix typo.
  • Changed GetLatestSystemRulestes to GetLatestSystemRulesets in PurviewScanningServiceClient to fix typo.

Question Answering 1.0.0 Changelog

Breaking Changes

  • Preview service versions 2021-05-01-preview and 2021-07-15-preview` were removed.
  • Moved all models from Azure.AI.Language.QuestionAnswering.Models to Azure.AI.Language.QuestionAnswering.
  • Renamed method QuestionAnsweringClient.QueryKnowledgeBase to GetAnswers.
  • Renamed method QuestionAnsweringClient.QueryKnowledgeBaseAsync to GetAnswersAsync.
  • Methods GetAnswers and GetAnswersAsync now accept a question string or QnA ID, a QuestionAnsweringProject, and optional AnswersOptions parameters.
  • Moved parameters projectName and deploymentName to the new QuestionAnsweringProject class.
  • Renamed class QueryKnowledgeBaseOptions to AnswersOptions.
  • Renamed property QueryKnowledgeBaseOptions.AnswerSpanRequest to AnswersOptions.ShortAnswerOptions.
  • Renamed property QueryKnowledgeBaseOptions.ConfidenceScoreThreshold to AnswersOptions.ConfidenceThreshold.
  • Renamed property QueryKnowledgeBaseOptions.Context to AnswersOptions.AnswerContext.
  • Renamed property QueryKnowledgeBaseOptions.RankerType to AnswersOptions.RankerKind.
  • Renamed property QueryKnowledgeBaseOptions.Top to AnswersOptions.Size.
  • Renamed method QuestionAnsweringClient.QueryText to GetAnswersFromText.
  • Renamed method QuestionAnsweringClient.QueryTextAsync to GetAnswersFromTextAsync.
  • Renamed class QueryTextOptions to AnswersFromTextOptions.
  • Renamed property QueryTextOptions.Records to AnswersFromTextOptions.TextDocuments.
  • Renamed class TextRecord to TextDocument.
  • Renamed class AnswerSpanRequest to ShortAnswerOptions.
  • Renamed property AnswerSpanRequest.ConfidenceScoreThreshold to ShortAnswerOptions.ConfidenceThreshold.
  • Renamed property AnswerSpanRequest.TopAnswersWithSpan to ShortAnswersOptions.Size.
  • Renamed class KnowledgeBaseAnswerRequestContext to KnowledgeBaseAnswerContext.
  • Renamed property KnowledgeBaseAnswerRequestContext.PreviousUserQuery to KnowledgeBaseAnswerContext.PreviousQuestion.
  • Renamed class KnowledgeBaseAnswers to AnswersResult.
  • Renamed class TextAnswers to AnswersFromTextResult.
  • Renamed property KnowledgeBaseAnswer.AnswerSpan to KnowledgeBaseAnswer.ShortAnswer.
  • Renamed property KnowledgeBaseAnswer.ConfidenceScore to KnowledgeBaseAnswer.Confidence.
  • Renamed property KnowledgeBaseAnswer.Id to KnowledgeBaseAnswer.QnaId.
  • Renamed property AnswerSpan.ConfidenceScore has been renamed to AnswerSpan.Confidence.
  • Renamed property TextAnswer.ConfidenceScore has been renamed to TextAnswer.confidence.
  • Renamed property TextAnswer.AnswerSpan has been renamed to TextAnswer.ShortAnswer.
  • Removed class StringIndexType. Hard-coded to “Utf16CodeUnit” for .NET.

Resource Management - Compute 1.0.0-beta.3 Changelog

Resource Management - Core 1.0.0-beta.5 Changelog

Resource Management - KeyVault 1.0.0-beta.3 Changelog

Resource Management - Network 1.0.0-beta.3 Changelog

Resource Management - Resources 1.0.0-beta.3 Changelog

Resource Management - Storage 1.0.0-beta.3 Changelog

Schema Registry 1.0.0 Changelog

Breaking Changes

  • Removed preview service versions.
  • Renamed Content property of SchemaRegistrySchema to Definition.
  • Renamed name parameter of RegisterSchema and GetSchemaProperties methods to schemaName.

Features Added

  • General availability of Azure.Data.SchemaRegistry.
  • Added SchemaRegistryModelFactory.

Schema Registry - Avro 1.0.0-beta.4 Changelog

Features Added

  • Updated dependency on Azure.Data.SchemaRegistry.

Service Bus 7.5.0 Changelog

Breaking Changes

  • Default To, ReplyTo, and CorrelationId properties of ServiceBusMessage to null, rather than empty string. To retain the old behavior, you can set the properties to empty string when constructing your message:
    var message = new ServiceBusMessage
    {
    ReplyTo = "",
    To = "",
    CorrelationId = ""
    };
    

Bugs Fixed

  • Fixed memory leak in ServiceBusSessionProcessor.
  • Fixed bug where AMQP sequence/value messages could not be created from a received message.
  • Fixed bug where a named session of empty string could not be accepted.

Storage - Blobs 12.11.0-beta.1 Changelog

  • Added support for service version 2020-12-06.
  • Added support for Encryption Scope SAS.
  • Added support for Encryption Scopes with BlobBaseClient.SyncCopyFromUriAsync().
  • Added support for generating SAS URLs with the Permanent Delete (‘y’) SAS permission.
  • Added support for SDK-calculated transactional hash checksums on data transfer.
  • Fixed bug where BlobContainerClient.GetBlobs() and .GetBlobsByHierarchyAsync() was not parsing the Object Replication Metadata correctly
  • Fixed bug / regression where the ETag values that had quotation marks surrounding it were being removed starting in version 12.9.0.

Storage - Blobs Batch 12.8.0-beta.1 Changelog

  • Added support for service version 2020-12-06.

Storage - Blobs ChangeFeed 12.0.0-preview.17 Changelog

  • Added support for service version 2020-12-06.
  • This release contains bug fixes to improve quality.
  • Fixed bug where Segment.GetCursor() would throw an ArgumentOutOfRangeException if the Segment has no Shards.

Storage - Common 12.10.0-beta.1 Changelog

  • Added support for SDK-calculated transactional hash checksums on data transfer.
  • This release contains bug fixes to improve quality.

Storage - Files Data Lake 12.9.0-beta.1 Changelog

  • Added support for service version 2020-12-06.
  • Added support for SDK-calculated transactional hash checksums on data transfer.
  • Fixed bug / regression where the ETag values that had quotation marks surrounding it were being removed starting in version 12.7.0.
  • Fixed bug where DataLakeUriBuilder incorrectly convert “blob” or “dfs” in the account name in the Uri when attempting to convert the URL to a dfs or blob endpoint.

Storage - Files Shares 12.9.0-beta.1 Changelog

  • Added support for service version 2020-12-06.
  • Added support for SDK-calculated transactional hash checksums on data transfer.
  • Fixed bug / regression where the ETag values that had quotation marks surrounding it were being removed starting in version 12.7.0.

Storage - Queues 12.9.0-beta.1 Changelog

  • This release contains bug fixes to improve quality.

Synapse - Artifacts 1.0.0-preview.12 Changelog

  • Added data flow flowlet
  • KqlScriptContentCurrentConnection now has poolName and databaseName properties

Tables 12.2.1 Changelog

Bugs Fixed

  • Handle the case where the Uri parameter to the TableClient constructor contains the table name. (#24667)

Tables 12.3.0 Changelog

Breaking Changes

  • The fix to escapePartitionKey and RoKey property values containing single quote characters are not properly escaped on GetEntity calls may causes a breaking change for deployed applications that work around the previous behavior. For these situations, the new behavior can be overridden by either setting an AppContext switch named “Azure.Data.Tables.DisableEscapeSingleQuotesOnGetEntity” to true or by setting the environment variable “AZURE_DATA_TABLES_DISABLE_ESCAPESINGLEQUOTESONGETENTITY” to “true”. Note: AppContext switches can also be configured via configuration like below:
<ItemGroup>
<RuntimeHostConfigurationOption Include="Azure.Data.Tables.DisableEscapeSingleQuotesOnGetEntity" Value="true" />
</ItemGroup>

Bugs Fixed

  • Table entities now support UInt64 (ulong) properties. (#24750)
  • Fixed an issue where PartitionKey and RoKey property values containing single quote characters are not properly escaped on GetEntity calls. See breaking changes section for more information.

Text Analytics 5.2.0-beta.2 Changelog

Bugs Fixed

  • AnalyzeActionsOperation.GetValuesAsync() and AnalyzeHealthcareEntitiesOperation.GetValuesAsync() are now validating that the operation has completed successfully before attempting to return any values. An InvalidOperationException is thrown if this is not true.

Features Added

  • Adding support for three new actions in StartAnalyzeActions: RecognizeCustomEntities, SingleCategoryClassify, and MultiCategoriesClassify. The new actions allow you to use custom models to perform entity recognition and category classification.
  • Added property ActionName to all xxActions input types so user can specify a name per action. If not provided, service will generate a name.
  • Added property ActionName to all xxActionResult output types that displays the name of each action.
  • Added suppport for multiple actions of the same type.

Web PubSub 1.0.0 Changelog

Breaking Changes

  • Renamed GenerateClientAccessUri to GetClientAccessUri

Features Added

  • Added extension method AddWebPubSubServiceClient for TokenCredential
  • Added CloseGroupConnections, CloseAllConnections and CloseUserConnections

WebJobs Extensions - Event Grid 3.0.0-beta.4 Changelog

Key Bugs Fixed

  • Avoid synchronously waiting for batch trigger execution

WebJobs Extensions - Event Grid 3.0.0 Changelog

Features Added

  • General availability of Microsoft.Azure.WebJobs.Extensions.EventGrid 3.0.0.

WebJobs Extensions - Event Hubs 5.0.0 Changelog

Features Added

  • General availability of Microsoft.Azure.WebJobs.Extensions.EventHubs 5.0.0.

WebJobs Extensions - Service Bus 5.0.0 Changelog

Features Added

  • Added DynamicConcurrency support.
  • General availability of Microsoft.Azure.WebJobs.Extensions.ServiceBus 5.0.0.

WebJobs Extensions - Service Bus 5.1.0 Changelog

Features Added

  • Added EnableCrossEntityTransactions option
  • Added ability to bind to ServiceBusClient

WebJobs Extensions - Web PubSub 1.0.0-beta.4 Changelog

Features Added

  • Add Connection attribute to input binding and trigger binding to support upstream validations.
  • Add support to CloseAllConnections and CloseGroupConnections.

Breaking Changes

  • Rename WebPubSubRequest input binding to WebPubSubContext.
  • Move data model dependencies to Microsft.Azure.WebPubSub.Common.
  • Move output binding objects to sub namespace Microsoft.Azure.WebJobs.Extensions.WebPubSub.Operations.
  • Move dependency Azure.Messaging.WebPubSub to internal for GA needs.

Bugs Fixed

  • Fix json deserialize issues and limited to string only to reduce ambiguity.

WebJobs Extensions - Web PubSub 1.0.0 Changelog

Breaking Changes

  • Move output binding object to namespace Microsoft.Azure.WebJobs.Extensions.WebPubSub.
  • Add a few static create methods under WebPubSubAction to easily discover available actions.
  • Add dependency Azure.Messageing.WebPubSub for service calls.
  • Rename output binding from WebPubSubOperation to WebPubSubAction, and add Action as suffix for derived classes.
  • Rename operationKind to actionName in output binding for javascript to deserialize.
  • Changed the name and type of the Uri properties in WebPubSubConnection to match other libraries in the Azure SDK for .NET.

Latest Releases

View all the latest versions of .NET packages here.