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

GA

  • Azure Communication Chat
  • Azure Communication Common
  • Azure Communication Identity
  • Azure Communication SMS
  • Communication Phone Numbers
  • Computer Vision
  • Core
  • Event Hubs
  • Event Hubs - Event Processor
  • Resource Management - Communication

Updates

  • Digital Twins - Core
  • Form Recognizer
  • Service Bus
  • Storage - Common
  • System Memory Data

Beta

  • Anomaly Detector
  • App Configuration
  • Attestation
  • Azure.AI.Translation.Document
  • Azure.IoT.ModelsRepository
  • Azure.Messaging.WebPubSub
  • Azure Communication Phone Numbers
  • Cognitive Search
  • Container Registry
  • Core - AMQP
  • Form Recognizer
  • Identity
  • IoT Device Update
  • Service Bus
  • Synapse - Artifacts
  • Storage - Files Shares
  • Storage - Blobs
  • Storage - Blobs Batch
  • Storage - Blobs ChangeFeed
  • Storage - Common
  • Storage - Files Data Lake
  • Storage - Queues
  • Tables
  • Text Analytics
  • Translation Document
  • WebJobs Extensions - Event Hubs
  • 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.AnomalyDetector --version 3.0.0-preview.3
$> dotnet add package Azure.AI.FormRecognizer --version 3.1.0-beta.4
$> dotnet add package Azure.AI.FormRecognizer --version 3.0.1
$> dotnet add package Azure.AI.TextAnalytics --version 5.1.0-beta.6
$> dotnet add package Azure.AI.Translation.Document --version 1.0.0-beta.1
$> dotnet add package Azure.Analytics.Synapse.Artifacts --version 1.0.0-preview.8
$> dotnet add package Azure.Communication.Chat --version 1.0.0
$> dotnet add package Azure.Communication.Common --version 1.0.0
$> dotnet add package Azure.Communication.Identity --version 1.0.0
$> dotnet add package Azure.Communication.PhoneNumbers --version 1.0.0-beta.6
$> dotnet add package Azure.Communication.PhoneNumbers --version 1.0.0
$> dotnet add package Azure.Communication.SMS --version 1.0.0
$> dotnet add package Azure.Containers.ContainerRegistry --version 1.0.0-beta.1
$> dotnet add package Azure.Core --version 1.12.0
$> dotnet add package Azure.Core --version 1.13.0
$> dotnet add package Azure.Core.Amqp --version 1.1.0-beta.1
$> dotnet add package Azure.Data.AppConfiguration --version 1.1.0-beta.2
$> dotnet add package Azure.Data.Tables --version 12.0.0-beta.7
$> dotnet add package Azure.DigitalTwins.Core --version 1.2.2
$> dotnet add package Azure.Identity --version 1.4.0-beta.5
$> dotnet add package Azure.IoT.DeviceUpdate --version 1.0.0-beta.2
$> dotnet add package Azure.IoT.ModelsRepository --version 1.0.0-preview.3
$> dotnet add package Azure.Messaging.EventHubs --version 5.4.0
$> dotnet add package Azure.Messaging.EventHubs.Processor --version 5.4.0
$> dotnet add package Azure.Messaging.ServiceBus --version 7.2.0-beta.2
$> dotnet add package Azure.Messaging.WebPubSub --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.Communication --version 1.0.0
$> dotnet add package Azure.Search.Documents --version 11.3.0-beta.1
$> dotnet add package Azure.Security.Attestation --version 1.0.0-beta.2
$> dotnet add package Azure.Storage.Blobs --version 12.9.0-beta.3
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.6.0-beta.3
$> dotnet add package Azure.Storage.Blobs.ChangeFeed --version 12.0.0-preview.11
$> dotnet add package Azure.Storage.Common --version 12.7.2
$> dotnet add package Azure.Storage.Common --version 12.8.0-beta.3
$> dotnet add package Azure.Storage.Files.DataLake --version 12.7.0-beta.3
$> dotnet add package Azure.Storage.Files.Shares --version 12.7.0-beta.3
$> dotnet add package Azure.Storage.Queues --version 12.7.0-beta.3
$> dotnet add package Microsoft.Azure.CognitiveServices.Vision.ComputerVision --version 7.0.0
$> dotnet add package Microsoft.Azure.ServiceBus --version 5.1.3
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.0-beta.4
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.ServiceBus --version 5.0.0-beta.2
$> dotnet add package System.Memory.Data --version 1.0.2

Feedback

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

Release highlights

Core 1.12.0 Changelog

Added

  • Added HttpPipeline.CreateHttpMessagePropertiesScope that can be used to inject scoped properties into HttpMessage.

IoT Device Update 1.0.0-beta.2 Changelog

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

Storage - Common 12.7.2 Changelog

  • Fixed bug in SasQueryParameters causing services (ss) reorder when parsing externally provided URI.

