NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #775 most downloaded on PyPI
Microsoft Corporation Azure Storage Queue Client Library for Python
Last release 4 days ago
30 Sep 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 36 of 37 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
57 releases · first in 2017
This version and all future versions will require Python 3.10+. Python 3.9 is no longer supported.
This version and all future versions will require Python 3.10+. Python 3.9 is no longer supported.
azure-core Request/Response types will no longer be supported and may now cause errors if used. Please ensure custom transports are utilizing types from azure.core.rest.Added support for service version 2026-10-06.
One column per quarter.
Stable release of features from 12.17.0b1
Added support for service version 2026-06-06.
account_urls to accept URLs with -ipv6 and -dualstack suffixes
for QueueServiceClient and QueueClient.Stable release of features from 12.16.0b1
logging_enable and logging_body keywords on a per-request
basis and with retries. Prior to this fix logging may have not behaved as expected, especially on retries.Added support for service version 2026-04-06.
user_delegation_tid to QueueServiceClient.get_user_delegation_key API, which
can be used in generate_queue_sas to specify the Tenant ID that is authorized to use the generated SAS URL.
Note that user_delegation_tid must be used together with user_delegation_oid.azure-core dependency to 1.37.0.Stable release of features from 12.15.0b1
Added support for service version 2026-02-06.
get_user_delegation_key API to QueueServiceClient to obtain a user delegation key
for the purposes of signing SAS tokens.user_delegation_oid to generate_queue_sas, which specifies the Entra ID
of the user that is authorized to use the generated SAS URL.user_delegation_key to generate_queue_sas used with
user_delegation_oid to authenticate the request to generate a new SAS URL.UseDevelopmentStorage=true; as a valid connection string for Azurite.Fixed MyPy attr-defined errors for QueueClient.
attr-defined errors for QueueClient.Stable release of features from 12.14.0b1
__enter__ and __exit__ attributes for all asynchronous client objects for raising explicit TypeError,
and let the AttributeError raise directly.This version and all future versions will require Python 3.9+. Python 3.8 is no longer supported.
This version and all future versions will require Python 3.9+. Python 3.8 is no longer supported.
Stable release of features from 12.13.0b1
Added support for service version 2025-07-05.
QueueClient's get_queue_access_policy
and set_queue_access_policy APIs.kwarg arguments to be named keywords.
Some public types may have been adjusted if they were previously erroneous or incomplete.Stable release of features from 12.12.0b1
Added support for service version 2024-11-04.
azure-core dependency to 1.30.0.Stable release of features from 12.11.0b1
Updated OAuth implementation to use the AAD scope returned in a Bearer challenge.
Stable release of features from 12.10.0b1
This version and all future versions will require Python 3.8+. Python 3.7 is no longer supported.
This version and all future versions will require Python 3.8+. Python 3.7 is no longer supported.
services parameter has been added to the generate_account_sas API, which enables the ability to generate SAS
tokens to be used with multiple services. By default, the SAS token service scope will default to the current service.typing-extensions to >=4.6.0 to avoid potential TypeError with typing.TypeVar on
Python 3.12.AttributeError instead of ClientAuthenticationError when
using async OAuth credentials.Updated type hints across the entire package and enabled MyPy to run during CI. Some public types may have been adjusted if they were previously erron
Stable release of features from 12.18.0b1
Added audience as an optional keyword that can be specified on APIs that have a credential parameter. This keyword only has an effect when the credent
audience as an optional keyword that can be specified on APIs that have a credential parameter. This
keyword only has an effect when the credential provided is of type TokenCredential.Fixed an issue when an invalid type was provided for credential during client construction, the __str__ of the object would be present in the exceptio
credential during client construction, the
__str__ of the object would be present in the exception message and therefore potentially logged.Fixed an issue where user_agent was being ignored on send_message, receive_message, receive_messages, update_message, and peek_messages if client was
user_agent was being ignored on send_message, receive_message, receive_messages,
update_message, and peek_messages if client was configured for encryption.Fixed breaking KeyError: 'sdk_moniker' in create_configuration. NOTE: This is not an exported method and therefore should not be imported/called direc
KeyError: 'sdk_moniker' in create_configuration.
NOTE: This is not an exported method and therefore should not be imported/called directly.Code | Docs Text Analytics azure-ai-textanalytics
Code | Docs
Text Analytics
azure-ai-textanalytics
Bumped azure-core minimum dependency to 1.28.0 and typing-extensions to 4.3.0.
azure-core minimum dependency to 1.28.0 and typing-extensions to 4.3.0.Stable release of features from 12.6.0b1
Added typing-extensions>=4.0.1 as a dependency.
msrest dependency.typing-extensions>=4.0.1 as a dependency.isodate>=0.6.1 as a dependency.aio for installing optional async dependencies. Use pip install azure-storage-queue[aio] to install.Stable release of features from 12.5.0b1.
read_timeout to 60 seconds for all clients.This version and all future versions will require Python 3.7+. Python 3.6 is no longer supported.
This version and all future versions will require Python 3.7+. Python 3.6 is no longer supported.
AzureNamedKeyCredential as a valid credential type.Stable release of features from 12.4.0b1.
Introduced version 2.0 of client-side encryption for Queue messages which utilizes AES-GCM-256 encryption. Version 1.0 is now deprecated and no longer…
encryption_version
keyword (i.e. encryption_version='2.0').Stable release of features from 12.3.0b1.
Added support for max_messages in receive_messages() to specify the maximum number of messages to receive from the queue.
max_messages in receive_messages() to specify the maximum number of messages to receive from the queue.receive_messages() to explain iterator behavior and life-cycle.queue_samples_message.py (and async-equivalent) showcasing the use of max_messages in receive_messages().This version and all future versions will require Python 3.6+. Python 2.7 is no longer supported.
This version and all future versions will require Python 3.6+. Python 2.7 is no longer supported.
azure-core dependency to avoid inconsistent dependencies from being installed.Make AccountName, AccountKey etc. in conn_str case insensitive
Fixes
AccountName, AccountKey etc. in conn_str case insensitiveThreadPoolExecutor (#8955)Added support for AzureSasCredential to allow SAS rotation in long living clients.
New features
AzureSasCredential to allow SAS rotation in long living clients.Added receive_message on QueueClient to support receiving one message from queue (#14844, #14762)
New feature
receive_message on QueueClient to support receiving one message from queue (#14844, #14762)Notes
azure-core from azure-core<2.0.0,>=1.6.0 to azure-core<2.0.0,>=1.9.0 to get continuation_token attr on AzureError.Fixed QueueClient type declaration (#11392).
Fixes
Updated dependency from azure-core<2.0.0,>=1.2.2 to azure-core<2.0.0,>=1.6.0
Notes
Responses are always decoded as UTF8
Fixes
Notes
StorageUserAgentPolicy is now replaced with the UserAgentPolicy from azure-core. With this, the custom user agents are now added as a prefix instead of being appended.All the clients now have a close() method to close the sockets opened by the client when using without a context manager.
New features
close() method to close the sockets opened by the client when using without a context manager.Code | Docs Support: Active
Code | Docs
Support: Active
Breaking changes
QueueClient now accepts only account_url with mandatory a string param queue_name.
To use a queue_url, the method from_queue_url must be used.set_queue_access_policy has required parameter signed_identifiers.NoRetry policy has been removed. Use keyword argument retry_total=0 for no retries.NoEncodePolicy and NoDecodePolicy have been removed. Use message_encode_policy=None and message_decode_policy=None.QueueServiceClient and QueueClient
should be imported from azure.storage.queue.aioloopmax_concurrencyvalidate_contenttimeout etc.QueueMessage has had its parameters renamed from insertion_time, time_next_visible, expiration_time
to inserted_on, next_visible_on, expires_on, respectively.Logging has been renamed to QueueAnalyticsLogging.enqueue_message is now called send_message.azure.storage.queue and azure.storage.queue.aio only.generate_shared_access_signature methods on both QueueServiceClient and QueueClient have been replaced by module level functions generate_account_sas and generate_queue_sas.get_service_stats now returns a dictget_service_properties now returns a dict with keys consistent to set_service_propertiesNew features
ResourceTypes, and Services now have method from_string which takes parameters as a string.Fixes and improvements
AccountPermissions, QueuePermissions have been renamed to AccountSasPermissions, QueueSasPermissions respectively.
Breaking changes
AccountPermissions, QueuePermissions have been renamed to
AccountSasPermissions, QueueSasPermissions respectively.__add__ and __or__ methods are removed.max_connections is now renamed to max_concurrency.New features
AccountSasPermissions, QueueSasPermissions now have method from_string which takes parameters as a string.If you later want to revert to previous versions of azure-storage-queue, or another Azure SDK library requiring azure-core 1.0.0b1 or azure-core 1.0.0
Dependency updates
Adopted azure-core 1.0.0b3
pip install azure-core==1.0.0b2 azure-storage-queue==12.0.0b2
The behavior of listing operations has been modified:
Breaking changes
marker parameter has been removed.by_page function that will return a secondary iterator of batches of results. This function supports a continuation_token parameter to replace the previous marker parameter.receive_messages operation:
by_page operation to receive messages in batches.New features
azure.storage.queue.aio.Dependency updates
Adopted azure-core 1.0.0b2
pip install azure-core==1.0.0b1 azure-storage-queue==12.0.0b1
Fixes and improvements
Breaking changes: New API design
Version 12.0.0b1 is the first preview of our efforts to create a user-friendly and Pythonic client library for Azure Storage Queues. For more information about this, and preview releases of other Azure SDK libraries, please visit https://aka.ms/azure-sdk-preview1-python.
Breaking changes: New API design
Operations are now scoped to a particular client:
QueueServiceClient: This client handles account-level operations. This includes managing service properties and listing the queues within an account.QueueClient: The client handles operations within a particular queue. This includes creating or deleting that queue, as well as enqueueing and dequeueing messages.These clients can be accessed by navigating down the client hierarchy, or instantiated directly using URLs to the resource (account or queue). For full details on the new API, please see the reference documentation.
New message iterator, for receiving messages from a queue in a continuous stream.
New underlying REST pipeline implementation, based on the new azure-core library.
Client and pipeline configuration is now available via keyword arguments at both the client level, and per-operation. See reference documentation for a full list of optional configuration arguments.
Authentication using azure-identity credentials
New error hierarchy:
azure.core.exceptions.HttpResponseErrorResourceNotFoundError: The resource (e.g. queue, message) could not be found. Commonly a 404 status code.ResourceExistsError: A resource conflict - commonly caused when attempting to create a resource that already exists.ResourceModifiedError: The resource has been modified (e.g. overwritten) and therefore the current operation is in conflict. Alternatively this may be raised if a condition on the operation is not met.ClientAuthenticationError: Authentication failed.No longer have specific operations for get_metadata - use get_properties instead.
No longer have specific operations for exists - use get_properties instead.
Operations get_queue_acl and set_queue_acl have been renamed to get_queue_access_policy and set_queue_access_policy.
Operation put_message has been renamed to enqueue_message.
Operation get_messages has been renamed to receive_messages.
Code | Docs
Code | Docs
Updated dependency on azure-storage-common.
Code | Docs Event Grid azure-eventgrid
Code | Docs
Event Grid
azure-eventgrid
Code | Docs Communication Rooms azure-communication-rooms
Code | Docs
Communication Rooms
azure-communication-rooms
Code | Docs Communication Email azure-communication-email
Code | Docs
Communication Email
azure-communication-email
Support for 2017-11-09 REST version. Please see our REST API documentation and blog for information about the related added features.
Code | Docs
Code | Docs
Code | Docs Azure AI Search azure-search-documents
Code | Docs
Azure AI Search
azure-search-documents
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →