Azure SDK for Python (February 2025)
The Azure SDK team is pleased to announce our February 2025 client library releases.
41 packages released this month.
Stable Packages (17)
-
AI Evaluation
-
Azure Blob Storage Checkpoint Store
-
Azure Blob Storage Checkpoint Store AIO
-
Communication Phone Numbers
-
Event Hubs
-
Identity
-
Machine Learning
-
Resource Management - App Service
-
Resource Management - Compute
-
Resource Management - Computeschedule
-
Resource Management - Container Service
-
Resource Management - Event Hubs
-
Resource Management - Kusto
-
Resource Management - Redis
-
Resource Management - Service Networking
-
Resource Management - Storage
-
Service Bus
Patch Updates (7)
-
Azure Monitor OpenTelemetry
-
Load Testing
-
Monitor Query
-
Resource Management - Logz
-
Storage - Blobs
-
Storage - Files Data Lake
-
Storage - Files Share
Beta Packages (13)
-
AI Model Inference
-
Azure AI Search
-
Communication Messages
-
Cosmos DB
-
Event Hubs
-
OpenTelemetry Exporter
-
Resource Management - Hardware Security Modules
-
Resource Management - Monitor
-
Resource Management - Pineconevectordb
-
Resource Management - Quota
-
Storage - Blobs
-
Storage - Files Data Lake
-
Storage - Files Share
Release highlights
AI Evaluation 1.2.0 Changelog
Breaking Changes
ViolenceMultimodalEvaluator
,SexualMultimodalEvaluator
,SelfHarmMultimodalEvaluator
,HateUnfairnessMultimodalEvaluator
andProtectedMaterialMultimodalEvaluator
will be removed in next release.
Features Added
- CSV files are now supported as data file inputs with
evaluate()
API. The CSV file should have a header row with column names that match thedata
andtarget
fields in theevaluate()
method and the filename should be passed as thedata
parameter. Column name ‘Conversation’ in CSV file is not fully supported yet.
Bugs Fixed
- Removed
[remote]
extra. This is no longer needed when tracking results in Azure AI Studio. - Fixed
AttributeError: 'NoneType' object has no attribute 'get'
while running simulator with 1000+ results - Fixed the non adversarial simulator to run in task-free mode
- Content safety evaluators (violence, self harm, sexual, hate/unfairness) return the maximum result as the main score when aggregating per-turn evaluations from a conversation into an overall evaluation score. Other conversation-capable evaluators still default to a mean for aggregation.
- Fixed bug in non adversarial simulator sample where
tasks
undefined
AI Model Inference 1.0.0b7 Changelog
Bugs Fixed
- Fix a bug that would cause an error when tracing was enabled and azure-core-tracing-opentelemetry was not installed and asynchronous chat completion was used.
- Enforce distinct timestamps on prompt and completion tracing events to preserve the order for chat history.
Breaking Changes
- If you previously configured your
ChatCompletionClient.complete()
call to output JSON format without a scheme, you have this in your code:response_format=ChatCompletionsResponseFormatJSON()
. To maintain the same functionality, replace this withresponse_format="json-object"
. We however recommend that you now switch to output JSON format with a provided schema if your AI model supports it:response_format=JsonSchemaFormat(...)
.
Features Added
- Added a client for Image Embeddings, named
ImageEmbeddingsClient
. See package README.md and new samples. - Added support for Chat Completions response message in JSON format that adheres to a given JSON schema. Also known
as “structured output”. See new samples
sample_chat_completions_with_structured_output.py
andsample_chat_completions_with_structured_output_pydantic.py
. - Made input argument
content
a positional argument (in addition to keyword argument), in the constructors ofUserMessage
,SystemMessage
,AssistantMessage
andToolMessage
. For example, you no longer need to writeUserMessage(content="my message")
. Simply writeUserMessage("my message")
. All samples were updated accordingly.
AI Model Inference 1.0.0b8 Changelog
Bugs Fixed
- Fix a bug that caused filtering of a package with token usage from Azure OpenAI models in the streaming mode.
Features Added
- Added support for Chat Completions with audio input. See new sample
sample_chat_completions_with_audio_data.py
.
Azure AI Search 11.6.0b9 Changelog
Bugs Fixed
- Exposed
@search.document_debug_info
in the search results.
Azure Blob Storage Checkpoint Store 1.2.0 Changelog
Bugs Fixed
- Fixed a bug with
BlobCheckpointStore.claim_ownership
mutating theownership_list
argument to no longer mutate the argument. - Updated
azure-core
dependency to 1.20.1 to fixcchardet
ImportError.
Azure Blob Storage Checkpoint Store AIO 1.2.0 Changelog
Bugs Fixed
- Fixed a bug with
BlobCheckpointStore.claim_ownership
mutating theownership_list
argument to no longer mutate the argument. - Updated
azure-core
dependecy to 1.20.1 to fixcchardet
ImportError.
Azure Monitor OpenTelemetry 1.6.5 Changelog
Features Added
- Add more diagnostic log options (#39701)
- Only add OpenTelemetry LoggingHandler if current logger does not have it (#38549)
- Distro to automatically configure event logger provider (#38543)
- Configure live metrics first in pipeline to detect statsbeat usage (#38556)
- Ignore backoff warning from distro if in functions environment (#38787)
Communication Messages 1.2.0b1 Changelog
Features Added
- Using
NotificationMessagesClient
- Send Interactive messages
- WhatsApp List Interactive Message
- WhatsApp Reply Button Interactive Message
- WhatsApp Url Interactive Message
- Send Reactions messages
- Send Stickers messages
Communication Phone Numbers 1.2.0 Changelog
Features Added
- GA release of Number Insight.
- API version
2025-02-11
is the default.
Other changes
- Updated
search_operator_information
method signature to enforceoptions
as a keyword-only argument.
Cosmos DB 4.9.1b2 Changelog
Bugs Fixed
- Fixed
KeyError
being returned by location cache when most preferred location is not present in cached regions. See PR 39396. - Fixed cross-region retries on
CosmosClient
initialization. See PR 39396
Features Added
- Added new cross-regional retry logic for
ServiceRequestError
andServiceResponseError
exceptions. See PR 39396
Cosmos DB 4.9.1b3 Changelog
Bugs Fixed
- Fixed unnecessary retries on the wrong region for timout retry policy. See PR 39390
- All client connection errors from aiohttp will be retried. See PR 39390
Features Added
- Improved retry logic by retrying alternative endpoint for writes within a region before performing a cross region retry. See PR 39390
- Added endpoint health check logic during database account calls. See PR 39390
Cosmos DB 4.9.1b4 Changelog
Bugs Fixed
- Improved retry logic for read requests to failover on other regions in case of timeouts and any error codes >= 500. See PR 39596
- Fixed a regression where read operations were not retrying on timeouts. See PR 39596
- Updated default read timeout for
getDatabaseAccount
calls to 3 seconds. See PR 39596
Cosmos DB 4.10.0b1 Changelog
Features Added
- Added ability to replace
computed_properties
throughreplace_container
method. See PR 39543
Event Hubs 5.15.0b1 Changelog
Features Added
- Added support for geo-replication and disaster recovery-enabled Event Hubs. To learn more about geo-replication, refer to this doc. To enable geo-replication on your Dedicated Event Hubs namespace, refer to this guide.
Event Hubs 5.14.0 Changelog
Features Added
- Add support for Decimal128 in pyAMQP ([#39511]https://github.com/Azure/azure-sdk-for-python/pull/39511)
Bugs Fixed
- Fixed a bug where async websocket disconnects were not being retried properly.
- Fixed a bug where pyAMQP was doubly retrying, causing latency on reconnect. (#39037)
- Fixed a bug where handle partial frames being sent twice due to multiple threads trying to send from the same outgoing internal buffer for large messages. (#38067)
- Missing await in sender async on pyAMQP. (#39182)
- Fixed a bug where message IDs in management operation requests were not unique.
Identity 1.20.0 Changelog
Features Added
- Added
subscription
parameter toAzureCliCredential
to specify the subscription to use when authenticating with the Azure CLI. (#37994)
Bugs Fixed
- A bug in the error handling for AzureCliCredentials and AzureDeveloperCliCredential which would result in the unexpected error
'NoneType' object has no attribute 'startswith'
has been fixed (#39176)
Load Testing 1.0.1 Changelog
Bugs Fixed
- Update API response enum typo for VALIDATION_FAILURE
Machine Learning 1.25.0 Changelog
Bugs Fixed
- #39187 - Submitting a Command job created using the call method on another Command is missing outputs
Monitor Query 1.4.1 Changelog
Other Changes
- Internal updates for linting and typing improvements.
OpenTelemetry Exporter 1.0.0b33 Changelog
Bugs Fixed
- Detect live metrics usage during runtime in addition to on startup (#37694)
- Remove status code
206
from retry code + only count batch level for statsbeat (#38647)
Features Added
- Implement live metrics filtering for metrics (#37998)
- Add applying filter/validating filter logic to live metrics filtering (#38451)
- Implement live metrics filtering for docs (#38925)
- Implement live metrics + filtering for span event exceptions (#39168)
Resource Management - App Service 8.0.0 Changelog
Resource Management - Compute 34.0.0 Changelog
Resource Management - Computeschedule 1.0.0 Changelog
Resource Management - Container Service 34.0.0 Changelog
Resource Management - Event Hubs 11.2.0 Changelog
Resource Management - Hardware Security Modules 1.0.0b2 Changelog
Resource Management - Kusto 3.4.0 Changelog
Resource Management - Logz 1.1.1 Changelog
Resource Management - Monitor 7.0.0b1 Changelog
Resource Management - Pineconevectordb 1.0.0b1 Changelog
Resource Management - Quota 2.0.0b2 Changelog
Resource Management - Redis 14.5.0 Changelog
Resource Management - Service Networking 2.0.0 Changelog
Resource Management - Storage 22.0.0 Changelog
Service Bus 7.14.0 Changelog
Features Added
- Added in emulator support, ServiceBusAdministrationClient is currently not supported by the emulator. (#38655)
- Add support for Decimal128 in pyAMQP ([#39511]https://github.com/Azure/azure-sdk-for-python/pull/39511)
Bugs Fixed
- Fixed a bug where async websocket disconnects were not being retried properly. (#36280)
- Fixed a bug where sending large messages with synchronous client caused a frame buffer offset error (#37916)
- Fix to handle websocket disconnect/close on aiohttp, as aiohttp raises a
TypeError
while asserting bytes. (#32061) - Fixed a bug where pyAMQP was doubly retrying, causing latency on reconnect. (#39037)
- Fix to handle large messages being sent twice due to incoming flow frames triggering a resend. (#38067)
- Missing await in sender async on pyAMQP. (#39182)
- Improved AutoLockRenewer to renew locks for more registered messages. (#37340)
- Fixed a bug where message IDs in management operation requests were not unique.
Storage - Blobs 12.24.1 Changelog
Bugs Fixed
- Fixed an issue where custom transports may encounter
AttributeError
on certain requests. - Fixed an issue where
StorageStreamDownloader(chars=-1)
may not return all data.
Storage - Blobs 12.25.0b1 Changelog
Features Added
- Added support for service version 2025-05-05.
Storage - Files Data Lake 12.18.1 Changelog
Bugs Fixed
- Fixed an issue where custom transports may encounter
AttributeError
on certain requests. - Fixed request handler to handle
None
value forexpires_on
keyword toset_file_expiry
API.
Storage - Files Data Lake 12.19.0b1 Changelog
Features Added
- Added support for service version 2025-05-05.
Storage - Files Share 12.20.1 Changelog
Bugs Fixed
- Fixed an issue where custom transports may encounter
AttributeError
on certain requests.
Storage - Files Share 12.21.0b1 Changelog
Features Added
- Added support for service version 2025-05-05.
- Added support for NFS shares to existing APIs. This includes adding
owner
,group
, andfile_mode
options tocreate_file
,create_directory
,set_http_headers
(File and Directory),DirectoryProperties
, andFileProperties
. - Added new
create_hard_link
method toShareFileClient
to create hard links to specified files and is only supported for theNFS
protocol. create_file
,create_directory
, andset_http_headers
(File and Directory) APIs no longer send request headersx-ms-file-permission-key
,x-ms-file-attributes
,x-ms-file-creation-time
, andx-ms-file-last-write-time
by default. The request headers have been optional in the REST API since service version 2021-06-08. The default behavior of these APIs remain the same.
Latest Releases
View all the latest versions of Python packages here.
Installation Instructions
To install the latest beta version of the packages, copy and paste the following commands into a terminal:
$> pip install azure-ai-evaluation==1.2.0
$> pip install azure-ai-inference==1.0.0b7
$> pip install azure-ai-inference==1.0.0b8
$> pip install azure-ai-ml==1.25.0
$> pip install azure-communication-messages==1.2.0b1
$> pip install azure-communication-phonenumbers==1.2.0
$> pip install azure-cosmos==4.9.1b2
$> pip install azure-cosmos==4.9.1b3
$> pip install azure-cosmos==4.9.1b4
$> pip install azure-cosmos==4.10.0b1
$> pip install azure-developer-loadtesting==1.0.1
$> pip install azure-eventhub==5.15.0b1
$> pip install azure-eventhub==5.14.0
$> pip install azure-eventhub-checkpointstoreblob==1.2.0
$> pip install azure-eventhub-checkpointstoreblob-aio==1.2.0
$> pip install azure-identity==1.20.0
$> pip install azure-mgmt-compute==34.0.0
$> pip install azure-mgmt-computeschedule==1.0.0
$> pip install azure-mgmt-containerservice==34.0.0
$> pip install azure-mgmt-eventhub==11.2.0
$> pip install azure-mgmt-hardwaresecuritymodules==1.0.0b2
$> pip install azure-mgmt-kusto==3.4.0
$> pip install azure-mgmt-logz==1.1.1
$> pip install azure-mgmt-monitor==7.0.0b1
$> pip install azure-mgmt-pineconevectordb==1.0.0b1
$> pip install azure-mgmt-quota==2.0.0b2
$> pip install azure-mgmt-redis==14.5.0
$> pip install azure-mgmt-servicenetworking==2.0.0
$> pip install azure-mgmt-storage==22.0.0
$> pip install azure-mgmt-web==8.0.0
$> pip install azure-monitor-opentelemetry==1.6.5
$> pip install azure-monitor-opentelemetry-exporter==1.0.0b33
$> pip install azure-monitor-query==1.4.1
$> pip install azure-search-documents==11.6.0b9
$> pip install azure-servicebus==7.14.0
$> pip install azure-storage-blob==12.24.1
$> pip install azure-storage-blob==12.25.0b1
$> pip install azure-storage-file-datalake==12.18.1
$> pip install azure-storage-file-datalake==12.19.0b1
$> pip install azure-storage-file-share==12.20.1
$> pip install azure-storage-file-share==12.21.0b1
Feedback
If you have a bug or feature request for one of the libraries, please post an issue to GitHub.