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. RouterJobcan be created and updated with different matching modes:QueueAndMatchMode,ScheduleAndSuspendModeandSuspendMode.- 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
RouterJobin 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
WorkloadIdentityCredentialobjects from the configuration using the"credential": "workloadidentity". Users must provide values for thetenentId,clientId, and newly addedtokenFilePathkeys 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
EventGridClienton top of the latest system events.
Form Recognizer 4.1.0 Changelog
Bugs Fixed
- Fixed a bug where calling the
GetResourceDetailsAPI while targeting service version2022-08-31would throw anArgumentNullException.
Breaking Changes
DocumentAnalysisClientandDocumentModelAdministrationClientnow target service API version2023-07-31by default. Version2023-02-28-previewis not supported anymore.- In struct
DocumentAnalysisFeature, propertiesOcrFormulaandOcrFontwere renamed toFormulasandFontStyling, respectively. - Removed query fields support. The properties
AnalyzeDocumentOptions.QueryFieldsandDocumentAnalysisFeature.QueryFieldsPremiumwere removed. - Removed image extraction support. The class
DocumentImageand the propertyDocumentPage.Imageswere removed. - Removed annotation extraction support. The types
DocumentAnnotation,DocumentAnnotationKind, and the propertyDocumentPage.Annotationswere removed. - Removed struct
DocumentPageKindand propertyDocumentPage.Kind. - Removed property
DocumentKeyValuePair.CommonName. - In
DocumentBarcodeKind, renamed membersQRCode,PDF417,EAN8,EAN13,ITF, andMicroQRCodetoQrCode,Pdf417,Ean8,Ean13,Itf, andMicroQrCode, respectively. - Renamed class
AzureBlobContentSourcetoBlobContentSource. - Renamed class
AzureBlobFileListSourcetoBlobFileListContentSource. - In class
ClassifierDocumentTypeDetails, propertiesAzureBlobFileListSourceandAzureBlobSourcehave 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 propertyCustomNeuralDocumentModelBuildstoNeuralDocumentModelQuota. - In class
DocumentClassifierDetails, renamed propertyApiVersiontoServiceVersion. - Renamed struct
FontStyletoDocumentFontStyle. - Renamed struct
FontWeighttoDocumentFontWeight. - Renamed class
QuotaDetailstoResourceQuotaDetails.
Features Added
- In struct
DocumentAnalysisFeature, added propertiesBarcodes,KeyValuePairs, andLanguagesas add-on capabilities. - Added class
DocumentContentSourceas a base class toAzureBlobContentSource(renamed toBlobContentSourcein this SDK version) andAzureBlobFileListSource(renamed toBlobFileListContentSourcein this SDK version). - In
DocumentModelAdministrationClient, added a new overload toBuildDocumentModelthat takes aDocumentContentSourceobject. It can be used to build a document model from alternative content sources. - Added property
ServiceVersionto 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
IsCaeEnabledproperty ofTokenRequestContextvia its constructor. - Added
IsSupportLoggingEnabledproperty toTokenCredentialOptionswhich equates to passing ‘true’ for theenablePiiLoggingparameter to the ‘WithLogging’ method on the MSAL client builder.
Bugs Fixed
- Fixed an issue with
TokenCachePersistenceOptionswhere 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
EnvironmentCredentialfromDefaultAzureCredentialthe credential will now override theTENANT_IDenvironment 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
SamplingRatioproperty 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
Resourceto traces, logs, and metrics with default configuration. (#37837) - Added resource detection for
Azure App ServiceandAzure Virtual Machineenvironment. . (#37837)
OpenTelemetry Exporter 1.0.0-beta.13 Changelog
Features Added
- Added
ApplicationInsightsSamplerto the exporter, enabling users to customize the sampling rate using theSamplingRatioproperty. (#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.addresstag 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
SchemaRegistrySerializerwhich serializes using JSON by default.
Service Bus 7.16.0 Changelog
Bugs Fixed
- The
CancellationTokenSourceused by theServiceBusSessionProcessorin order to renew session locks is now disposed when the session is no longer being processed, thereby preventing a memory leak.
Features Added
ProcessMessageEventArgsprovides aMessageLockLostAsyncevent that can be subscribed to in order to be notified when the message lock is lost.ProcessSessionMessageEventArgsprovides aSessionLockLostAsyncevent that can be subscribed to in order to be notified when the session lock is lost.- A constructor for
ServiceBusMessagetaking anAmqpAnnotatedMessagehas 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,sasUriandsasTokenproperties to BlobService - Added
setSystemVariableproprety to SetVariableActivityTypeProperties - Added
mongoDbAtlasDriverVersionproperty to MongoDbAtlasLinkedServiceTypeProperties - Added
ActionOnExistingTargetTableproperty for Synapse Link - Added
OutputColumnObject For Office365Source outputColumns - Added
configurationType,targetSparkConfigurationandsparkConfigproperties for SynapseNotebookActivityTypeProperties - Added
credentialproperty for LinkedService - Added
isolationLevelproperty 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.