Azure SDK for .NET (September 2023)
The Azure SDK team is pleased to announce our September 2023 client library releases.
55 packages released this month.
Stable Packages (24)
-
Confidential Ledger
-
Core - Client - Core
-
Event Grid
-
Functions extension for Azure Tables
-
Identity
-
Resource Management - Compute
-
Resource Management - Container Apps
-
Resource Management - IoT Hub
-
Resource Management - Marketplace
-
Resource Management - Mobile Network
-
Resource Management - NetApp Files
-
Resource Management - Network
-
Resource Management - Network Cloud
-
Resource Management - Recovery Services
-
Resource Management - Recovery Services Backup
-
Storage - Blobs
-
Storage - Blobs Batch
-
Storage - Common
-
Storage - Files Data Lake
-
Storage - Files Share
-
Storage - Queues
-
WebJobs Extensions - Event Hubs
-
WebJobs Extensions - Service Bus
-
WebJobs Extensions - Web PubSub
Patch Updates (7)
-
App Configuration
-
Communication Email
-
Event Hubs
-
Event Hubs - Event Processor
-
Identity
-
Service Bus
-
Tables
Beta Packages (19)
-
Azure Communication JobRouter
-
Communication Call Automation
-
Communication Chat
-
Communication Phone Numbers
-
OpenAI Inference
-
Resource Management - Apicenter
-
Resource Management - App Service
-
Resource Management - Communication
-
Resource Management - Compute
-
Resource Management - Defendereasm
-
Resource Management - Hdinsight.Containers
-
Resource Management - IoT Hub
-
Resource Management - Maintenance
-
Resource Management - Network
-
Resource Management - Resourceconnector
-
Resource Management - Resources
-
Resource Management - Security
-
Resource Management - Storage
-
Storage - Blobs ChangeFeed
Release highlights
App Configuration 1.2.1 Changelog
Bugs Fixed
-
FeatureFlagConfigurationSettingandSecretReferenceConfigurationSettingwill now retain custom attributes in the setting value. Previously, only attributes that were defined in the associated JSON schema were allowed and unknown attributes were discarded. -
Added the ability to create
FeatureFlagConfigurationSettingandSecretReferenceConfigurationSettinginstances with an ETag, matchingConfigurationSetting. This allows all setting types to use the GetConfigurationSettingAsync overload that acceptsonlyIfUnchanged.Previously, this was not possible for specialized settings types. -
Added the ability to create
FeatureFlagConfigurationSettingandSecretReferenceConfigurationSettinginstances for testing purposes using theConfigurationModelFactory. It was previously not possible to populate service-owned fields when testing. -
Marked a constructor overload of
ConfigurationSettingthat was intended for testing purposes as non-visible, as theConfigurationModelFactoryshould instead be used. -
Fixed a bug where a disposed content stream was used to attempt deserialization in some scenarios, such as using a custom
HttpMessageHandlerthat returnsStringContent.
Azure Communication JobRouter 1.0.0-beta.2 Changelog
Bugs Fixed
- Added getters for ScoringRuleOptions, ScoringRule in BestWorkerMode, FunctionUri in FunctionRouterRule, AppKey, ClientId and FunctionKey in FunctionRouterRuleCredential, and ExpiresAfter in PassThroughWorkerSelectorAttachment
Azure Communication JobRouter 1.0.0-beta.3 Changelog
Bugs Fixed
- Added getter for ScoringParameters in ScoringRuleOptions
Communication Call Automation 1.1.0-beta.1 Changelog
Features Added
- Play and recognize supports TTS and SSML source prompts.
- Recognize supports choices and freeform speech.
- Start/Stop continuous DTMF recognition by subscribing/unsubscribing to tones.
- Send DTMF tones to a participant in the call.
- Mute participants in the call.
Communication Chat 1.2.0-beta.1 Changelog
Features Added
- Add
metadataproperty toChatParticipantandChatThreadProperties. - Add apis to add
ChatParticipantmetadata andChatThreadPropertiesmetadata. - Add api to update
ChatThreadPropertiesincluding metadata.
Communication Email 1.0.1 Changelog
Other Changes
- Improve memory management for attachment handling
Communication Phone Numbers 1.3.0-beta.1 Changelog
Features Added
- Number Lookup API public preview
- API version
2023-05-01-previewis the default
Communication Phone Numbers 1.3.0-beta.2 Changelog
Bugs Fixed
- Service version updated to include 2023-05-01-preview
- Default to latest public version
Confidential Ledger 1.2.0 Changelog
Bugs Fixed
- Service calls that result in a
HttpStatusCode.NotFoundstatus will now be retried by default. This is to handle scenarios where there is an unexpected loss of session stickiness when the connected node changes and transactions have not been fully replicated.
Core - Client - Core 1.35.0 Changelog
Features Added
- Expand the set of supported
DynamicDataproperty types to included heterogeneous arrays of allowed types.
Breaking Changes
- Added the nullability annotation to
NullableResponse<T>.Valueto indicate that it is a nullable type.
Event Grid 4.18.0 Changelog
Breaking Changes
EventGridClienthas been removed for the stable release. It will be included in a subsequent release.
Features Added
- Added new system events for Event Grid and App Configuration.
- Added
Recipientproperty toAcsEmailEngagementTrackingReportReceivedEventDataevent.
Event Hubs 5.9.3 Changelog
Bugs Fixed
- When using the
EventHubBufferedProducerClient, events are now instrumented whenEnqueueEventAsyncorEnqueueEventsAsyncis called, rather than when the event is published. This ensures that the instrumentation is accurate when the event is published, regardless of whether the event is published immediately or buffered for a period of time.
Event Hubs - Event Processor 5.9.3 Changelog
Other Changes
-
Several improvements to logging have been made to capture additional context and fix typos. Most notable among them is the inclusion of starting and ending sequence numbers when events are read from Event Hubs and dispatched for processing.
-
The reference for the AMQP transport library,
Microsoft.Azure.Amqp, has been bumped to 2.6.3. This fixes an issue with timeout duration calculations during link creation and includes several efficiency improvements.
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 Changelog
Features Added
- Added
BrowserCustomizationproperty toInteractiveBrowserCredentialto enable web view customization for interactive authentication.
Bugs Fixed
- ManagedIdentityCredential will no longer attempt to parse invalid json payloads on responses from the managed identity endpoint.
- Fixed an issue where AzurePowerShellCredential fails to parse the token response from Azure PowerShell. #22638
Identity 1.10.1 Changelog
Bugs Fixed
ManagedIdentityCredentialwill fall through to the next credential in the chain in the case that Docker Desktop returns a 403 response when attempting to access the IMDS endpoint. #38218- Fixed an issue where interactive credentials would still prompt on the first GetToken request even when the cache is populated and an AuthenticationRecord is provided. #38431
OpenAI Inference 1.0.0-beta.7 Changelog
Features Added
- The Azure OpenAI “using your own data” feature is now supported. See the Azure OpenAI using your own data quickstart for conceptual background and detailed setup instructions.
- Azure OpenAI chat extensions are configured via a new
AzureChatExtensionsOptionsproperty onChatCompletionsOptions. When anAzureChatExtensionsOptionsis provided, configured requests will only work with clients configured to use the Azure OpenAI service, as the capabilities are unique to that service target. AzureChatExtensionsOptionsthen hasAzureChatExtensionConfigurationinstances added to itsExtensionsproperty, with these instances representing the supplementary information needed for Azure OpenAI to use desired data sources to supplement chat completions behavior.ChatChoiceinstances on aChatCompletionsresponse value that used chat extensions will then also have theirMessageproperty supplemented by anAzureChatExtensionMessageContextinstance. This context contains a collection of supplementaryMessagesthat describe the behavior of extensions that were used and supplementary response data, such as citations, provided along with the response.- See the README sample snippet for a simplified example of request/response use with “using your own data”
Resource Management - Apicenter 1.0.0-beta.1 Changelog
Resource Management - App Service 1.1.0-beta.2 Changelog
Resource Management - App Service 1.1.0-beta.3 Changelog
Resource Management - Communication 1.2.0-beta.2 Changelog
Resource Management - Compute 1.2.0-beta.3 Changelog
Resource Management - Compute 1.2.0 Changelog
Resource Management - Container Apps 1.1.0 Changelog
Resource Management - Defendereasm 1.0.0-beta.1 Changelog
Resource Management - Hdinsight.Containers 1.0.0-beta.1 Changelog
Resource Management - IoT Hub 1.1.0-beta.2 Changelog
Resource Management - IoT Hub 1.1.0 Changelog
Resource Management - Maintenance 1.2.0-beta.3 Changelog
Resource Management - Maintenance 1.2.0-beta.4 Changelog
Resource Management - Marketplace 1.1.0 Changelog
Resource Management - Mobile Network 1.0.0 Changelog
Resource Management - NetApp Files 1.3.0 Changelog
Resource Management - Network 1.5.0-beta.1 Changelog
Resource Management - Network 1.5.0 Changelog
Resource Management - Network Cloud 1.0.0 Changelog
Resource Management - Recovery Services 1.1.0 Changelog
Resource Management - Recovery Services Backup 1.1.0 Changelog
Resource Management - Resourceconnector 1.0.0-beta.1 Changelog
Resource Management - Resources 1.7.0-beta.1 Changelog
Resource Management - Security 1.2.0-beta.3 Changelog
Resource Management - Storage 1.2.0-beta.2 Changelog
Service Bus 7.16.1 Changelog
Bugs Fixed
- Fixed race condition that could lead to an
ObjectDisposedExceptionwhen using theServiceBusSessionProcessor.
Storage - Blobs 12.18.0 Changelog
- Includes all features from 12.18.0-beta.1.
Storage - Blobs Batch 12.15.0 Changelog
- Includes all features from 12.15.0-beta.1.
Storage - Blobs ChangeFeed 12.0.0-preview.38 Changelog
- This release contains bug fixes to improve quality.
Storage - Common 12.17.0 Changelog
- Includes all features from 12.17.0-beta.1.
Storage - Files Data Lake 12.16.0 Changelog
- Includes all features from 12.16.0-beta.1.
Storage - Files Share 12.16.0 Changelog
- Includes all features from 12.16.0-beta.1.
Storage - Queues 12.16.0 Changelog
- Includes all features from 12.16.0-beta.1.
Tables 12.8.1 Changelog
Bugs Fixed
- Fixed the URL returned by
TableClient.Uriwhen connecting to Azurite
WebJobs Extensions - Event Hubs 5.5.0 Changelog
Bugs Fixed
- When binding to a
CancellationToken, the token will no longer be signaled when in Drain Mode. To detect if the function app is in Drain Mode, use dependency injection to inject theIDrainModeManager, and check theIsDrainModeEnabledproperty. Additionally, checkpointing will now occur when the function app is in Drain Mode.
WebJobs Extensions - Event Hubs 6.0.0 Changelog
Breaking Changes
- The default batch size has changed to 100 events. Previously, the default batch size was 10.
This setting represents the maximum number of events from Event Hubs that the function can receive when it’s invoked. The decision to change the default was based on developer feedback, testing, and a desire to match the defaults used by the Azure SDK for Event Hubs. This change will be beneficial to the average scenario by helping to improve performance as well as lower costs due to fewer function executions.
We recommend testing to ensure no breaking changes are introducing to your function app before updating existing applications to version 6.0.0 or newer of the Event Hubs extension, especially if you have code code that was written to expect 10 as the max event batch size.
WebJobs Extensions - Service Bus 5.12.0 Changelog
Bugs Fixed
- When binding to a
CancellationToken, the token will no longer be signaled when in Drain Mode. To detect if the function app is in Drain Mode, use dependency injection to inject theIDrainModeManager, and check theIsDrainModeEnabledproperty.
WebJobs Extensions - Web PubSub 1.7.0 Changelog
Bugs Fixed
- Fix multi request origins validation.
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.OpenAI --version 1.0.0-beta.7
$> dotnet add package Azure.Communication.CallAutomation --version 1.1.0-beta.1
$> dotnet add package Azure.Communication.Chat --version 1.2.0-beta.1
$> dotnet add package Azure.Communication.Email --version 1.0.1
$> dotnet add package Azure.Communication.JobRouter --version 1.0.0-beta.2
$> dotnet add package Azure.Communication.JobRouter --version 1.0.0-beta.3
$> dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0-beta.1
$> dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0-beta.2
$> dotnet add package Azure.Core --version 1.35.0
$> dotnet add package Azure.Data.AppConfiguration --version 1.2.1
$> dotnet add package Azure.Data.Tables --version 12.8.1
$> dotnet add package Azure.Identity --version 1.10.0
$> dotnet add package Azure.Identity --version 1.10.1
$> dotnet add package Azure.Messaging.EventGrid --version 4.18.0
$> dotnet add package Azure.Messaging.EventHubs --version 5.9.3
$> dotnet add package Azure.Messaging.EventHubs.Processor --version 5.9.3
$> dotnet add package Azure.Messaging.ServiceBus --version 7.16.1
$> dotnet add package Azure.ResourceManager.ApiCenter --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.AppContainers --version 1.1.0
$> dotnet add package Azure.ResourceManager.AppService --version 1.1.0-beta.2
$> dotnet add package Azure.ResourceManager.AppService --version 1.1.0-beta.3
$> dotnet add package Azure.ResourceManager.Communication --version 1.2.0-beta.2
$> dotnet add package Azure.ResourceManager.Compute --version 1.2.0-beta.3
$> dotnet add package Azure.ResourceManager.Compute --version 1.2.0
$> dotnet add package Azure.ResourceManager.DefenderEasm --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.HDInsight.Containers --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.IotHub --version 1.1.0-beta.2
$> dotnet add package Azure.ResourceManager.IotHub --version 1.1.0
$> dotnet add package Azure.ResourceManager.Maintenance --version 1.2.0-beta.3
$> dotnet add package Azure.ResourceManager.Maintenance --version 1.2.0-beta.4
$> dotnet add package Azure.ResourceManager.Marketplace --version 1.1.0
$> dotnet add package Azure.ResourceManager.MobileNetwork --version 1.0.0
$> dotnet add package Azure.ResourceManager.NetApp --version 1.3.0
$> dotnet add package Azure.ResourceManager.Network --version 1.5.0-beta.1
$> dotnet add package Azure.ResourceManager.Network --version 1.5.0
$> dotnet add package Azure.ResourceManager.NetworkCloud --version 1.0.0
$> dotnet add package Azure.ResourceManager.RecoveryServices --version 1.1.0
$> dotnet add package Azure.ResourceManager.RecoveryServicesBackup --version 1.1.0
$> dotnet add package Azure.ResourceManager.ResourceConnector --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.Resources --version 1.7.0-beta.1
$> dotnet add package Azure.ResourceManager.SecurityCenter --version 1.2.0-beta.3
$> dotnet add package Azure.ResourceManager.Storage --version 1.2.0-beta.2
$> dotnet add package Azure.Security.ConfidentialLedger --version 1.2.0
$> dotnet add package Azure.Storage.Blobs --version 12.18.0
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.15.0
$> dotnet add package Azure.Storage.Blobs.ChangeFeed --version 12.0.0-preview.38
$> dotnet add package Azure.Storage.Common --version 12.17.0
$> dotnet add package Azure.Storage.Files.DataLake --version 12.16.0
$> dotnet add package Azure.Storage.Files.Shares --version 12.16.0
$> dotnet add package Azure.Storage.Queues --version 12.16.0
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.5.0
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 6.0.0
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.ServiceBus --version 5.12.0
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.Tables --version 1.2.0
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.WebPubSub --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.