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

25 packages released this month.

Stable Packages (12)

  • Communication Common

  • Event Grid

  • Service Bus

  • Storage - Blobs

  • Storage - Blobs Batch

  • Storage - Common

  • Storage - Files Data Lake

  • Storage - Files Shares

  • Storage - Queues

  • Tables

  • WebJobs Extensions - Service Bus

  • WebJobs Extensions - Web PubSub

Patch Updates (1)

  • WebJobs Extensions - Event Hubs

Beta Packages (12)

  • Azure Functions extension for Azure Table service

  • Azure Object Anchors Conversion

  • Azure Stack HCI

  • Azure.ResourceManager.DnsResolver

  • Cognitive Search

  • Event Hubs

  • Event Hubs - Event Processor

  • Form Recognizer

  • Identity

  • Schema Registry - Avro

  • Service Bus

  • Storage - Blobs ChangeFeed

Release highlights

Azure Functions extension for Azure Table service 1.0.0-beta.2 Changelog

Bugs Fixed

  • Use value comparison for byte arrays when upserting.

Azure Object Anchors Conversion 0.3.0-beta.2 Changelog

Bugs Fixed

  • Removed support for the gltf file format in the SDK as it is not supported by the service.

Azure Stack HCI 1.0.0-beta.1 Changelog

Azure.ResourceManager.DnsResolver 1.0.0-beta.1 Changelog

Cognitive Search 11.4.0-beta.7 Changelog

Features Added

  • Added support to create, update and delete aliases via the SearchIndexClient.

Communication Common 1.1.0 Changelog

  • Optimization added: When the proactive refreshing is enabled and the token refresher fails to provide a token that’s not about to expire soon, the subsequent refresh attempts will be scheduled for when the token reaches half of its remaining lifetime until a token with long enough validity (>10 minutes) is obtained.

Event Grid 4.9.0 Changelog

Features Added

  • Added new enum values for MediaJobErrorCategory and MediaJobErrorCode.

Event Hubs 5.7.0-beta.4 Changelog

Acknowledgments

Thank you to our developer community members who helped to make the Event Hubs client libraries better with their contributions to this release:

Other Changes

  • The EventHubBufferedProducer will now invoke the handlers for success or failure when publishing a batch in a deterministic manner, as part of the publishing flow. Handlers will now be awaited, causing the publishing operation to be considered incomplete until the handler returns. Previously, handlers were invoked in the background non-deterministically and without a guaranteed ordering. This ensured they could not interfere with publishing throughput but caused difficulty for reliably checkpointing with the source of events.

  • Attempts to retrieve AMQP objects will first try synchronously before calling GetOrCreateAsync, to avoid an asynchronous call unless necessary.

  • Removed allocations from Event Source logging by introducing WriteEvent overloads to handle cases that would otherwise result in boxing to object[] via params array. (A community contribution, courtesy of danielmarbach)

  • Removed LINQ from the AmqpMessageConverter in favor of direct looping. (Based on a community contribution, courtesy of danielmarbach)

  • Changed the internal batch AsEnumerable<T> to AsList<T> in order to avoid casting costs and have Count available to right-size transform collections. (Based on a community contribution, courtesy of danielmarbach)

  • Moved to using the two item overload when creating a linked token source to avoid allocating an unnecessary array. (Based on a community contribution, courtesy of danielmarbach)

Event Hubs - Event Processor 5.7.0-beta.4 Changelog

Acknowledgments

Thank you to our developer community members who helped to make the Event Hubs client libraries better with their contributions to this release:

Other Changes

  • Removed allocations from Event Source logging by introducing WriteEvent overloads to handle cases that would otherwise result in boxing to object[] via params array. (A community contribution, courtesy of danielmarbach)

  • Enhanced README documentation to call attention to the need for the Azure Storage container used with the processor to exist, and highlight that it will not be implicitly created.

Form Recognizer 4.0.0-beta.3 Changelog

Breaking Changes

  • Added the required parameter buildMode to StartBuildModel methods. Users must now choose the technique (Template or Neural) used to build models. For more information about the available build modes and their differences, see here.
  • Added the tags parameter to the GetCopyAuthorization methods.
  • Added the tags parameter to the StartCreateComposedModel methods.
  • The DocumentAnalysisClient and DocumentModelAdministrationClient now target the service version 2022-01-30-preview, so they don’t support 2021-09-30-preview anymore.

