Azure SDK for .NET (August 2023)
The Azure SDK team is pleased to announce our August 2023 client library releases.
39 packages released this month.
Stable Packages (10)
-
Azure client library integration for ASP.NET Core
-
Form Recognizer
-
Functions extension for Azure Tables
-
Resource Management - Container Apps
-
Resource Management - Data Protection
-
Resource Management - Graph Services
-
Resource Management - Managed Network Fabric
-
Resource Management - Network
-
Resource Management - Paloaltonetworks.Ngfw
-
Service Bus
Beta Packages (27)
-
Azure Communication JobRouter
-
Brokered Authentication
-
Cognitive Search
-
Communication Phone Numbers
-
Event Grid
-
Identity
-
OpenTelemetry AspNetCore
-
OpenTelemetry Exporter
-
Resource Management - Compute
-
Resource Management - Container Apps
-
Resource Management - Cosmos DB
-
Resource Management - Data Factory
-
Resource Management - ElasticSan
-
Resource Management - Maintenance
-
Resource Management - PostgreSQL
-
Resource Management - Resource Manager
-
Resource Management - SQL
-
Resource Management - Storage Mover
-
Schema Registry
-
Storage - Blobs
-
Storage - Blobs Batch
-
Storage - Blobs ChangeFeed
-
Storage - Common
-
Storage - Files Data Lake
-
Storage - Files Share
-
Storage - Queues
-
Synapse - Artifacts
Release highlights
Azure Communication JobRouter 1.0.0-beta.1 Changelog
Features Added
- Using
JobRouterAdministrationClient
- Create, update, get, list and delete
DistributionPolicy
. - Create, update, get, list and delete
RouterQueue
. - Create, update, get, list and delete
ClassificationPolicy
. - Create, update, get, list and delete
ExceptionPolicy
. - Using
JobRouterClient
- Create, update, get, list and delete
RouterJob
. RouterJob
can be created and updated with different matching modes:QueueAndMatchMode
,ScheduleAndSuspendMode
andSuspendMode
.- Re-classify a
RouterJob
. - Close a
RouterJob
. - Complete a
RouterJob
. - Cancel a
RouterJob
. - Un-assign a
RouterJob
, with option to suspend matching. - Get the position of a
RouterJob
in a queue. - Create, update, get, list and delete
RouterWorker
. - Accept an offer.
- Decline an offer.
- Get queue statistics.
Azure client library integration for ASP.NET Core 1.7.0 Changelog
Features Added
- Added support for creating
WorkloadIdentityCredential
objects from the configuration using the"credential": "workloadidentity"
. Users must provide values for thetenentId
,clientId
, and newly addedtokenFilePath
keys in the configuration, or they must set the environment variablesAZURE_TENANT_ID
,AZURE_CLIENT_ID
, andAZURE_FEDERATED_TOKEN_FILE
.
Brokered Authentication 1.0.0-beta.4 Changelog
Features Added
- Added support for MSA passthrough. Note this is only available for legacy 1st party applications.
Cognitive Search 11.5.0-beta.4 Changelog
Features Added
- Added the ability to perform multiple vectors query searches.
- Added support for vector queries over multiple fields.
Communication Phone Numbers 1.2.0-beta.1 Changelog
Features Added
- Added custom page sizes to PurchasedPhoneNumbers, Countries, Localities, AreaCodes and Offerings.
Event Grid 4.18.0-beta.1 Changelog
Other Changes
- Shipping the
EventGridClient
on top of the latest system events.
Form Recognizer 4.1.0 Changelog
Bugs Fixed
- Fixed a bug where calling the
GetResourceDetails
API while targeting service version2022-08-31
would throw anArgumentNullException
.
Breaking Changes
DocumentAnalysisClient
andDocumentModelAdministrationClient
now target service API version2023-07-31
by default. Version2023-02-28-preview
is not supported anymore.- In struct
DocumentAnalysisFeature
, propertiesOcrFormula
andOcrFont
were renamed toFormulas
andFontStyling
, respectively. - Removed query fields support. The properties
AnalyzeDocumentOptions.QueryFields
andDocumentAnalysisFeature.QueryFieldsPremium
were removed. - Removed image extraction support. The class
DocumentImage
and the propertyDocumentPage.Images
were removed. - Removed annotation extraction support. The types
DocumentAnnotation
,DocumentAnnotationKind
, and the propertyDocumentPage.Annotations
were removed. - Removed struct
DocumentPageKind
and propertyDocumentPage.Kind
. - Removed property
DocumentKeyValuePair.CommonName
. - In
DocumentBarcodeKind
, renamed membersQRCode
,PDF417
,EAN8
,EAN13
,ITF
, andMicroQRCode
toQrCode
,Pdf417
,Ean8
,Ean13
,Itf
, andMicroQrCode
, respectively. - Renamed class
AzureBlobContentSource
toBlobContentSource
. - Renamed class
AzureBlobFileListSource
toBlobFileListContentSource
. - In class
ClassifierDocumentTypeDetails
, propertiesAzureBlobFileListSource
andAzureBlobSource
have been replaced by a single polymorphic propertyTrainingDataSource
. - In class
ClassifierDocumentTypeDetails
, all constructors have been replaced by a single constructor that takes a polymorphic parametertrainingDataSource
. - In class
ResourceDetails
, renamed propertyCustomNeuralDocumentModelBuilds
toNeuralDocumentModelQuota
. - In class
DocumentClassifierDetails
, renamed propertyApiVersion
toServiceVersion
. - Renamed struct
FontStyle
toDocumentFontStyle
. - Renamed struct
FontWeight
toDocumentFontWeight
. - Renamed class
QuotaDetails
toResourceQuotaDetails
.
Features Added
- In struct
DocumentAnalysisFeature
, added propertiesBarcodes
,KeyValuePairs
, andLanguages
as add-on capabilities. - Added class
DocumentContentSource
as a base class toAzureBlobContentSource
(renamed toBlobContentSource
in this SDK version) andAzureBlobFileListSource
(renamed toBlobFileListContentSource
in this SDK version). - In
DocumentModelAdministrationClient
, added a new overload toBuildDocumentModel
that takes aDocumentContentSource
object. It can be used to build a document model from alternative content sources. - Added property
ServiceVersion
to classesAnalyzeResult
,DocumentModelDetails
,DocumentModelSummary
,OperationDetails
, andOperationSummary
.
Functions extension for Azure Tables 1.2.0 Changelog
Features Added
- Support for binding to library types is now generally available.
Identity 1.10.0-beta.1 Changelog
Features Added
- Continuous Access Evaluation (CAE) is now configurable per-request by setting the
IsCaeEnabled
property ofTokenRequestContext
via its constructor. - Added
IsSupportLoggingEnabled
property toTokenCredentialOptions
which equates to passing ‘true’ for theenablePiiLogging
parameter to the ‘WithLogging’ method on the MSAL client builder.
Bugs Fixed
- Fixed an issue with
TokenCachePersistenceOptions
where credentials in the same process would share the same cache, even if they had different configured names. - ManagedIdentityCredential now ignores empty ClientId values. #37100
- ManagedIdentityCredential will no longer attempt to parse invalid json payloads on responses from the managed identity endpoint.
- When utilizing
EnvironmentCredential
fromDefaultAzureCredential
the credential will now override theTENANT_ID
environment value if the TenantId value is set inDefaultAzureCredentialOptions
.
OpenTelemetry AspNetCore 1.0.0-beta.5 Changelog
Features Added
- Added instrumentation support for Azure SDKs. See Enable Azure SDK Instrumentation for details. (#37505)
- Added
SamplingRatio
property to customize the sampling rate in Azure Monitor Exporter. Note: This package no longer takes dependency on OpenTelemetry.Extensions.AzureMonitor (#36972)
OpenTelemetry AspNetCore 1.0.0-beta.6 Changelog
Features Added
- Added
Resource
to traces, logs, and metrics with default configuration. (#37837) - Added resource detection for
Azure App Service
andAzure Virtual Machine
environment. . (#37837)
OpenTelemetry Exporter 1.0.0-beta.13 Changelog
Features Added
- Added
ApplicationInsightsSampler
to the exporter, enabling users to customize the sampling rate using theSamplingRatio
property. (#36972)
OpenTelemetry Exporter 1.0.0-beta.14 Changelog
Bugs Fixed
- Fixed an issue causing no telemetry if SDK Version string exceeds max length. (#37807)
Breaking Changes
- Location ip on server spans will now be set using
client.address
tag key on activity instead ofhttp.client_ip
. (#37707) - Removing
ServiceVersion.V2020_09_15_Preview
. This is no longer in use and the exporter has already defaulted to the latestServiceVersion.v2_1
. (#37996) - Remove Nullable Annotations from the Exporter’s public API. (#37996)
Resource Management - Compute 1.2.0-beta.2 Changelog
Resource Management - Container Apps 1.1.0-beta.3 Changelog
Resource Management - Container Apps 1.1.0 Changelog
Resource Management - Cosmos DB 1.4.0-beta.3 Changelog
Resource Management - Data Factory 1.0.0-beta.3 Changelog
Resource Management - Data Protection 1.2.0 Changelog
Resource Management - ElasticSan 1.0.0-beta.4 Changelog
Resource Management - Graph Services 1.0.0 Changelog
Resource Management - Maintenance 1.2.0-beta.2 Changelog
Resource Management - Managed Network Fabric 1.0.0 Changelog
Resource Management - Network 1.4.0 Changelog
Resource Management - Paloaltonetworks.Ngfw 1.0.0 Changelog
Resource Management - PostgreSQL 1.2.0-beta.2 Changelog
Resource Management - Resource Manager 1.8.0-beta.1 Changelog
Resource Management - SQL 1.3.0-beta.2 Changelog
Resource Management - Storage Mover 1.1.0-beta.2 Changelog
Schema Registry 1.4.0-beta.2 Changelog
Features Added
- Added
SchemaRegistrySerializer
which serializes using JSON by default.
Service Bus 7.16.0 Changelog
Bugs Fixed
- The
CancellationTokenSource
used by theServiceBusSessionProcessor
in order to renew session locks is now disposed when the session is no longer being processed, thereby preventing a memory leak.
Features Added
ProcessMessageEventArgs
provides aMessageLockLostAsync
event that can be subscribed to in order to be notified when the message lock is lost.ProcessSessionMessageEventArgs
provides aSessionLockLostAsync
event that can be subscribed to in order to be notified when the session lock is lost.- A constructor for
ServiceBusMessage
taking anAmqpAnnotatedMessage
has been added.
Storage - Blobs 12.18.0-beta.1 Changelog
- Added support for service version 2023-05-03 and 2023-08-03.
- Added RehydratePendingToCold value to ArchiveStatus enum.
Storage - Blobs Batch 12.15.0-beta.1 Changelog
- Added support for service version 2023-05-03 and 2023-08-03.
Storage - Blobs ChangeFeed 12.0.0-preview.37 Changelog
- Added support for service version 2023-05-03 and 2023-08-03.
Storage - Common 12.17.0-beta.1 Changelog
- This release contains bug fixes to improve quality.
Storage - Files Data Lake 12.16.0-beta.1 Changelog
- Added support for service version 2023-05-03 and 2023-08-03.
- Added support for paginated directory delete when using AAD authentication. Note that this feature only applies to HNS storage accounts.
Storage - Files Share 12.16.0-beta.1 Changelog
- Added support for service version 2023-05-03 and 2023-08-03.
Storage - Queues 12.16.0-beta.1 Changelog
- This release contains bug fixes to improve quality.
Synapse - Artifacts 1.0.0-preview.18 Changelog
- Added
authenticationType
,containerUri
,sasUri
andsasToken
properties to BlobService - Added
setSystemVariable
proprety to SetVariableActivityTypeProperties - Added
mongoDbAtlasDriverVersion
property to MongoDbAtlasLinkedServiceTypeProperties - Added
ActionOnExistingTargetTable
property for Synapse Link - Added
OutputColumn
Object For Office365Source outputColumns - Added
configurationType
,targetSparkConfiguration
andsparkConfig
properties for SynapseNotebookActivityTypeProperties - Added
credential
property for LinkedService - Added
isolationLevel
property for SQLServerSource - Added new apis of Create/Cancel/GetStatus/GetSnapshot for RunNotebook
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.1.0
$> dotnet add package Azure.Analytics.Synapse.Artifacts --version 1.0.0-preview.18
$> dotnet add package Azure.Communication.JobRouter --version 1.0.0-beta.1
$> dotnet add package Azure.Communication.PhoneNumbers --version 1.2.0-beta.1
$> dotnet add package Azure.Data.SchemaRegistry --version 1.4.0-beta.2
$> dotnet add package Azure.Identity --version 1.10.0-beta.1
$> dotnet add package Azure.Identity.BrokeredAuthentication --version 1.0.0-beta.4
$> dotnet add package Azure.Messaging.EventGrid --version 4.18.0-beta.1
$> dotnet add package Azure.Messaging.ServiceBus --version 7.16.0
$> dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore --version 1.0.0-beta.5
$> dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore --version 1.0.0-beta.6
$> dotnet add package Azure.Monitor.OpenTelemetry.Exporter --version 1.0.0-beta.13
$> dotnet add package Azure.Monitor.OpenTelemetry.Exporter --version 1.0.0-beta.14
$> dotnet add package Azure.ResourceManager --version 1.8.0-beta.1
$> dotnet add package Azure.ResourceManager.AppContainers --version 1.1.0-beta.3
$> dotnet add package Azure.ResourceManager.AppContainers --version 1.1.0
$> dotnet add package Azure.ResourceManager.Compute --version 1.2.0-beta.2
$> dotnet add package Azure.ResourceManager.CosmosDB --version 1.4.0-beta.3
$> dotnet add package Azure.ResourceManager.DataFactory --version 1.0.0-beta.3
$> dotnet add package Azure.ResourceManager.DataProtectionBackup --version 1.2.0
$> dotnet add package Azure.ResourceManager.ElasticSan --version 1.0.0-beta.4
$> dotnet add package Azure.ResourceManager.GraphServices --version 1.0.0
$> dotnet add package Azure.ResourceManager.Maintenance --version 1.2.0-beta.2
$> dotnet add package Azure.ResourceManager.ManagedNetworkFabric --version 1.0.0
$> dotnet add package Azure.ResourceManager.Network --version 1.4.0
$> dotnet add package Azure.ResourceManager.PaloAltoNetworks.Ngfw --version 1.0.0
$> dotnet add package Azure.ResourceManager.PostgreSql --version 1.2.0-beta.2
$> dotnet add package Azure.ResourceManager.Sql --version 1.3.0-beta.2
$> dotnet add package Azure.ResourceManager.StorageMover --version 1.1.0-beta.2
$> dotnet add package Azure.Search.Documents --version 11.5.0-beta.4
$> dotnet add package Azure.Storage.Blobs --version 12.18.0-beta.1
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.15.0-beta.1
$> dotnet add package Azure.Storage.Blobs.ChangeFeed --version 12.0.0-preview.37
$> dotnet add package Azure.Storage.Common --version 12.17.0-beta.1
$> dotnet add package Azure.Storage.Files.DataLake --version 12.16.0-beta.1
$> dotnet add package Azure.Storage.Files.Shares --version 12.16.0-beta.1
$> dotnet add package Azure.Storage.Queues --version 12.16.0-beta.1
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.Tables --version 1.2.0
$> dotnet add package Microsoft.Extensions.Azure --version 1.7.0
Feedback
If you have a bug or feature request for one of the libraries, please file an issue in our repo.