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
-
FeatureFlagConfigurationSetting
andSecretReferenceConfigurationSetting
will 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
FeatureFlagConfigurationSetting
andSecretReferenceConfigurationSetting
instances 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
FeatureFlagConfigurationSetting
andSecretReferenceConfigurationSetting
instances for testing purposes using theConfigurationModelFactory
. It was previously not possible to populate service-owned fields when testing. -
Marked a constructor overload of
ConfigurationSetting
that was intended for testing purposes as non-visible, as theConfigurationModelFactory
should instead be used. -
Fixed a bug where a disposed content stream was used to attempt deserialization in some scenarios, such as using a custom
HttpMessageHandler
that 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
metadata
property toChatParticipant
andChatThreadProperties
. - Add apis to add
ChatParticipant
metadata andChatThreadProperties
metadata. - Add api to update
ChatThreadProperties
including 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-preview
is 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.NotFound
status 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
DynamicData
property types to included heterogeneous arrays of allowed types.
Breaking Changes
- Added the nullability annotation to
NullableResponse<T>.Value
to indicate that it is a nullable type.
Event Grid 4.18.0 Changelog
Breaking Changes
EventGridClient
has 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
Recipient
property toAcsEmailEngagementTrackingReportReceivedEventData
event.
Event Hubs 5.9.3 Changelog
Bugs Fixed
- When using the
EventHubBufferedProducerClient
, events are now instrumented whenEnqueueEventAsync
orEnqueueEventsAsync
is 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
BrowserCustomization
property toInteractiveBrowserCredential
to 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
ManagedIdentityCredential
will 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
AzureChatExtensionsOptions
property onChatCompletionsOptions
. When anAzureChatExtensionsOptions
is provided, configured requests will only work with clients configured to use the Azure OpenAI service, as the capabilities are unique to that service target. AzureChatExtensionsOptions
then hasAzureChatExtensionConfiguration
instances added to itsExtensions
property, with these instances representing the supplementary information needed for Azure OpenAI to use desired data sources to supplement chat completions behavior.ChatChoice
instances on aChatCompletions
response value that used chat extensions will then also have theirMessage
property supplemented by anAzureChatExtensionMessageContext
instance. This context contains a collection of supplementaryMessages
that 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
ObjectDisposedException
when 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.Uri
when 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 theIsDrainModeEnabled
property. 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 theIsDrainModeEnabled
property.
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.