Azure SDK for .NET (February 2025)
The Azure SDK team is pleased to announce our February 2025 client library releases.
49 packages released this month.
Stable Packages (18)
-
Azure client library integration for ASP.NET Core
-
Blob Storage Key Store for .NET Data Protection
-
Communication Phone Numbers
-
Container Registry
-
Core - Client - Core
-
Data Movement
-
Data Movement - Blobs
-
Data Movement - Files Shares
-
Event Grid
-
Key Encryptor for .NET Data Protection
-
Resource Management - App Configuration
-
Resource Management - Computeschedule
-
Resource Management - Data Protection
-
Resource Management - Iotoperations
-
Resource Management - Kusto
-
Resource Management - Network Cloud
-
Secrets Configuration Provider for .NET
-
System.ClientModel
Patch Updates (6)
-
Event Hubs
-
Event Hubs - Event Processor
-
Functions extension for Blob Storage
-
Functions extension for Storage Queues
-
Load Testing
-
Service Bus
Beta Packages (25)
-
AI Foundry
-
AI Model Inference
-
Communication Call Automation
-
Communication Messages
-
Confidential Ledger
-
Conversational Language Understanding
-
Event Hubs
-
Event Hubs - Event Processor
-
Identity
-
OpenAI Inference
-
Resource Management - Container Registry
-
Resource Management - Data Protection
-
Resource Management - Device Registry
-
Resource Management - Monitor
-
Resource Management - Network
-
Resource Management - Nginx
-
Resource Management - Quota
-
Resource Management - Service Networking
-
Storage - Blobs
-
Storage - Blobs Batch
-
Storage - Blobs ChangeFeed
-
Storage - Common
-
Storage - Files Data Lake
-
Storage - Files Share
-
Storage - Queues
Release highlights
AI Foundry 1.0.0-beta.3 Changelog
Bugs Fixed
- Fixed the bug preventing addition of a single Azure blob URI to the VectorStore.
- Fixed deserialization of Run Step when the file search is used issue.
- Fixed the issue preventing using streaming with function tools issue.
AI Model Inference 1.0.0-beta.3 Changelog
Bugs Fixed
- Fixed an issue where
usage
wasn’t being properly included in chat responses.
Breaking Changes
ChatCompletionsResponseFormatJSON
has been renamed toChatCompletionsResponseFormatJsonObject
.
Features Added
- Added new
ImageEmbeddingsClient
, to provide support for generating embeddings with model input. See sample for more information. - Added support for Chat Completions with audio input, for supported models.
- Added support for Chat Completions with structured output.
- Added support for providing a “Developer” message to models which support it.
Azure client library integration for ASP.NET Core 1.10.0 Changelog
Other Changes
- Updated dependencies to ensure they are up-to-date with the latest targets and trimming from built-in dependencies.
Blob Storage Key Store for .NET Data Protection 1.5.0 Changelog
Other Changes
- Updated dependencies to ensure they are up-to-date with the latest targets and trimming from built-in dependencies.
Communication Call Automation 1.4.0-beta.2 Changelog
Bugs Fixed
- Media streaming with AudioFormat default Pcm24kMono is removed and changed to null if AudioFormat is not passed.
Communication Messages 1.2.0-beta.1 Changelog
Features Added
- Added Interactive Message.
- Added Reaction Message.
- Added Sticker Message.
- Exposed
JsonModelWriteCore
for model serialization procedure.
Communication Phone Numbers 1.3.0 Changelog
Features Added
- GA release of Number Insight.
- API version
(2025-02-11)
is the default
Bugs Fixed
- OperatorDetails.Name is now optional in OperatorInformation Response.
Confidential Ledger 1.4.1-beta.1 Changelog
Features Added
- Added the ability to list users and roles.
Container Registry 1.2.0 Changelog
Other Changes
- Updated dependencies to ensure they are up-to-date with the latest targets and trimming from built-in dependencies.
Conversational Language Understanding 2.0.0-beta.2 Changelog
Features Added
- Added three differenct type of Redaction Policy
CharacterMaskPolicyType
,EntityMaskTypePolicyType
andNoMaskPolicyType
for the functionAnalyzeConversations
- Added support for analyze-conversation API Versions
- 2024-11-01
- 2024-11-15-preview
Core - Client - Core 1.45.0 Changelog
Features Added
- Added
MexicoCentral
andSpainCentral
locations toAzureLocation
struct. This was a community contribution, courtesy of jerobado. (#47862)
Bugs Fixed
- Fixed an issue where
BearerTokenAuthenticationPolicy
throwsArgumentOutOfRangeException
if theExpiresOn
property of the token is the default value. (#47040)
Data Movement 12.0.0 Changelog
Breaking Changes
- Removed
DataTransferProperty
andDataTransferProperty<T>
- Renamed the following types/properties:
DataTransfer
->TransferOperation
- Addtionally renamed the
TransferStatus
property toStatus
DataTransferEventArgs
->TransferEventArgs
DataTransferOptions
->TransferOptions
DataTransferOrder
->TransferOrder
DataTransferProgress
->TransferProgress
DataTransferProperties
->TransferProperties
DataTransferState
->TransferState
DataTransferStatus
->TransferStatus
DataTransferErrorMode
->TransferErrorMode
ProgressHandlerOptions
->TransferProgressHandlerOptions
- Also removed the constructor since properties are settable.
StorageResourceCheckpointData
->StorageResourceCheckpointDetails
StorageResource.GetDestinationCheckpointData
->StorageResource.GetDestinationCheckpointDetails
StorageResource.GetSourceCheckpointData
->StorageResource.GetSourceCheckpointDetails
TransferProperties.DestinationCheckpointData
->TransferProperties.DestinationCheckpointDetails
TransferProperties.SourceCheckpointData
->TransferProperties.SourceCheckpointDetails
StorageResourceCreationPreference
->StorageResourceCreateMode
TransferManager.PauseTransferIfRunningAsync
->TransferManager.PauseTransferAsync
TransferManagerOptions.ErrorHandling
->TransferManagerOptions.ErrorMode
TransferManagerOptions.CheckpointerOptions
->TransferManagerOptions.CheckpointStoreOptions
TransferItemCompletedEventArgs.SourceResource
->TransferItemCompletedEventArgs.Source
andTransferItemCompletedEventArgs.DestinationResource
->TransferItemCompletedEventArgs.Destination
TransferItemFailedEventArgs.SourceResource
->TransferItemFailedEventArgs.Source
andTransferItemFailedEventArgs.DestinationResource
->TransferItemFailedEventArgs.Destination
TransferItemSkippedEventArgs.SourceResource
->TransferItemSkippedEventArgs.Source
andTransferItemSkippedEventArgs.DestinationResource
->TransferItemSkippedEventArgs.Destination
TransferCheckpointStoreOptions.Local
->TransferCheckpointStoreOptions.CreateLocalStore
TransferCheckpointStoreOptions.Disabled
->TransferCheckpointStoreOptions.DisableCheckpoint
- Renamed
TransferOptions.CreationPreference
toTransferOptions.CreateMode
- Removed properties from
StorageResourceItemProperties
constructor since properties are settable. - Changed type of
StorageResourceItemProperties.RawProperties
toIDictionary
. - Changed
List<StorageResourceProvider> TransferManagerOptions.ResumeProviders
toIList<StorageResourceProvider> TransferManagerOptions.ProvidersForResuming
- Changed the following
LocalFilesStorageResourceProvider
methods tostatic
methods: FromFile(string)
FromDirectory(string)
Bugs Fixed
- Fixed bug where adding multiple transfers in parallel could cause a collision (
InvalidOperationException
) in the data transfers stored within theTransferManager
.
Data Movement - Blobs 12.0.0 Changelog
Breaking Changes
- Changed
BlobStorageResourceContainerOptions.BlobType
type fromDataTransferProperty<BlobType>
toBlobType
- Changed
BlobStorageResourceOptions.Metadata
type fromDataTransferProperty<IDictionary<string, string>>
toIDictionary<string, string>
- Changed the following types from
DataTranferProperty<string>
tostring
BlobStorageResourceOptions.ContentType
BlobStorageResourceOptions.ContentLanguage
BlobStorageResourceOptions.ContentEncoding
BlobStorageResourceOptions.ContentDisposition
BlobStorageResourceOptions.CacheControl
- Renamed
BlobStorageResourceContainerOptions.BlobDirectoryPrefix
toBlobPrefix
- Changed
BlobContainerClient.StartUploadDirectoryAsync
toBlobContainerClient.UploadDirectoryAsync
and added a requiredwaitUntil
parameter. - Changed
BlobContainerClient.StartDownloadToDirectoryAsync
toBlobContainerClient.DownloadToDirectoryAsync
and added a requiredwaitUntil
parameter. - Several refactors to
BlobsStorageResourceProvider
: - Removed nested delegates
GetStorageSharedKeyCredential
,GetTokenCredential
, andGetAzureSasCredential
. - Removed default constructor.
- Removed constructor overload for
GetTokenCredential
entirely. - Changed constructor overloads for
GetStorageSharedKeyCredential
andGetAzureSasCredential
to useFunc
. These callbacks are also now async, returning aValueTask
, and thereadOnly
parameter was removed. - Changed
FromBlob
andFromContainer
to async, returning aValueTask
, and renamed toFromBlobAsync
andFromContainerAsync
respectively. - Changed
FromClient
methods tostatic
methods.
Data Movement - Files Shares 12.0.0 Changelog
Breaking Changes
- Changed
ShareFileStorangeResourceOptions.FilePermissions
fromDataTransferProperty
tobool?
- Changed the following types from
DataTranferProperty<string>
tostring
ShareFileStorageResourceOptions.ContentType
ShareFileStorageResourceOptions.ContentDisposition
ShareFileStorageResourceOptions.CacheControl
- Changed the following types from
DataTransferProperty<string[]>
tostring[]
ShareFileStorageResourceOptions.ContentEncoding
ShareFileStorageResourceOptions.ContentLanguage
- Changed the following types from
DataTransferProperty<IDictionary<string, string>>
toIDictionary<string, string>
ShareFileStorageResourceOptions.FileMetadata
ShareFileStorageResourceOptions.DirectoryMetadata
- Changed the following types from
DataTransferProperty<DateTimeOffset?>
toDateTimeOffset?
ShareFileStorageResourceOptions.FileCreatedOn
ShareFileStorageResourceOptions.FileLastWrittenOn
ShareFileStorageResourceOptions.FileChangedOn
- Changed
ShareDirectoryClient.StartUploadDirectoryAsync
toShareDirectoryClient.UploadDirectoryAsync
and added a requiredwaitUntil
parameter. - Changed
ShareDirectoryClient.StartDownloadToDirectoryAsync
toShareDirectoryClient.DownloadToDirectoryAsync
and added a requiredwaitUntil
parameter. - Several refactors to
ShareFilesStorageResourceProvider
: - Removed nested delegates
GetStorageSharedKeyCredential
,GetTokenCredential
, andGetAzureSasCredential
. - Removed default constructor.
- Removed constructor overload for
GetTokenCredential
entirely. - Changed constructor overloads for
GetStorageSharedKeyCredential
andGetAzureSasCredential
to useFunc
. These callbacks are also now async, returning aValueTask
, and thereadOnly
parameter was removed. - Changed
FromFile
andFromDirectory
to async, returning aValueTask
, and renamed toFromFileAsync
andFromDirectoryAsync
respectively. - Changed
FromClient
methods tostatic
methods.
Bugs Fixed
- Fixed File Attributes with ReadOnly does not transfer / copy correctly bug #2167
Event Grid 4.29.0 Changelog
Features Added
- Added
RecipientMailServerHostName
property toAcsEmailDeliveryReportStatusDetails
. - Added
InternetMessageId
property toAcsEmailDeliveryReportReceivedEventData
event. - Added
SegmentCount
property toAcsSmsReceivedEventData
event.
Event Hubs 5.12.0-beta.2 Changelog
Bugs Fixed
-
Querying runtime data and other management operations will now correctly guards against the race condition where an AMQP link is in the process of closing as the operation attempts to use it. These errors will now properly be classified as retriable as they are for producer and consumer operations.
-
Fixed an obscure edge case in the
EventHubBufferedProducer
client where an obscure race condition when flushing/enqueuing events concurrently with disposing the producer could cause a semaphore to be released inappropriately. This error superseded theTaskCanceledException
that should have been surfaced.
Features Added
- Support for the Event Hubs geographic data replication feature has been enabled. Checking for whether or not this feature is enabled for your namespace can be done by querying for Event Hub properties using
EventHubProducerClient
orEventHubConsumerClient
and referencing the theIsGeoReplicationEnabled
property of the result.
As part of this feature, the type of offset-related data has been changed from long
to string
to align with changes to the Event Hubs service API. To preserve backwards compatibility, the existing offset-related members have not been changed, and new members with names similar to OffsetString
and string-based parameters for method overloads have been introduced.
The long-based offset members will continue to work for Event Hubs namespaces that do not have GeoDR replication enabled, but are discouraged for use and have been marked as obsolete.
Obsoleted properties:
EventData.Offset
LastEnqueuedEventProperties.Offset
PartitionProperties.LastEnqueuedOffset
Obsoleted method overloads:
- EventPosition.FromOffset
- EventHubsModelFactory.EventData
- BlobCheckpointStore.UpdateCheckpointAsync
- EventProcessorClient.UpdateCheckpointAsync
Event Hubs 5.11.6 Changelog
Bugs Fixed
- Fixed an obscure edge case in the
EventHubBufferedProducer
client where an obscure race condition when flushing/enqueuing events concurrently with disposing the producer could cause a semaphore to be released inappropriately. This error superseded theTaskCanceledException
that should have been surfaced.
Event Hubs - Event Processor 5.12.0-beta.2 Changelog
Features Added
- Support for the Event Hubs geographic data replication feature has been enabled. Checking for whether or not this feature is enabled for your namespace can be done by querying for Event Hub properties using
EventHubProducerClient
orEventHubConsumerClient
and referencing the theIsGeoReplicationEnabled
property of the result.
As part of this feature, the type of offset-related data has been changed from long
to string
to align with changes to the Event Hubs service API. To preserve backwards compatibility, the existing offset-related members have not been changed, and new members with names similar to OffsetString
and string-based parameters for method overloads have been introduced.
The long-based offset members will continue to work for Event Hubs namespaces that do not have GeoDR replication enabled, but are discouraged for use and have been marked as obsolete.
Obsoleted properties:
EventData.Offset
LastEnqueuedEventProperties.Offset
PartitionProperties.LastEnqueuedOffset
Obsoleted method overloads:
- EventPosition.FromOffset
- EventHubsModelFactory.EventData
- BlobCheckpointStore.UpdateCheckpointAsync
- EventProcessorClient.UpdateCheckpointAsync
Event Hubs - Event Processor 5.11.6 Changelog
Other Changes
- Bump
Azure.Messaging.EventHubs
dependency to 5.11.6, which includes bumps to several transitive dependencies.
Functions extension for Blob Storage 5.3.4 Changelog
Other Changes
- This release contains bug fixes to improve quality.
Functions extension for Storage Queues 5.3.4 Changelog
Bugs Fixed
- Fixed bug where calling StopAsync in QueueListener while drain mode was enabled would cancel the execution cancellation token.
- Fixed bug where the cancellation token passed to QueueListener.ProcessMessageAsync was being propagated to the QueueProcessor.CompleteProcessingMessageAsync call. Since this token is always canceled when QueueListener.StopAsync is invoked, it caused messages to be processed but not deleted.
Identity 1.14.0-beta.1 Changelog
Features Added
- Added a
Subscription
property toAzureCliCredentialOptions
to allow specifying the Azure subscription ID or name to use when authenticating with the Azure CLI.
Bugs Fixed
- Null or empty responses from IMDS probe attempts will now fall through to the next credential in the chain (#47844)
Key Encryptor for .NET Data Protection 1.4.0 Changelog
Other Changes
- Updated dependencies to ensure they are up-to-date with the latest targets and trimming from built-in dependencies.
Load Testing 1.0.2 Changelog
Other Changes
- Add NOT_VALIDATED to the list of terminal states for the file validation poller.
OpenAI Inference 2.2.0-beta.1 Changelog
Breaking Changes
- Batch: files uploaded for batch operations (
UploadFile
withFileUploadPurpose.Batch
) will now report astatus
ofprocessed
, matching expected behavior against OpenAI’s/v1
endpoint. This is a change from past behavior where such files would initially reportpending
and a laterprocessed
,error
, or other status depending on operation progress. Batch input validation is instead consistently performed from the batch client.
Resource Management - App Configuration 1.4.0 Changelog
Resource Management - Computeschedule 1.0.0 Changelog
Resource Management - Container Registry 1.3.0-beta.2 Changelog
Resource Management - Data Protection 1.6.0-beta.1 Changelog
Resource Management - Data Protection 1.6.0 Changelog
Resource Management - Device Registry 1.0.0-beta.2 Changelog
Resource Management - Iotoperations 1.0.0 Changelog
Resource Management - Kusto 1.6.0 Changelog
Resource Management - Monitor 1.4.0-beta.2 Changelog
Resource Management - Network 1.11.0-beta.1 Changelog
Resource Management - Network Cloud 1.1.0 Changelog
Resource Management - Nginx 1.1.0-beta.3 Changelog
Resource Management - Quota 1.1.0-beta.3 Changelog
Resource Management - Service Networking 1.1.0-beta.1 Changelog
Secrets Configuration Provider for .NET 1.4.0 Changelog
Other Changes
- Updated dependencies to ensure they are up-to-date with the latest targets and trimming from built-in dependencies.
Service Bus 7.18.4 Changelog
Bugs Fixed
-
Fixed an issue with the
AmqpReceiver
class where a drain failure during aReceiveMessagesAsync
operation would cause message ordering to be violated. (#47822) -
Fixed an issue where an error response from the Service Bus administration service without a body was incorrectly parsed, resulting in a null argument exception obscuring the actual failure response. (#47517)
Storage - Blobs 12.24.0-beta.1 Changelog
Features Added
- Added support for service version 2025-05-05.
Storage - Blobs Batch 12.21.0-beta.1 Changelog
Features Added
- Added support for service version 2025-05-05.
Storage - Blobs ChangeFeed 12.0.0-preview.53 Changelog
Features Added
- Added support for service version 2025-05-05.
Storage - Common 12.23.0-beta.1 Changelog
Features Added
- This release contains bug fixes to improve quality.
Storage - Files Data Lake 12.22.0-beta.1 Changelog
Features Added
- Added support for service version 2025-05-05.
Storage - Files Share 12.22.0-beta.1 Changelog
Breaking Changes
- The following APIs no longer send the x-ms-file-permission-key, x-ms-file-attributes, x-ms-file-creation-time, and x-ms-file-last-write-time request headers by default. These headers have been optional in the REST API since x-ms-version 2021-06-08:
- ShareFileClient.Create() and .CreateAsync()
- ShareFileClient.SetHttpHeaders() and .SetHttpHeadersAsync()
- ShareDirectoryClient.Create() and .CreateAsync()
- ShareDirectoryClient.SetHttpHeaders() and .SetHttpHeadersAsync()
Features Added
- Added support for service version 2025-05-05.
- Added support for NFS over REST.
Bugs Fixed
- Fixed [BUG] Unable to create directory with only whiteSpaceChars #42891
Storage - Queues 12.22.0-beta.1 Changelog
Features Added
- Added support for service version 2025-05-05.
System.ClientModel 1.3.0 Changelog
Other Changes
- Use
BinaryData.Empty
forPipelineResponse.Content
when HTTP message has no content (#46669).
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.Inference --version 1.0.0-beta.3
$> dotnet add package Azure.AI.Language.Conversations --version 2.0.0-beta.2
$> dotnet add package Azure.AI.OpenAI --version 2.2.0-beta.1
$> dotnet add package Azure.AI.Projects --version 1.0.0-beta.3
$> dotnet add package Azure.Communication.CallAutomation --version 1.4.0-beta.2
$> dotnet add package Azure.Communication.Messages --version 1.2.0-beta.1
$> dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0
$> dotnet add package Azure.Containers.ContainerRegistry --version 1.2.0
$> dotnet add package Azure.Core --version 1.45.0
$> dotnet add package Azure.Developer.LoadTesting --version 1.0.2
$> dotnet add package Azure.Extensions.AspNetCore.Configuration.Secrets --version 1.4.0
$> dotnet add package Azure.Extensions.AspNetCore.DataProtection.Blobs --version 1.5.0
$> dotnet add package Azure.Extensions.AspNetCore.DataProtection.Keys --version 1.4.0
$> dotnet add package Azure.Identity --version 1.14.0-beta.1
$> dotnet add package Azure.Messaging.EventGrid --version 4.29.0
$> dotnet add package Azure.Messaging.EventHubs --version 5.12.0-beta.2
$> dotnet add package Azure.Messaging.EventHubs --version 5.11.6
$> dotnet add package Azure.Messaging.EventHubs.Processor --version 5.12.0-beta.2
$> dotnet add package Azure.Messaging.EventHubs.Processor --version 5.11.6
$> dotnet add package Azure.Messaging.ServiceBus --version 7.18.4
$> dotnet add package Azure.ResourceManager.AppConfiguration --version 1.4.0
$> dotnet add package Azure.ResourceManager.ComputeSchedule --version 1.0.0
$> dotnet add package Azure.ResourceManager.ContainerRegistry --version 1.3.0-beta.2
$> dotnet add package Azure.ResourceManager.DataProtectionBackup --version 1.6.0-beta.1
$> dotnet add package Azure.ResourceManager.DataProtectionBackup --version 1.6.0
$> dotnet add package Azure.ResourceManager.DeviceRegistry --version 1.0.0-beta.2
$> dotnet add package Azure.ResourceManager.IotOperations --version 1.0.0
$> dotnet add package Azure.ResourceManager.Kusto --version 1.6.0
$> dotnet add package Azure.ResourceManager.Monitor --version 1.4.0-beta.2
$> dotnet add package Azure.ResourceManager.Network --version 1.11.0-beta.1
$> dotnet add package Azure.ResourceManager.NetworkCloud --version 1.1.0
$> dotnet add package Azure.ResourceManager.Nginx --version 1.1.0-beta.3
$> dotnet add package Azure.ResourceManager.Quota --version 1.1.0-beta.3
$> dotnet add package Azure.ResourceManager.ServiceNetworking --version 1.1.0-beta.1
$> dotnet add package Azure.Security.ConfidentialLedger --version 1.4.1-beta.1
$> dotnet add package Azure.Storage.Blobs --version 12.24.0-beta.1
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.21.0-beta.1
$> dotnet add package Azure.Storage.Blobs.ChangeFeed --version 12.0.0-preview.53
$> dotnet add package Azure.Storage.Common --version 12.23.0-beta.1
$> dotnet add package Azure.Storage.DataMovement --version 12.0.0
$> dotnet add package Azure.Storage.DataMovement.Blobs --version 12.0.0
$> dotnet add package Azure.Storage.DataMovement.Files.Shares --version 12.0.0
$> dotnet add package Azure.Storage.Files.DataLake --version 12.22.0-beta.1
$> dotnet add package Azure.Storage.Files.Shares --version 12.22.0-beta.1
$> dotnet add package Azure.Storage.Queues --version 12.22.0-beta.1
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage.Blobs --version 5.3.4
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage.Queues --version 5.3.4
$> dotnet add package Microsoft.Extensions.Azure --version 1.10.0
$> dotnet add package System.ClientModel --version 1.3.0
Feedback
If you have a bug or feature request for one of the libraries, please file an issue in our repo.