The Azure SDK team is pleased to announce our September 2020 client library releases.

GA

  • App Configuration
  • Event Hubs
  • Form Recognizer
  • Identity

Updates

  • Storage

Preview

  • Anomaly Detector
  • Event Grid
  • Identity
  • Key Vault (Administration, Certificates, Keys, Secrets)
  • Service Bus
  • Tables
  • Text Analytics

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.2

$> dotnet add package Azure.AI.FormRecognizer --version 3.0.0

$> dotnet add package Azure.AI.TextAnalytics --version 5.1.0-beta.1

$> dotnet add package Azure.Data.AppConfiguration --version 1.0.2

$> dotnet add package Azure.Data.Tables --version 3.0.0-beta.1

$> dotnet add package Azure.Extensions.AspNetCore.DataProtection.Keys --version 1.0.2

$> dotnet add package Azure.Identity --version 1.3.0-beta.1
$> dotnet add package Azure.Identity --version 1.2.3

$> dotnet add package Azure.Messaging.EventGrid --version 4.0.0-beta.1

$> dotnet add package Azure.Messaging.EventHubs
$> dotnet add package Azure.Messaging.EventHubs.Processor

$> dotnet add package Azure.Messaging.ServiceBus --version 7.0.0-preview.7

$> dotnet add package Azure.Security.KeyVault.Administration --version 4.0.0-beta.1
$> dotnet add package Azure.Security.KeyVault.Certificates --version 4.2.0-beta.1
$> dotnet add package Azure.Security.KeyVault.Keys --version 4.2.0-beta.1
$> dotnet add package Azure.Security.KeyVault.Secrets --version 4.2.0-beta.1

$> dotnet add package Azure.Storage.Blobs --version 12.6.0
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.3.1
$> dotnet add package Azure.Storage.Blobs.ChangeFeed --version 12.0.0-preview.4
$> dotnet add package Azure.Storage.Files.DataLake --version 12.4.0
$> dotnet add package Azure.Storage.Files.Shares --version 12.4.0
$> dotnet add package Azure.Storage.Queues --version 12.4.2

Feedback

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

Changelog

Detailed changelogs are linked from the Quick Links below. Here are some of the highlights:

Anomaly Detector Changelog

Breaking Changes

  • Renamed AnomalyDetectorClient.EntireDetectAsync and AnomalyDetectorClient.EntireDetect to AnomalyDetectorClient.DetectEntireSeriesAsync and AnomalyDetectorClient.DetectEntireSeries.
  • Renamed AnomalyDetectorClient.LastDetectAsync and AnomalyDetectorClient.LastDetect to AnomalyDetectorClient.DetectLastPointAsync and AnomalyDetectorClient.DetectLastPoint.
  • Renamed AnomalyDetectorClient.ChangePointDetectAsync and AnomalyDetectorClient.ChangePointDetect to AnomalyDetectorClient.DetectChangePointAsync and AnomalyDetectorClient.DetectChangePoint.
  • Renamed Request to DetectRequest.
  • Renamed Point to TimeSeriesPoint.

Azure.Core Changelog

New Features

  • HttpWebRequest-based transport implementation. Enabled by-default on .NET Framework. Can be disabled using AZURE_CORE_DISABLE_HTTPWEBREQUESTTRANSPORT environment variable or Azure.Core.Pipeline.DisableHttpWebRequestTransport AppContext switch.

Breaking Changes

  • ETag now supports weak ETags and implements an overload for ToString that accepts a format string.

Azure.Core.Experimental Changelog

New Features

  • JsonPatchDocument type to represent JSON Path document.
  • BinaryData: FromString method.
  • BinaryData: FromBytes method taking ReadOnlySpan.
  • BinaryData: constructor taking ReadOnlyMemory.

Breaking Changes

  • BinaryData: Renamed Serialize to FromObject.
  • BinaryData: Renamed Deserialize to ToObject.
  • BinaryData: Renamed FromMemory to FromBytes.

Azure.Data.AppConfiguration Changelog

New Features

  • Provide AddConfigurationClient with support for TokenCredential

Azure.Data.Tables Changelog

  • Initial beta release of Azure Data Tables client library

Azure.Extensions.AspNetCore.DataProtection.Keys Changelog

Key Bug Fixes

  • Support reading keys created by a previous version of Azure KeyVault Keys DataProtection library.

Azure.Security.KeyVault.Administration Changelog

New Features

  • Add KeyVaultAccessControlClient.
  • Add KeyVaultBackupClient.

Azure.Security.KeyVault.Certificates Changelog

New Features

  • Added KeyVaultCertificateIdentifier to parse certificate URIs.
  • Added link to sample on KeyVaultCertificate.Cer to the private key.

Azure.Security.KeyVault.Keys Changelog

New Features

  • Added KeyVaultKeyIdentifier to parse key URIs.
  • Added LocalCryptographyClient to do cryptography operations locally using a JsonWebKey.

Azure.Security.KeyVault.Secrets Changelog

New Features

  • Added KeyVaultSecretIdentifier to parse secret URIs.

Azure Storage Blobs Changelog

Key Bug Fixes

  • BlobClient.Upload(), BlockBlobClient.Upload(), AppendBlobClient.AppendBlock(), and PageBlobClient.UploadPages() will not deadlock anymore if the content stream’s position is not 0.
  • Fixed bug in BlobBaseClient.OpenRead() which was causing more downloads than necessary.
  • Fixed bug where PageBlobWriteStream would advance Position 2 times the number of written bytes.

Azure Storage Files DataLake Changelog

Key Bug Fixes

  • DataLakeFileClient.Upload() will not deadlock anymore if the content stream’s position is not 0.
  • Fixed bug in DataLakeFileClient.OpenRead() which was causing more downloads than necessary.

