Azure SDK for .NET (November 2021)
The Azure SDK team is pleased to announce our November 2021 client library releases.
51 packages released this month.
Stable Packages (11)
-
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
Patch Updates (2)
-
Monitor Query
-
Tables
Beta Packages (35)
-
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
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 manifestStream` as an input. - Added methods in
ContainerRegistryModelFactorythat create instances ofDownloadBlobResult,DownloadManifestResult,UploadBlobResultandUploadManifestResultfor mocking. - Added
DownloadManifestOptionstype to allow callers to pass-in either a tag or a digest inDownloadManifest(Async). - Added
ManifestStreamas a property inDownloadManifestResultthat contains the raw manifest stream from the service response.
Breaking Changes
- Changed
DownloadManifest(Async)method to takeDownloadManifestOptionsas 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
- Added support for anonymous pull access using the
ContainerRegistryBlobClient
Conversation Analysis 1.0.0-beta.1 Changelog
- Initial release.
Core 1.21.0 Changelog
- Added
RequestContextandErrorOptionstypes to aid in configuring requests. - Added
ContentTypestrongly-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:
- 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:
- GeographyLineString
- GeographyPolygon
- GeographyMultiPoint
- GeographyMultiLineString
- GeographyMultiPolygon
- GeographyCollection
Document Translation 1.0.0-beta.6 Changelog
Breaking Changes
- Removed types
DocumentTranslationErrorandDocumentTranslationErrorCode. These affected the classesDocumentStatusResultandTranslationStatusResult. Errors in both classes are now exposed asResponseError. - Renamed method
DocumentStatustoDocumentStatusResultinDocumentTranslationModelFactory, which now takes aBinaryDatatype instead ofDocumentTranslationError. - Renamed method
TranslationStatustoTranslationStatusResultinDocumentTranslationModelFactory, which now takes aBinaryDatatype instead ofDocumentTranslationError.
Event Hubs 5.7.0-beta.1 Changelog
Features Added
- The
EventHubBufferedProducerClientis 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
EventProcessorClientload balancing cycle to help discover issues that can impact processor performance and stability; these validations will produce warnings should potential concerns be found. -
EventProcessorClientwill 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
BuildModelOperationandCopyModelOperationcorrectly populate thePercentCompletedproperty, instead of always having a value of0.
Identity 1.5.0 Changelog
Bugs Fixed
- Fixed issue with
AuthorizationCodeCredentialnot 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.TryCreateto 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
DownloadCertificateOptionsto passX509KeyStorageFlagsappropriate for different host applications. (#23016)
Key Vault - Keys 4.3.0-beta.2 Changelog
Features Added
- Added
JsonWebKeyConverterto support serializing and deserializing aJsonWebKeyto a RFC 7517 JWK. (#16155) - Added
KeyClient.GetCryptographyClientto get aCryptographyClientthat uses the same options, policies, and pipeline as theKeyClientthat created it. (#23786) - Added
KeyRotationPolicyclass and new methods includingKeyClient.GetKeyRotationPolicy,KeyClient.RotateKey, andKeyClient.UpdateKeyRotationPolicy. - Added
KeyVaultKeyIdentifier.TryCreateto 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
RandomBytestobyte[]onKeyClient.GetRandomBytesandGetRandomBytesAsync. - Renamed
KeyReleasePolicy.DatatoKeyReleasePolicy.EncodedPolicyand changed property type frombyte[]toBinaryData. - Renamed
nameandversionparameters onKeyClient.GetCryptographyClienttokeyNameandkeyVersion, respectively. - Renamed
targetparameter onKeyClient.ReleaseKeyandReleaseKeyAsynctotargetAttestationToken.
Key Vault - Secrets 4.3.0-beta.2 Changelog
Features Added
- Added
KeyVaultSecretIdentifier.TryCreateto 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-previewand 2021-07-15-preview` were removed. - Moved all models from
Azure.AI.Language.QuestionAnswering.ModelstoAzure.AI.Language.QuestionAnswering. - Renamed method
QuestionAnsweringClient.QueryKnowledgeBasetoGetAnswers. - Renamed method
QuestionAnsweringClient.QueryKnowledgeBaseAsynctoGetAnswersAsync. - Methods
GetAnswersandGetAnswersAsyncnow accept a question string or QnA ID, aQuestionAnsweringProject, and optionalAnswersOptionsparameters. - Moved parameters
projectNameanddeploymentNameto the newQuestionAnsweringProjectclass. - Renamed class
QueryKnowledgeBaseOptionstoAnswersOptions. - Renamed property
QueryKnowledgeBaseOptions.AnswerSpanRequesttoAnswersOptions.ShortAnswerOptions. - Renamed property
QueryKnowledgeBaseOptions.ConfidenceScoreThresholdtoAnswersOptions.ConfidenceThreshold. - Renamed property
QueryKnowledgeBaseOptions.ContexttoAnswersOptions.AnswerContext. - Renamed property
QueryKnowledgeBaseOptions.RankerTypetoAnswersOptions.RankerKind. - Renamed property
QueryKnowledgeBaseOptions.ToptoAnswersOptions.Size. - Renamed method
QuestionAnsweringClient.QueryTexttoGetAnswersFromText. - Renamed method
QuestionAnsweringClient.QueryTextAsynctoGetAnswersFromTextAsync. - Renamed class
QueryTextOptionstoAnswersFromTextOptions. - Renamed property
QueryTextOptions.RecordstoAnswersFromTextOptions.TextDocuments. - Renamed class
TextRecordtoTextDocument. - Renamed class
AnswerSpanRequesttoShortAnswerOptions. - Renamed property
AnswerSpanRequest.ConfidenceScoreThresholdtoShortAnswerOptions.ConfidenceThreshold. - Renamed property
AnswerSpanRequest.TopAnswersWithSpantoShortAnswersOptions.Size. - Renamed class
KnowledgeBaseAnswerRequestContexttoKnowledgeBaseAnswerContext. - Renamed property
KnowledgeBaseAnswerRequestContext.PreviousUserQuerytoKnowledgeBaseAnswerContext.PreviousQuestion. - Renamed class
KnowledgeBaseAnswerstoAnswersResult. - Renamed class
TextAnswerstoAnswersFromTextResult. - Renamed property
KnowledgeBaseAnswer.AnswerSpantoKnowledgeBaseAnswer.ShortAnswer. - Renamed property
KnowledgeBaseAnswer.ConfidenceScoretoKnowledgeBaseAnswer.Confidence. - Renamed property
KnowledgeBaseAnswer.IdtoKnowledgeBaseAnswer.QnaId. - Renamed property
AnswerSpan.ConfidenceScorehas been renamed toAnswerSpan.Confidence. - Renamed property
TextAnswer.ConfidenceScorehas been renamed toTextAnswer.confidence. - Renamed property
TextAnswer.AnswerSpanhas 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
Contentproperty ofSchemaRegistrySchematoDefinition. - Renamed
nameparameter ofRegisterSchemaandGetSchemaPropertiesmethods toschemaName.
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, andCorrelationIdproperties ofServiceBusMessageto 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
KqlScriptContentCurrentConnectionnow has poolName and databaseName properties
Tables 12.2.1 Changelog
Bugs Fixed
- Handle the case where the Uri parameter to the
TableClientconstructor contains the table name. (#24667)
Tables 12.3.0 Changelog
Breaking Changes
- The fix to escape
PartitionKeyandRoKeyproperty values containing single quote characters are not properly escaped onGetEntitycalls 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” totrueor 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
PartitionKeyandRoKeyproperty values containing single quote characters are not properly escaped onGetEntitycalls. See breaking changes section for more information.
Text Analytics 5.2.0-beta.2 Changelog
Bugs Fixed
AnalyzeActionsOperation.GetValuesAsync()andAnalyzeHealthcareEntitiesOperation.GetValuesAsync()are now validating that the operation has completed successfully before attempting to return any values. AnInvalidOperationExceptionis thrown if this is not true.
Features Added
- Adding support for three new actions in
StartAnalyzeActions:RecognizeCustomEntities,SingleCategoryClassify, andMultiCategoriesClassify. The new actions allow you to use custom models to perform entity recognition and category classification. - Added property
ActionNameto allxxActionsinput types so user can specify a name per action. If not provided, service will generate a name. - Added property
ActionNameto allxxActionResultoutput 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
GenerateClientAccessUritoGetClientAccessUri
Features Added
- Added extension method
AddWebPubSubServiceClientforTokenCredential - Added
CloseGroupConnections,CloseAllConnectionsandCloseUserConnections
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
EnableCrossEntityTransactionsoption - Added ability to bind to
ServiceBusClient
WebJobs Extensions - Web PubSub 1.0.0-beta.4 Changelog
Features Added
- Add
Connectionattribute to input binding and trigger binding to support upstream validations. - Add support to
CloseAllConnectionsandCloseGroupConnections.
Breaking Changes
- Rename
WebPubSubRequestinput binding toWebPubSubContext. - 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.WebPubSubto 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
WebPubSubActionto easily discover available actions. - Add dependency
Azure.Messageing.WebPubSubfor service calls. - Rename output binding from
WebPubSubOperationtoWebPubSubAction, and addActionas suffix for derived classes. - Rename
operationKindtoactionNamein output binding for javascript to deserialize. - Changed the name and type of the
Uriproperties inWebPubSubConnectionto match other libraries in the Azure SDK for .NET.
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.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.