Features Added

  • Added the DocumentField.AsCurrency method and the DocumentFieldType.Currency enum value to support analyzed currency fields.
  • Added the Languages property to the AnalyzeResult class. This property is populated when using the prebuilt-read model and holds information about the languages in which the document is written.
  • Added the Tags property to the BuildModelOptions class. This property can be used to specify custom key-value attributes associated with the model to be built.
  • Added the Tags property to the DocumentModelInfo and to the ModelOperationInfo classes.
  • Added the BuildMode property to DocTypeInfo to indicate the technique used when building the correspoding model.
  • Added the DocumentAnalysisModelFactory static class to the Azure.AI.FormRecognizer.DocumentAnalysis namespace. It contains methods for instantiating DocumentAnalysis models for mocking.

Bugs Fixed

  • FormRecognizerAudience and DocumentAnalysisAudience have been added to allow the user to select the Azure cloud where the resource is located. Issue 17192.

Identity 1.6.0-beta.1 Changelog

Features Added

  • EnvironmentCredential now supports certificate subject name / issuer based authentication with AZURE_CLIENT_SEND_CERTIFICATE_CHAIN environment variable (A community contribution, courtesy of trevorlacey-msft).
  • ManagedIdentityCredential now supports accepting a ResourceIdentifier argument to specify a User Assigned Managed Identity by resource Id rather than client Id. DefaultAzureCredential also supports this via the ManagedIdentityResourceId property of DefaultAzureCredentialOptions.
  • Added ClientAssertionCredential for authenticating service principals with a presigned client assetion.

Bugs Fixed

  • Fixed AuthenticationFailedException from AzurePowerSheellCredential when not logged in on non-windows platforms #23498
  • Fixed ManagedIdentityCredential response parsing to handle non-json responses #24158

Schema Registry - Avro 1.0.0-beta.7 Changelog

Features Added

  • Added logging of cache size.
  • Non-generic overloads are available for serializing and deserializing.

Breaking Changes

  • SchemaRegistryAvroEncoder has been renamed to SchemaRegistryAvroSerializer
  • The DecodeMessageData method has been renamed to Deserialize.
  • The EncodeMessageData method has been renamed to Serialize.
  • The type MessageWithMetadata has been renamed to BinaryContent.

Service Bus 7.7.0 Changelog

Bugs Fixed

  • Fixed name of ServiceBusAdministrationClient extension method.
  • Fixed entity name validation when passing in a subscription entity path into the CreateReceiver method.

Features Added

  • Add the ability to manually renew message and session locks when using the processor.

Service Bus 7.8.0-beta.1 Changelog

Features Added

  • Added the ServiceBusRuleManager which allows managing rules for subscriptions.

Storage - Blobs 12.11.0 Changelog

  • Includes all features from 12.11.0-beta.1, 12.11.0-beta.2, and 12.11.0-beta.3 except SDK-calculated transactional checksums on data transfer.
  • Added support for progress reporting with DownloadToAsync().
  • Fixed a bug where BlobBaseClient.DownloadTo() would result in an ObjectDisposedException on .NET Framework in certain network conditions.
  • Added nullable version of BlobProperties.CopyStatus called BlobCopyStatus, allowing a null value when Storage doesn’t return a value.
  • Fixed a bug where BlobContainerClient.GetProperties() would throw an ArgumentNullException when the AccessPolicy was null
  • Removed preview support for SDK-calculated transactional checksums on data transfer.
  • Fixed a bug where BlobUriBuilder was case sensitive for parameter names.

Storage - Blobs Batch 12.8.0 Changelog

  • Includes all features from 12.8.0-beta.1, 12.8.0-beta.2, and 12.8.0-beta.3

Storage - Blobs ChangeFeed 12.0.0-preview.20 Changelog

  • Added support for event schema V3, V4, and V5.

