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 manifest
Stream` as an input. - Added methods in
ContainerRegistryModelFactory
that create instances ofDownloadBlobResult
,DownloadManifestResult
,UploadBlobResult
andUploadManifestResult
for mocking. - Added
DownloadManifestOptions
type to allow callers to pass-in either a tag or a digest inDownloadManifest(Async)
. - Added
ManifestStream
as a property inDownloadManifestResult
that contains the raw manifest stream from the service response.
Breaking Changes
- Changed
DownloadManifest(Async)
method to takeDownloadManifestOptions
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
- 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
RequestContext
andErrorOptions
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:
- 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
DocumentTranslationError
andDocumentTranslationErrorCode
. These affected the classesDocumentStatusResult
andTranslationStatusResult
. Errors in both classes are now exposed asResponseError
. - Renamed method
DocumentStatus
toDocumentStatusResult
inDocumentTranslationModelFactory
, which now takes aBinaryData
type instead ofDocumentTranslationError
. - Renamed method
TranslationStatus
toTranslationStatusResult
inDocumentTranslationModelFactory
, which now takes aBinaryData
type instead ofDocumentTranslationError
.
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
andCopyModelOperation
correctly populate thePercentCompleted
property, instead of always having a value of0
.
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 passX509KeyStorageFlags
appropriate for different host applications. (#23016)
Key Vault - Keys 4.3.0-beta.2 Changelog
Features Added
- Added
JsonWebKeyConverter
to support serializing and deserializing aJsonWebKey
to a RFC 7517 JWK. (#16155) - Added
KeyClient.GetCryptographyClient
to get aCryptographyClient
that uses the same options, policies, and pipeline as theKeyClient
that created it. (#23786) - Added
KeyRotationPolicy
class and new methods includingKeyClient.GetKeyRotationPolicy
,KeyClient.RotateKey
, andKeyClient.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
tobyte[]
onKeyClient.GetRandomBytes
andGetRandomBytesAsync
. - Renamed
KeyReleasePolicy.Data
toKeyReleasePolicy.EncodedPolicy
and changed property type frombyte[]
toBinaryData
. - Renamed
name
andversion
parameters onKeyClient.GetCryptographyClient
tokeyName
andkeyVersion
, respectively. - Renamed
target
parameter onKeyClient.ReleaseKey
andReleaseKeyAsync
totargetAttestationToken
.
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
toAzure.AI.Language.QuestionAnswering
. - Renamed method
QuestionAnsweringClient.QueryKnowledgeBase
toGetAnswers
. - Renamed method
QuestionAnsweringClient.QueryKnowledgeBaseAsync
toGetAnswersAsync
. - Methods
GetAnswers
andGetAnswersAsync
now accept a question string or QnA ID, aQuestionAnsweringProject
, and optionalAnswersOptions
parameters. - Moved parameters
projectName
anddeploymentName
to the newQuestionAnsweringProject
class. - Renamed class
QueryKnowledgeBaseOptions
toAnswersOptions
. - Renamed property
QueryKnowledgeBaseOptions.AnswerSpanRequest
toAnswersOptions.ShortAnswerOptions
. - Renamed property
QueryKnowledgeBaseOptions.ConfidenceScoreThreshold
toAnswersOptions.ConfidenceThreshold
. - Renamed property
QueryKnowledgeBaseOptions.Context
toAnswersOptions.AnswerContext
. - Renamed property
QueryKnowledgeBaseOptions.RankerType
toAnswersOptions.RankerKind
. - Renamed property
QueryKnowledgeBaseOptions.Top
toAnswersOptions.Size
. - Renamed method
QuestionAnsweringClient.QueryText
toGetAnswersFromText
. - Renamed method
QuestionAnsweringClient.QueryTextAsync
toGetAnswersFromTextAsync
. - Renamed class
QueryTextOptions
toAnswersFromTextOptions
. - Renamed property
QueryTextOptions.Records
toAnswersFromTextOptions.TextDocuments
. - Renamed class
TextRecord
toTextDocument
. - Renamed class
AnswerSpanRequest
toShortAnswerOptions
. - Renamed property
AnswerSpanRequest.ConfidenceScoreThreshold
toShortAnswerOptions.ConfidenceThreshold
. - Renamed property
AnswerSpanRequest.TopAnswersWithSpan
toShortAnswersOptions.Size
. - Renamed class
KnowledgeBaseAnswerRequestContext
toKnowledgeBaseAnswerContext
. - Renamed property
KnowledgeBaseAnswerRequestContext.PreviousUserQuery
toKnowledgeBaseAnswerContext.PreviousQuestion
. - Renamed class
KnowledgeBaseAnswers
toAnswersResult
. - Renamed class
TextAnswers
toAnswersFromTextResult
. - Renamed property
KnowledgeBaseAnswer.AnswerSpan
toKnowledgeBaseAnswer.ShortAnswer
. - Renamed property
KnowledgeBaseAnswer.ConfidenceScore
toKnowledgeBaseAnswer.Confidence
. - Renamed property
KnowledgeBaseAnswer.Id
toKnowledgeBaseAnswer.QnaId
. - Renamed property
AnswerSpan.ConfidenceScore
has been renamed toAnswerSpan.Confidence
. - Renamed property
TextAnswer.ConfidenceScore
has been renamed toTextAnswer.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 ofSchemaRegistrySchema
toDefinition
. - Renamed
name
parameter ofRegisterSchema
andGetSchemaProperties
methods 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
, andCorrelationId
properties ofServiceBusMessage
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 escape
PartitionKey
andRoKey
property values containing single quote characters are not properly escaped onGetEntity
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” totrue
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
andRoKey
property values containing single quote characters are not properly escaped onGetEntity
calls. 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. AnInvalidOperationException
is 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
ActionName
to allxxActions
input types so user can specify a name per action. If not provided, service will generate a name. - Added property
ActionName
to allxxActionResult
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
toGetClientAccessUri
Features Added
- Added extension method
AddWebPubSubServiceClient
forTokenCredential
- Added
CloseGroupConnections
,CloseAllConnections
andCloseUserConnections
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
andCloseGroupConnections
.
Breaking Changes
- Rename
WebPubSubRequest
input 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.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
toWebPubSubAction
, and addAction
as suffix for derived classes. - Rename
operationKind
toactionName
in output binding for javascript to deserialize. - Changed the name and type of the
Uri
properties inWebPubSubConnection
to 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.