Azure Storage Files Shares Changelog

Key Bug Fixes

  • Fixed bug where ShareFileClient.Upload() and ShareFileClient.UploadRange() would deadlock if the content stream’s position was not set to 0.
  • Fixed bug in ShareFileClient.OpenRead() which was causing more downloads than necessary.
  • Fixed bug where ShareClient.Delete() could not delete Share Snapshots unless the includeSnapshots parameter was set to false.

Azure Storage Queues Changelog

Key Bug Fixes

  • Fixed a bug where QueueClient.UpdateMessage and QueueClient.UpdateMessageAsync were erasing message content if only visibilityTimeout was provided

Event Grid Changelog

  • Initial beta release of Azure Event Grid client library

Event Hubs Changelog

New Features

  • The EventProcessor<TPartition> now supports a configurable strategy for load balancing, allowing control over whether it claims ownership of partitions in a balanced manner (default) or more aggressively. The strategy may be set in the EventProcessorOptions when creating the processor. More details about strategies can be found in the associated documentation.

  • The EventHubConsumerClient now allows for performance tuning by setting the PrefetchCount and CacheEventCount values in its associated options.

Event Hubs Processor Changelog

New Features

  • The EventProcessorClient now supports a configurable strategy for load balancing, allowing control over whether it claims ownership of partitions in a balanced manner (default) or more aggressively. The strategy may be set in the EventProcessorClientOptions when creating the processor. More details about strategies can be found in the associated documentation.

  • The EventProcessorClient now allows for performance tuning by setting the PrefetchCount and CacheEventCount values in its associated options.

Key Bug Fixes

  • The approach used for creation of checkpoints has been updated to interact with Azure Blob storage more efficiently. This will yield major performance improvements when soft delete was enabled and minor improvements otherwise.

Identity Changelog

New Features

  • Restoring Application Authentication APIs from 1.2.0-preview.6
  • Added support for App Service Managed Identity API version 2019-08-01 (#13687)
  • Added IncludeX5CClaimHeader to ClientCertificateCredentialOptions to enable subject name / issuer authentication with the ClientCertificateCredential.
  • Added RedirectUri to InteractiveBrowserCredentialOptions to enable authentication with user specified application with a custom redirect url.
  • Added IdentityModelFactory to enable constructing models from the Azure.Identity library for mocking.
  • Unify exception handling between DefaultAzureCredential and ChainedTokenCredential (#14408)

Key Bug Fixes

  • Updated MsalPublicClient and MsalConfidentialClient to respect CancellationToken during initialization (#13201)
  • Fixed VisualStudioCodeCredential crashes on macOS (Issue #14362)
  • Fixed issue with non GUID Client Ids (Issue #14585)
  • Update VisualStudioCredential and VisualStudioCodeCredential to throw CredentialUnavailableException for ADFS tenant (Issue #14639)

Identity Changelog

Key Bug Fixes

  • Fixed issue with DefaultAzureCredential incorrectly catching AuthenticationFailedException (Issue #14974)
  • Fixed issue with DefaultAzureCredential throwing exceptions during concurrent calls (Issue #15013)

Azure.Messaging.ServiceBus Changelog

New Features

  • Added AmqpMessage property on ServiceBusMessage and ServiceBusReceivedMessage that gives full access to underlying AMQP details.
  • Added explicit Close methods on ServiceBusReceiver, ServiceBusSessionReceiver, ServiceBusSender, ServiceBusProcessor, and ServiceBusSessionProcessor.

Breaking Changes

  • Renamed ServiceBusManagementClient to ServiceBusAdministrationClient.
  • Renamed ServiceBusManagementClientOptions to ServiceBusAdministrationClientOptions.
  • Renamed IsDisposed to IsClosed on ServiceBusSender, ServiceBusReceiver, and ServiceBusSessionReceiver.
  • Made ServiceBusProcessor and ServiceBusSessionProcessor implement IAsyncDisposable
  • Removed public constructors for QueueProperties and RuleProperties.
  • Added version parameter to ServiceBusAdministrationClientOptions constructor.
  • Removed CreateDeadLetterReceiver methods in favor of new SubQueue property on ServiceBusReceiverOptions.
  • Made EntityNameFormatter internal.
  • Made settlement methods on ProcessMessageEventArgs and ProcessSessionMessageEventArgs virtual for mocking.
  • Made all Create methods on ServiceBusClient virtual for mocking.

Form Recognizer Changelog

  • First stable release of the Azure.AI.FormRecognizer package, targeting Azure Form Recognizer service API version 2.0.

New Features

  • Added FormRecognizerModelFactory static class to support mocking model types.

Text Analytics Changelog

New Features

  • It defaults to the latest supported API version, which currently is 3.1-preview.2.
  • ErrorCode value returned from the service is now surfaced in RequestFailedException.
  • Added the RecognizePiiEntities endpoint which returns entities containing Personally Identifiable Information. This feature is available in the Text Analytics service v3.1-preview.1 and above.
  • Support added for Opinion Mining. This feature is available in the Text Analytics service v3.1-preview.1 and above.
  • Added Offset and Length properties for CategorizedEntity, SentenceSentiment, and LinkedEntityMatch. The default encoding is UTF-16 code units. For additional information see https://aka.ms/text-analytics-offsets
  • TextAnalyticsError and TextAnalyticsWarning now are marked as immutable. -Added property BingEntitySearchApiId to the LinkedEntity class. This property is only available for v3.1-preview.2 and up, and it is to be used in conjunction with the Bing Entity Search API to fetch additional relevant information about the returned entity.

Latest Releases

View all the latest versions of .NET packages here. [Architecture Board]: https://github.com/azure/azure-sdk/issues