Storage - Common 12.10.0 Changelog

  • Includes all features from 12.10.0-beta.1, 12.10.0-beta.2, and 12.10.0-beta.3 except SDK-calculated transactional checksums on data transfer.
  • Updated StorageBearerTokenChallengeAuthorizationPolicy to use the AAD scope returned by a bearer challenges.
  • Removed preview support for SDK-calculated transactional checksums on data transfer.
  • Fixed bug where Storage Uri Builder was case sensitive for parameter names.

Storage - Files Data Lake 12.9.0 Changelog

  • Includes all features from 12.9.0-beta.1, 12.9.0-beta.2, and 12.9.0-beta.3 except SDK-calculated transactional checksums on data transfer.
  • Removed preview support for SDK-calculated transactional checksums on data transfer.

Storage - Files Shares 12.9.0 Changelog

  • Includes all features from 12.9.0-beta.1, 12.9.0-beta.2, and 12.9.0-beta.3 except SDK-calculated transactional checksums on data transfer.
  • Fixed bug where ShareFileClient.StartCopy() and .StartCopyAsync() were not sending the ignoreReadonly parameter correctly.
  • Added new overload of ShareFileClient.StartCopy() and .StartCopyAsync(), added new parameters allowing the copying of the source file’s CreatedOn, LastWrittenOn, and FileAttributes properties.
  • Removed preview support for SDK-calculated transactional checksums on data transfer.
  • Fixed bug where ShareUriBuilder was case sensitive for parameter names.

Storage - Queues 12.9.0 Changelog

  • Includes all features from 12.9.0-beta.1, 12.9.0-beta.2, and 12.9.0-beta.3.

Tables 12.5.0 Changelog

Bugs Fixed

  • Fixed an issue that caused authenticate failures when using a SAS token with a table name that contains upper-case characters. (#26791)

WebJobs Extensions - Event Hubs 5.0.1 Changelog

Bugs Fixed

  • Cancel function execution after partition ownership is lost.
  • Stop the processor when disposing the listener to avoid having functions execute after the host has already been disposed.

Features Added

  • Add listener details

WebJobs Extensions - Service Bus 5.3.0 Changelog

Bugs Fixed

  • Ignore scheduled/deferred messages when computing scale monitor metrics. (A community contribution, courtesy of danielmarbach)

Features Added

  • Added the ability to renew message and session locks using the ServiceBusMessageActions and ServiceBusSessionActions.

WebJobs Extensions - Web PubSub 1.2.0 Changelog

Bugs Fixed

  • Fix CancellationToken in output binding.(#26704)

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.FormRecognizer --version 4.0.0-beta.3
$> dotnet add package Azure.Communication.Common --version 1.1.0
$> dotnet add package Azure.Data.Tables --version 12.5.0
$> dotnet add package Azure.Identity --version 1.6.0-beta.1
$> dotnet add package Azure.Messaging.EventGrid --version 4.9.0
$> dotnet add package Azure.Messaging.EventHubs --version 5.7.0-beta.4
$> dotnet add package Azure.Messaging.EventHubs.Processor --version 5.7.0-beta.4
$> dotnet add package Azure.Messaging.ServiceBus --version 7.7.0
$> dotnet add package Azure.Messaging.ServiceBus --version 7.8.0-beta.1
$> dotnet add package Azure.MixedReality.ObjectAnchors.Conversion --version 0.3.0-beta.2
$> dotnet add package Azure.ResourceManager.DnsResolver --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.Hci --version 1.0.0-beta.1
$> dotnet add package Azure.Search.Documents --version 11.4.0-beta.7
$> dotnet add package Azure.Storage.Blobs --version 12.11.0
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.8.0
$> dotnet add package Azure.Storage.Blobs.ChangeFeed --version 12.0.0-preview.20
$> dotnet add package Azure.Storage.Common --version 12.10.0
$> dotnet add package Azure.Storage.Files.DataLake --version 12.9.0
$> dotnet add package Azure.Storage.Files.Shares --version 12.9.0
$> dotnet add package Azure.Storage.Queues --version 12.9.0
$> dotnet add package Microsoft.Azure.Data.SchemaRegistry.ApacheAvro --version 1.0.0-beta.7
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.1
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.ServiceBus --version 5.3.0
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.Tables --version 1.0.0-beta.2
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.WebPubSub --version 1.2.0

Feedback

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