Event Hubs 5.4.0 Changelog

New Features

  • The Event Hubs clients now support shared key and shared access signature authentication using the AzureNamedKeyCredential and AzureSasCredential types in addition to the connection string. Use of the credential allows the shared key or SAS to be updated without the need to create a new Event Hubs client.

  • The Properties collection used by EventData is now lazily allocated, avoiding memory bloat when not used.

  • The SystemProperties collection used by EventData will not use a shared empty set for events that have not been read from the Event Hubs service, reducing memory allocation.

  • Multiple enhancements were made to the transport paths for publishing and reading events to reduce memory allocations and increase performance. (A community contribution, courtesy of danielmarbach)

Key Bug Fixes

  • The AMQP library used for transport has been updated, fixing several issues including a potential unobserved ObjectDisposedException that could cause the host process to crash. (see: release notes)

Event Hubs - Event Processor 5.4.0 Changelog

New Features

  • The EventProcessorClient now supports shared key and shared access signature authentication using the AzureNamedKeyCredential and AzureSasCredential types in addition to the connection string. Use of the credential allows the shared key or SAS to be updated without the need to create a new processor.

  • Multiple enhancements were made to the AMQP transport paths for reading events to reduce memory allocations and increase performance. (A community contribution, courtesy of danielmarbach)

Key Bug Fixes

  • The AMQP library used for transport has been updated, fixing several issues including a potential unobserved ObjectDisposedException that could cause the host process to crash. (see: release notes)

Attestation 1.0.0-beta.2 Changelog

  • Fixed bug #19708, handle JSON values that are not just simple integers.
  • Fixed bug #18183, Significant cleanup of README.md.
  • Fixed bug #18739, reference the readme.md file in the azure-rest-apis directory instead of referencing the attestation JSON file directly. Also updated to the most recent version of the dataplane swagger files.

Text Analytics 5.1.0-beta.6 Changelog

New features

  • Add overloads to ExtractKeyPhrasesBatch and ExtractKeyPhrasesBatchAsync to on TextAnalyticsClient to accept ExtractKeyPhrasesOptions and hid the previous methods (non-breaking change).
  • Add overloads to RecognizeEntitiesBatch and RecognizeEntitiesBatchAsync to on TextAnalyticsClient to accept RecognizeEntitiesOptions and hid the previous methods (non-breaking change).
  • Add overloads to RecognizeLinkedEntitiesBatch and RecognizeLinkedEntitiesBatch to on TextAnalyticsClient to accept RecognizeLinkedEntitiesOptions and hid the previous methods (non-breaking change).

Breaking changes

  • Renamed TotalActions to ActionsTotal.

Tables 12.0.0-beta.7 Changelog

Acknowledgments

Thank you to our developer community members who helped to make Azure Tables better with their contributions to this release:

Added

  • Added the TableErrorCode type which allows comparison of the ErrorCode on RequestFailedExceptions thrown from client operations with a known error value.
  • TableEntity and custom entity types now support BinaryData properties.

Key Bug Fixes

  • Fixed handling of paging headers when Table Storage returned a x-ms-continuation-NextPartitionKey but no x-ms-continuation-NextRowKey. This was causing an HTTP 400 on the subsequent page query (A community contribution, courtesy of joelverhagen)

Changed

  • Removed the Timestamp property from the serialized entity when sending it to the service as it is ignored by the service (A community contribution, courtesy of joelverhagen)

Synapse - Artifacts 1.0.0-preview.8 Changelog

Added

  • Many additional model classes

Changed

  • Exposed Serialization and Deserialization methods.

App Configuration 1.1.0-beta.2 Changelog

Breaking changes

  • The AddSyncToken method renamed to UpdateSyncToken.

Translation Document 1.0.0-beta.1 Changelog

This is the first beta package of the Azure.AI.Translation.Document client library that targets the service version 1.0-preview.1. This package’s documentation and samples demonstrate the new API.

Cognitive Search 11.3.0-beta.1 Changelog

Added

Form Recognizer 3.1.0-beta.4 Changelog

New Features

  • Added support for pre-built passports and US driver licenses recognition with the StartRecognizeIdDocuments API.
  • Expanded the set of document languages that can be provided to the StartRecognizeContent API.
  • Added property Pages to RecognizeBusinessCardsOptions, RecognizeCustomFormsOptions, RecognizeInvoicesOptions, and RecognizeReceiptsOptions to specify the page numbers to recognize.
  • Added property ReadingOrder to RecognizeContentOptions to specify the order in which recognized text lines are returned.

Breaking changes

  • The client defaults to the latest supported service version, which currently is 2.1-preview.3.
  • StartRecognizeCustomForms now throws a RequestFailedException when an invalid file is passed.

Identity 1.4.0-beta.5 Changelog

Acknowledgments

Thank you to our developer community members who helped to make Azure Identity better with their contributions to this release:

New Features

  • Added AzurePowerShellCredential to DefaultAzureCredential (A community contribution, courtesy of olandese)

Fixes and improvements

  • When logging is enabled, the log output from MSAL is also logged.
  • Fixed an issue where an account credential fails to load from the cache when EnableGuestTenantAuthentication is true and the account found in the cache has multiple matching tenantIds (#18276).
  • Fixed deadlock issue in InteractiveBrowserCredential when running in a UI application (#18418).

Breaking Changes

  • TokenCache class is moved removed from the public API surface and has been replaced by TokenCachePersistenceOptions for configuration of disk based persistence of the token cache.

Core - AMQP 1.1.0-beta.1 Changelog

Added

  • Added support for Sequence and Value body messages.

WebJobs Extensions - Event Hubs 5.0.0-beta.4 Changelog

Changes

  • Single dispatch triggers were disabled.

System Memory Data 1.0.2 Changelog

  • Add System.Text.Encodings.Web dependency

Core 1.13.0 Changelog

Key Bug Fixes

  • Fixed NotSupportedException when running using Blazor in the browser.
  • Disable the response caching and enable the streaming when running using Blazor in the browser.

Computer Vision 7.0.0 Changelog

Supports v3.2 Cognitive Services Computer Vision API endpoints.

Added

  • Added model versioning support

Changed

  • Updated the Adult visual feature for Analyze Image operation
  • Updated the Tags visual feature for Analyze Image operation and the Tag Image operation
  • Updated the error response format

Azure Communication Chat 1.0.0 Changelog

Includes all changes from 1.0.0-beta.1 to 1.0.0.beta.5

Breaking Changes

  • Renamed client constructors URL variable to endpoint.
  • Renamed ChatThread model to ChatThreadProperties.
  • Renamed GetChatThread operation to GetProperties and moved it to ChatThreadClient.
  • Renamed ChatThreadInfo model to ChatThreadItem.
  • Renamed GetChatThreadsInfo operation to GetChatThreads.
  • Made AddParticipant throw exception when request fails.
  • Renamed parameter repeatabilityRequestId to idempotencyToken.
  • Updated SendMessage to use SendChatMessageResult instead of string for the request result.
  • Exposed the list of invalidparticipants directly and removed AddChatParticipantsErrors and CreateChatThreadErrors models for AddChatParticipantsResult and CreateChatThreadResult.

Added

  • Made list of participants optional for CreateChatThread.
  • Made ChatThreadClient constructor public.

Azure Communication Common 1.0.0 Changelog

Includes all changes from 1.0.0-beta.1 to 1.0.0.beta.5

Azure Communication Identity 1.0.0 Changelog

Includes all changes from 1.0.0-beta.1 to 1.0.0.beta.5

Azure Communication Phone Numbers 1.0.0-beta.6 Changelog

Added

  • Added protected constructor to PurchasePhoneNumbersOperation and ReleasePhoneNumberOperation for mocking.

Breaking Changes

  • All models are moved from Azure.Communication.PhoneNumbers.Models namespace to Azure.Communication.PhoneNumbers.
  • AcquiredPhoneNumber class is renamed to PurchasedPhoneNumber.
  • PhoneNumbersClient methods renamed:
    • GetPhoneNumber -> GetPurchasedPhoneNumber.
    • GetPhoneNumberAsync -> GetPurchasedPhoneNumberAsync.
    • GetPhoneNumbers -> GetPurchasedPhoneNumbers.
    • GetPhoneNumbersAsync -> GetPurchasedPhoneNumbersAsync.
  • PhoneNumbersModelFactory static method AcquiredPhoneNumber is renamed to PurchasedPhoneNumber.
  • PurchasePhoneNumbersOperation and ReleasePhoneNumberOperation extend Operation instead of Operation<Response>.
  • Removed PhoneNumberOperationStatus and PhoneNumberOperationType.
  • Renamed ISOCurrencySymbol property to IsoCurrencySymbol in PhoneNumberCost.
  • Renamed threeLetterISOCountryName parameter to twoLetterIsoCountryName in PhoneNumbersClient.StartSearchAvailablePhoneNumbers and PhoneNumbersClient.StartSearchAvailablePhoneNumbersAsync`.

Azure Communication SMS 1.0.0 Changelog

Includes all changes from 1.0.0-beta.1 to 1.0.0.beta4

Resource Management - Communication 1.0.0 Changelog

This is the first stable release of the management library for Azure Communication Services.

Minor changes since the public preview release:

  • CheckNameAvailability has been added
  • CommunicationServiceResource Update now requires a CommunicationServiceResource parameter instead of a TaggedResource
  • RegenerateKeyParameters is now a required parameter to RegenerateKey
  • CommunicationServiceResource now includes the property SystemData
  • OperationList has been changed to use the common type for its response
  • ErrorResponse has been changed to use the common type for ErrorResponse

    Storage - Files Shares 12.7.0-beta.3 Changelog

  • This release contains bug fixes to improve quality.

Storage - Blobs 12.9.0-beta.3 Changelog

  • This release contains bug fixes to improve quality.

Storage - Blobs Batch 12.6.0-beta.3 Changelog

  • This release contains bug fixes to improve quality.

Storage - Common 12.8.0-beta.3 Changelog

  • Fixed bug in SasQueryParameters causing services (ss) reorder when parsing externally provided URI.

Storage - Blobs ChangeFeed 12.0.0-preview.11 Changelog

  • This release contains bug fixes to improve quality.

Storage - Queues 12.7.0-beta.3 Changelog

  • This preview contains bug fixes to improve quality.

Storage - Files Data Lake 12.7.0-beta.3 Changelog

  • Aligned storage URL parsing with other platforms.

Azure.IoT.ModelsRepository 1.0.0-preview.3 Changelog

  • Updated core dependencies to bring in security vulnerability fixes that are addressed in Azure.Core v1.13.0 and System.Memory.Data v1.0.2

Digital Twins - Core 1.2.2 Changelog

Fixes and improvements

  • Updated core dependencies to bring in security vulnerability fixes that are addressed in Azure.Core v1.13.0 and System.Memory.Data v1.0.2

Anomaly Detector 3.0.0-preview.3 Changelog

Breaking Changes

  • TimeSeriesPoint.Timestamp property is now nullable.
  • TimeSeriesPoint(System.DateTimeOffset timestamp, float value) constructor now takes only float type parameter.

New Features

  • Added operation AnomalyDetectorClient.ListMultivariateModelAsync and AnomalyDetectorClient.ListMultivariateModel
  • Added operation AnomalyDetectorClient.TrainMultivariateModelAsync and AnomalyDetectorClient.TrainMultivariateModel
  • Added operation AnomalyDetectorClient.DetectAnomalyAsync and AnomalyDetectorClient.DetectAnomaly
  • Added operation AnomalyDetectorClient.GetDetectionResultAsync and AnomalyDetectorClient.GetDetectionResult
  • Added operation AnomalyDetectorClient.GetMultivariateModelAsync and AnomalyDetectorClient.GetMultivariateModel
  • Added operation AnomalyDetectorClient.ExportModelAsync and AnomalyDetectorClient.ExportModel
  • Added operation AnomalyDetectorClient.DeleteMultivariateModelAsync and AnomalyDetectorClient.DeleteMultivariateModel

Azure.Messaging.WebPubSub 1.0.0-beta.1 Changelog

  • Initial beta release.

Container Registry 1.0.0-beta.1 Changelog

  • Started changelog to capture release notes.

Service Bus 7.2.0-beta.2 Changelog

Acknowledgments

Thank you to our developer community members who helped to make the Service Bus client library better with their contributions to this release:

  • Daniel Marbach (GitHub)
  • Mikael Kolkinn

Added

  • Updated dependency on Azure.Core.Amqp to support Value/Sequence AMQP message bodies.
  • Updated dependency on Microsoft.Azure.Amqp to benefit from a performance enhancement involving message settlement.
  • Added OnProcessMessageAsync and OnProcessErrorAsync methods to help with mocking scenarios involving the processor.
  • Added the ability to construct a ServiceBusClient and ServiceBusAdministrationClient using the AzureNamedKeyCredential and AzureSasCredential types to allow for updating credentials for long-lived clients.
  • Added the ability to cancel receive operations which allows StopProcessingAsync calls on the processor to complete more quickly. (A community contribution, courtesy of danielmarbach)

Fixed

  • Multiple enhancements were made to the transport paths for publishing and reading events to reduce memory allocations and increase performance. (A community contribution, courtesy of danielmarbach)
  • Fixed an issue where constructing a new CreateRuleOption from a RuleProperties would fail if the CorrelationId was null. (A community contribution, courtesy of mikaelkolkinn)

WebJobs Extensions - Service Bus 5.0.0-beta.2 Changelog

Added

  • Add AAD support

Breaking Changes

  • Changed the API signatures for the methods in MessagingProvider.
  • Added receiver parameter to MessageProcessor constructor.
  • Added client parameter to SessionMessageProcessor constructor.

Service Bus 5.1.3 Changelog

Update package description to include pointer to the new Azure.Messaging.ServiceBus package and the migration guide.

Form Recognizer 3.0.1 Changelog

Key Bug Fixes

  • Updated dependency versions.

Communication Phone Numbers 1.0.0 Changelog

Updated Azure.Communication.PhoneNumbers version.

Latest Releases

View all the latest versions of .NET packages here.