Azure Core shared client library for Python

Azure core provides shared exceptions and modules for Python SDK client libraries. These libraries follow the Azure SDK Design Guidelines for Python .

If you are a client library developer, please reference client library developer reference for more information.

Source code | Package (Pypi) | Package (Conda) | API reference documentation

Getting started

Typically, you will not need to install azure core; it will be installed when you install one of the client libraries using it. In case you want to install it explicitly (to implement your own client library, for example), you can find it here.

Key concepts

Azure Core Library Exceptions

AzureError

AzureError is the base exception for all errors.

class AzureError(Exception):
    def __init__(self, message, *args, **kwargs):
        self.inner_exception = kwargs.get("error")
        self.exc_type, self.exc_value, self.exc_traceback = sys.exc_info()
        self.exc_type = self.exc_type.__name__ if self.exc_type else type(self.inner_exception)
        self.exc_msg = "{}, {}: {}".format(message, self.exc_type, self.exc_value)  # type: ignore
        self.message = str(message)
        self.continuation_token = kwargs.get("continuation_token")
        super(AzureError, self).__init__(self.message, *args)

message is any message (str) to be associated with the exception.

args are any additional args to be included with exception.

kwargs are keyword arguments to include with the exception. Use the keyword error to pass in an internal exception and continuation_token for a token reference to continue an incomplete operation.

The following exceptions inherit from AzureError:

ServiceRequestError

An error occurred while attempt to make a request to the service. No request was sent.

ServiceResponseError

The request was sent, but the client failed to understand the response. The connection may have timed out. These errors can be retried for idempotent or safe operations.

HttpResponseError

A request was made, and a non-success status code was received from the service.

class HttpResponseError(AzureError):
    def __init__(self, message=None, response=None, **kwargs):
        self.reason = None
        self.response = response
        if response:
            self.reason = response.reason
            self.status_code = response.status_code
        self.error = self._parse_odata_body(ODataV4Format, response)  # type: Optional[ODataV4Format]
        if self.error:
            message = str(self.error)
        else:
            message = message or "Operation returned an invalid status '{}'".format(
                self.reason
            )

        super(HttpResponseError, self).__init__(message=message, **kwargs)

message is the HTTP response error message (optional)

response is the HTTP response (optional).

kwargs are keyword arguments to include with the exception.

The following exceptions inherit from HttpResponseError:

DecodeError

An error raised during response de-serialization.

IncompleteReadError

An error raised if peer closes the connection before we have received the complete message body.

ResourceExistsError

An error response with status code 4xx. This will not be raised directly by the Azure core pipeline.

ResourceNotFoundError

An error response, typically triggered by a 412 response (for update) or 404 (for get/post).

ResourceModifiedError

An error response with status code 4xx, typically 412 Conflict. This will not be raised directly by the Azure core pipeline.

ResourceNotModifiedError

An error response with status code 304. This will not be raised directly by the Azure core pipeline.

ClientAuthenticationError

An error response with status code 4xx. This will not be raised directly by the Azure core pipeline.

TooManyRedirectsError

An error raised when the maximum number of redirect attempts is reached. The maximum amount of redirects can be configured in the RedirectPolicy.

class TooManyRedirectsError(HttpResponseError):
    def __init__(self, history, *args, **kwargs):
        self.history = history
        message = "Reached maximum redirect attempts."
        super(TooManyRedirectsError, self).__init__(message, *args, **kwargs)

history is used to document the requests/responses that resulted in redirected requests.

args are any additional args to be included with exception.

kwargs are keyword arguments to include with the exception.

StreamConsumedError

An error thrown if you try to access the stream of azure.core.rest.HttpResponse or azure.core.rest.AsyncHttpResponse once the response stream has been consumed.

StreamClosedError

An error thrown if you try to access the stream of the azure.core.rest.HttpResponse or azure.core.rest.AsyncHttpResponse once the response stream has been closed.

ResponseNotReadError

An error thrown if you try to access the content of azure.core.rest.HttpResponse or azure.core.rest.AsyncHttpResponse before reading in the response's bytes first.

Configurations

When calling the methods, some properties can be configured by passing in as kwargs arguments.

Async transport

The async transport is designed to be opt-in. AioHttp is one of the supported implementations of async transport. It is not installed by default. You need to install it separately.

Shared modules

MatchConditions

MatchConditions is an enum to describe match conditions.

class MatchConditions(Enum):
    Unconditionally = 1  # Matches any condition
    IfNotModified = 2  # If the target object is not modified. Usually it maps to etag=<specific etag>
    IfModified = 3  # Only if the target object is modified. Usually it maps to etag!=<specific etag>
    IfPresent = 4   # If the target object exists. Usually it maps to etag='*'
    IfMissing = 5   # If the target object does not exist. Usually it maps to etag!='*'

CaseInsensitiveEnumMeta

A metaclass to support case-insensitive enums.

from enum import Enum

from azure.core import CaseInsensitiveEnumMeta

class MyCustomEnum(str, Enum, metaclass=CaseInsensitiveEnumMeta):
    FOO = 'foo'
    BAR = 'bar'

Null Sentinel Value

A falsy sentinel object which is supposed to be used to specify attributes with no data. This gets serialized to null on the wire.

from azure.core.serialization import NULL

assert bool(NULL) is False

foo = Foo(
    attr=NULL
)

Logging

Azure libraries follow the guidance of Python's standard logging module. By following the Python documentation on logging, you should be able to configure logging for Azure libraries effectively.

Azure library loggers use a dot-based separated syntax, where the first section is always azure, followed by the package name. For example, the Azure Core library uses logger names that start with azure.core.

Here's an example of how to configure logging for Azure libraries:

import logging
import sys

# Enable detailed console logs across Azure libraries
azure_logger = logging.getLogger("azure")
azure_logger.setLevel(logging.DEBUG)
azure_logger.addHandler(logging.StreamHandler(stream=sys.stdout))

# Exclude detailed logs for network calls associated with getting Entra ID token.
identity_logger = logging.getLogger("azure.identity")
identity_logger.setLevel(logging.ERROR)

# Make sure regular (redacted) detailed azure.core logs are not shown, as we are about to
# turn on non-redacted logs by passing 'logging_enable=True' to the client constructor 
logger = logging.getLogger("azure.core.pipeline.policies.http_logging_policy")
logger.setLevel(logging.ERROR)

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Release History

1.36.0 (2025-10-14)

Features Added

• Added TypeHandlerRegistry to azure.core.serialization to allow developers to register custom serializers and deserializers for specific types or conditions. #43051

Bugs Fixed

• Fixed repeated import attempts of cchardet and chardet when charset_normalizer is used #43092

Other Changes

• Removed six as a dependency since it was unused. #39962
• Added caching to the tracing implementation detection function to prevent potential performance issues from repeated import attempts. #43338

1.35.1 (2025-09-11)

Bugs Fixed

• Fixed an issue where the retry_backoff_max parameter in RetryPolicy and AsyncRetryPolicy constructors was being ignored, causing retry operations to use default maximum backoff values instead of the user-specified limits. #42444

Other Changes

• BearerTokenCredentialPolicy and AsyncBearerTokenCredentialPolicy will now properly surface credential exceptions when handling claims challenges. Previously, exceptions from credential token requests were suppressed; now they are raised and chained with the original 401 HttpResponseError response for better debugging visibility. #42536

1.35.0 (2025-07-02)

Features Added

• Added a start_time keyword argument to the start_span and start_as_current_span methods in the OpenTelemetryTracer class. This allows users to specify a custom start time for created spans. #41106
• Added a context keyword argument to the start_span and start_as_current_span methods in the OpenTelemetryTracer class. This allows users to specify a custom parent context for created spans. #41511
• Added method as_attribute_dict to azure.core.serialization for backcompat migration purposes. Will return a generated model as a dictionary where the keys are in attribute syntax.
• Added is_generated_model method to azure.core.serialization. Returns whether a given input is a model from one of our generated sdks. #41445
• Added attribute_list method to azure.core.serialization. Returns all of the attributes of a given model from one of our generated sdks. #41571

Other Changes

• A timeout error when using the aiohttp transport (the default for async SDKs) will now be raised as a azure.core.exceptions.ServiceResponseTimeoutError, a subtype of the previously raised ServiceResponseError.
• When using with aiohttp 3.10 or later, a connection timeout error will now be raised as a azure.core.exceptions.ServiceRequestTimeoutError, which can be retried.
• The default implementation of on_challenge in BearerTokenCredentialPolicy and AsyncBearerTokenCredentialPolicy will now cache the retrieved token. #41857

1.34.0 (2025-05-01)

Features Added

• Added a set_span_error_status method to the OpenTelemetryTracer class. This method allows users to set the status of a span to ERROR after it has been created. #40703

Other Changes

• Python 3.8 is no longer supported. Please use Python version 3.9 or later.

1.33.0 (2025-04-03)

Features Added

• Added native OpenTelemetry tracing to Azure Core which enables users to use OpenTelemetry to trace Azure SDK operations without needing to install a plugin. #39563
  • To enable native OpenTelemetry tracing, users need to:
    1. Have opentelemetry-api installed.
    2. Ensure that settings.tracing_implementation is not set.
    3. Ensure that settings.tracing_enabled is set to True.
  • If setting.tracing_implementation is set, the tracing plugin will be used instead of the native tracing.
  • If settings.tracing_enabled is set to False, tracing will be disabled.
  • The OpenTelemetryTracer class was added to the azure.core.tracing.opentelemetry module. This is a wrapper around the OpenTelemetry tracer that is used to create spans for Azure SDK operations.
  • Added a get_tracer method to the new azure.core.instrumentation module. This method returns an instance of the OpenTelemetryTracer class if OpenTelemetry is available.
  • A TracingOptions TypedDict class was added to define the options that SDK users can use to configure tracing per-operation. These options include the ability to enable or disable tracing and set additional attributes on spans.
    • Example usage: client.method(tracing_options={"enabled": True, "attributes": {"foo": "bar"}})
  • The DistributedTracingPolicy and distributed_trace/distributed_trace_async decorators now uses the OpenTelemetry tracer if it is available and native tracing is enabled.
    • SDK clients can define an _instrumentation_config class variable to configure the OpenTelemetry tracer used in method span creation. Possible configuration options are library_name, library_version, schema_url, and attributes.
    • DistributedTracingPolicy now accepts a instrumentation_config keyword argument to configure the OpenTelemetry tracer used in HTTP span creation.

Breaking Changes

• Removed automatic tracing enablement for the OpenTelemetry plugin if opentelemetry was imported. To enable tracing with the plugin, please import azure.core.settings.settings and set settings.tracing_implementation to "opentelemetry". #39563
• In DistributedTracingPolicy, the default span name is now just the HTTP method (e.g., "GET", "POST") and no longer includes the URL path. This change was made to converge with the OpenTelemetry HTTP semantic conventions. The full URL is still included in the span attributes.
• Renamed span attributes in DistributedTracingPolicy:
  • "x-ms-client-request-id" is now "az.client_request_id"
  • "x-ms-request-id" is now "az.service_request_id"

Bugs Fixed

• Fixed an issue where the traceparent header was not being set correctly in the DistributedTracingPolicy. The traceparent header will now set based on the context of the HTTP client span. #40074

Other Changes

• Added opentelemetry-api as an optional dependency for tracing. This can be installed with pip install azure-core[tracing]. #39563

1.32.0 (2024-10-31)

Features Added

• Added a default implementation to handle token challenges in BearerTokenCredentialPolicy and AsyncBearerTokenCredentialPolicy.

Bugs Fixed

• Fixed an issue where the tracing_attributes keyword argument wasn't being handled at the request/method level. #38164

Other Changes

• Log "x-vss-e2eid" and "x-msedge-ref" headers in HttpLoggingPolicy.

1.31.0 (2024-09-12)

Features Added

• Added azure.core.AzureClouds enum to represent the different Azure clouds.
• Added two new credential protocol classes, SupportsTokenInfo and AsyncSupportsTokenInfo, to offer more extensibility in supporting various token acquisition scenarios. #36565
  • Each new protocol class defines a get_token_info method that returns an AccessTokenInfo object.
• Added a new TokenRequestOptions class, which is a TypedDict with optional parameters, that can be used to define options for token requests through the get_token_info method. #36565
• Added a new AccessTokenInfo class, which is returned by get_token_info implementations. This class contains the token, its expiration time, and optional additional information like when a token should be refreshed. #36565
• BearerTokenCredentialPolicy and AsyncBearerTokenCredentialPolicy now first check if a credential has the get_token_info method defined. If so, the get_token_info method is used to acquire a token. Otherwise, the get_token method is used. #36565
  • These policies now also check the refresh_on attribute when determining if a new token request should be made.

Other Changes

• The Azure Core OpenTelemetry tracing plugin will now be the preferred tracing plugin over the OpenCensus plugin. If both plugins are installed and opentelemetry is imported, then OpenTelemetry will be used to trace Azure SDK operations. #35050

1.30.2 (2024-06-06)

Features Added

• Tracing: DistributedTracingPolicy will now set an attribute, http.request.resend_count, on HTTP spans for resent requests to indicate the resend attempt number. #35069

Bugs Fixed

• Raise correct exception if transport is used while already closed #35559

Other Changes

• HTTP tracing spans will now include an error.type attribute if an error status code is returned. #34619
• Minimum required Python version is now 3.8

1.30.1 (2024-02-29)

Other Changes

• Accept float for retry_after header. #34203

1.30.0 (2024-02-01)

Features Added

• Support tuple input for file values to azure.core.rest.HttpRequest #33948
• Support tuple input to files with duplicate field names azure.core.rest.HttpRequest #34021

1.29.7 (2024-01-18)

Other Changes

• Removed dependency on anyio. #33282

1.29.6 (2023-12-14)

Bugs Fixed

• Adjusted AsyncBearerTokenCredentialPolicy to work properly with trio concurrency mechanisms. (#33307)

Other Changes

• Added dependency on anyio >=3.0,<5.0
• Bumped minimum dependency on requests to 2.21.0.

1.29.5 (2023-10-19)

Bugs Fixed

• Fixed an issue with multipart/form-data in the async transport where data was not getting encoded into the request body. #32473

Other Changes

• Use ssl context from aiohttp by default.

1.29.4 (2023-09-07)

Bugs Fixed

• Fixed the issue that some urls trigger an infinite loop. #31346
• Fixed issue where IndexError was raised if multipart responses did not match the number of requests. #31471
• Fixed issue unbound variable exception if dict is invalid in CloudEvent.from_dict. #31835
• Fixed issue asyncBearerTokenCredentialPolicy is not backward compatible with SansIOHTTPPolicy. #31836
• Fixed issue mypy complains with new version of azure-core. #31564

1.29.3 (2023-08-22)

Bugs Fixed

• Typing fix: message cannot be None in AzureError. #31564

1.29.2 (2023-08-14)

Bugs Fixed

• Added a default implementation for AsyncTokenCredential.__aexit__() #31573

Other Changes

• Bumped typing-extensions version to 4.6.0.

1.29.1 (2023-08-09)

Bugs Fixed

• Not pass enabled_cae unless it is explicitly enabled.

1.29.0 (2023-08-03)

Features Added

• A keyword argument enable_cae was added to the get_token method of the TokenCredential protocol. #31012
• BearerTokenCredentialPolicy and AsyncBearerTokenCredentialPolicy now accept enable_cae keyword arguments in their constructors. This is used in determining if Continuous Access Evaluation (CAE) should be enabled for each get_token request. #31012

1.28.0 (2023-07-06)

Features Added

• Added header name parameter to RequestIdPolicy. #30772
• Added SensitiveHeaderCleanupPolicy that cleans up sensitive headers if a redirect happens and the new destination is in another domain. #28349

Other Changes

• Catch aiohttp errors and translate them into azure-core errors.

1.27.1 (2023-06-13)

Bugs Fixed

• Fix url building for some complex query parameters scenarios #30707

1.27.0 (2023-06-01)

Features Added

• Added support to use sync credentials in AsyncBearerTokenCredentialPolicy. #30381
• Added "prefix" parameter to AzureKeyCredentialPolicy #29901

Bugs Fixed

• Improve error message when providing the wrong credential type for AzureKeyCredential #30380

1.26.4 (2023-04-06)

Features Added

• Updated settings to include OpenTelemetry as a tracer provider. #29095

Other Changes

• Improved typing

1.26.3 (2023-02-02)

Bugs Fixed

• Fixed deflate decompression for aiohttp #28483

1.26.2 (2023-01-05)

Bugs Fixed

• Fix 'ClientSession' object has no attribute 'auto_decompress' (thanks to @mghextreme for the contribution)

Other Changes

• Add "x-ms-error-code" as secure header to log
• Rename "DEFAULT_HEADERS_WHITELIST" to "DEFAULT_HEADERS_ALLOWLIST". Added a backward compatible alias.

1.26.1 (2022-11-03)

Other Changes

• Added example of RequestsTransport with custom session. (thanks to @inirudebwoy for the contribution) #26768
• Added Python 3.11 support.

1.26.0 (2022-10-06)

Other Changes

• LRO polling will not wait anymore before doing the first status check #26376
• Added extra dependency for [aio]. pip install azure-core[aio] installs aiohttp too.

1.25.1 (2022-09-01)

Bugs Fixed

• Added @runtime_checkable to TokenCredential protocol definitions #25187

1.25.0 (2022-08-04)

Azure-core is supported on Python 3.7 or later. For more details, please read our page on Azure SDK for Python version support policy.

Features Added

• Added CaseInsensitiveDict implementation in azure.core.utils removing dependency on requests and aiohttp

1.24.2 (2022-06-30)

Bugs Fixed

• Fixed the bug that azure-core could not be imported under Python 3.11.0b3 #24928
• ContentDecodePolicy can now correctly deserialize more JSON bodies with different mime types #22410

1.24.1 (2022-06-01)

Bugs Fixed

• Declare method level span as INTERNAL by default #24492
• Fixed type hints for azure.core.paging.ItemPaged #24548

1.24.0 (2022-05-06)

Features Added

• Add SerializationError and DeserializationError in azure.core.exceptions for errors raised during serialization / deserialization #24312

1.23.1 (2022-03-31)

Bugs Fixed

• Allow stream inputs to the content kwarg of azure.core.rest.HttpRequest from objects with a read method #23578

1.23.0 (2022-03-03)

Features Added

• Improve intellisense type hinting for service client methods. #22891

• Add a case insensitive dict case_insensitive_dict in azure.core.utils. #23206

Bugs Fixed

• Use "\n" rather than "/n" for new line in log. #23261

Other Changes

• Log "WWW-Authenticate" header in HttpLoggingPolicy #22990
• Added dependency on typing-extensions >= 4.0.1

1.22.1 (2022-02-09)

Bugs Fixed

• Limiting final-state-via scope to POST until consuming SDKs has been fixed to use this option properly on PUT. #22989

1.22.0 (2022-02-03)

[This version is deprecated.]

Features Added

• Add support for final-state-via LRO option in core. #22713

Bugs Fixed

• Add response body to string representation of HttpResponseError if we're not able to parse out information #22302
• Raise AttributeError when calling azure.core.pipeline.transport.__bases__ #22469

Other Changes

• Python 2.7 is no longer supported. Please use Python version 3.6 or later.

1.21.1 (2021-12-06)

Other Changes

• Revert change in str method #22023

1.21.0 (2021-12-02)

Breaking Changes

• Sync stream downloading now raises azure.core.exceptions.DecodeError rather than requests.exceptions.ContentDecodingError

Bugs Fixed

• Add response body to string representation of HttpResponseError if we're not able to parse out information #21800

1.20.1 (2021-11-08)

Bugs Fixed

• Correctly set response's content to decompressed body when users are using aiohttp transport with decompression headers #21620

1.20.0 (2021-11-04)

Features Added

• GA send_request onto the azure.core.PipelineClient and azure.core.AsyncPipelineClient. This method takes in requests and sends them through our pipelines.
• GA azure.core.rest. azure.core.rest is our new public simple HTTP library in azure.core that users will use to create requests, and consume responses.
• GA errors StreamConsumedError, StreamClosedError, and ResponseNotReadError to azure.core.exceptions. These errors are thrown if you mishandle streamed responses from the azure.core.rest module
• add kwargs to the methods for iter_raw and iter_bytes #21529
• no longer raise JSON errors if users pass in file descriptors of JSON to the json kwarg in HttpRequest #21504
• Added new error type IncompleteReadError which is raised if peer closes the connection before we have received the complete message body.

Breaking Changes

• SansIOHTTPPolicy.on_exception returns None instead of bool.

Bugs Fixed

• The Content-Length header in a http response is strictly checked against the actual number of bytes in the body, rather than silently truncating data in case the underlying tcp connection is closed prematurely. (thanks to @jochen-ott-by for the contribution) #20412
• UnboundLocalError when SansIOHTTPPolicy handles an exception #15222
• Add default content type header of text/plain and content length header for users who pass unicode strings to the content kwarg of HttpRequest in 2.7 #21550

1.19.1 (2021-11-01)

Bugs Fixed

• respect text encoding specified in argument (thanks to @ryohji for the contribution) #20796
• Fix "coroutine x.read() was never awaited" warning from ContentDecodePolicy #21318
• fix type check for data input to azure.core.rest for python 2.7 users #21341
• use charset_normalizer if chardet is not installed to migrate aiohttp 3.8.0 changes.

Other Changes

• Refactor AzureJSONEncoder (thanks to @Codejune for the contribution) #21028

1.19.0 (2021-09-30)

Breaking Changes in the Provisional azure.core.rest package

• azure.core.rest.HttpResponse and azure.core.rest.AsyncHttpResponse are now abstract base classes. They should not be initialized directly, instead your transport responses should inherit from them and implement them.

• The properties of the azure.core.rest responses are now all read-only

• HttpLoggingPolicy integrates logs into one record #19925

1.18.0 (2021-09-02)

Features Added

• azure.core.serialization.AzureJSONEncoder (introduced in 1.17.0) serializes datetime.datetime objects in ISO 8601 format, conforming to RFC 3339's specification. #20190
• We now use azure.core.serialization.AzureJSONEncoder to serialize json input to azure.core.rest.HttpRequest.

Breaking Changes in the Provisional azure.core.rest package

• The text property on azure.core.rest.HttpResponse and azure.core.rest.AsyncHttpResponse has changed to a method, which also takes an encoding parameter.
• Removed iter_text and iter_lines from azure.core.rest.HttpResponse and azure.core.rest.AsyncHttpResponse

Bugs Fixed

• The behaviour of the headers returned in azure.core.rest responses now aligns across sync and async. Items can now be checked case-insensitively and without raising an error for format.

1.17.0 (2021-08-05)

Features Added

• Cut hard dependency on requests library
• Added a from_json method which now accepts storage QueueMessage, eventhub's EventData or ServiceBusMessage or simply json bytes to return a CloudEvent

Fixed

• Not override "x-ms-client-request-id" if it already exists in the header. #17757

Breaking Changes in the Provisional azure.core.rest package

• azure.core.rest will not try to guess the charset anymore if it was impossible to extract it from HttpResponse analysis. This removes our dependency on charset.

1.16.0 (2021-07-01)

Features Added

• Add new provisional methods send_request onto the azure.core.PipelineClient and azure.core.AsyncPipelineClient. This method takes in requests and sends them through our pipelines.
• Add new provisional module azure.core.rest. azure.core.rest is our new public simple HTTP library in azure.core that users will use to create requests, and consume responses.
• Add new provisional errors StreamConsumedError, StreamClosedError, and ResponseNotReadError to azure.core.exceptions. These errors are thrown if you mishandle streamed responses from the provisional azure.core.rest module

Fixed

• Improved error message in the from_dict method of CloudEvent when a wrong schema is sent.

1.15.0 (2021-06-04)

New Features

• Added BearerTokenCredentialPolicy.on_challenge and .authorize_request to allow subclasses to optionally handle authentication challenges

Bug Fixes

• Retry policies don't sleep after operations time out
• The from_dict methhod in the CloudEvent can now convert a datetime string to datetime object when microsecond exceeds the python limitation

1.14.0 (2021-05-13)

New Features

• Added azure.core.credentials.AzureNamedKeyCredential credential #17548.
• Added decompress parameter for stream_download method. If it is set to False, will not do decompression upon the stream. #17920

1.13.0 (2021-04-02)

Azure core requires Python 2.7 or Python 3.6+ since this release.

New Features

• Added azure.core.utils.parse_connection_string function to parse connection strings across SDKs, with common validation and support for case insensitive keys.
• Supported adding custom policies #16519
• Added ~azure.core.tracing.Link that should be used while passing Links to AbstractSpan.
• AbstractSpan constructor can now take in additional keyword only args.

Bug fixes

• Make NetworkTraceLoggingPolicy show the auth token in plain text. #14191
• Fixed RetryPolicy overriding default connection timeout with an extreme value #17481

1.12.0 (2021-03-08)

This version will be the last version to officially support Python 3.5, future versions will require Python 2.7 or Python 3.6+.

Features

• Added azure.core.messaging.CloudEvent model that follows the cloud event spec.
• Added azure.core.serialization.NULL sentinel value
• Improve reprs for HttpRequest and HttpResponses #16972

Bug Fixes

• Disable retry in stream downloading. (thanks to @jochen-ott-by @hoffmann for the contribution) #16723

1.11.0 (2021-02-08)

Features

• Added CaseInsensitiveEnumMeta class for case-insensitive enums. #16316
• Add raise_for_status method onto HttpResponse. Calling response.raise_for_status() on a response with an error code will raise an HttpResponseError. Calling it on a good response will do nothing #16399

Bug Fixes

• Update conn.conn_kw rather than overriding it when setting block size. (thanks for @jiasli for the contribution) #16587

1.10.0 (2021-01-11)

Features

• Added AzureSasCredential and its respective policy. #15946

1.9.0 (2020-11-09)

Features

• Add a continuation_token attribute to the base AzureError exception, and set this value for errors raised during paged or long-running operations.

Bug Fixes

• Set retry_interval to 1 second instead of 1000 seconds (thanks vbarbaresi for contributing) #14357

1.8.2 (2020-10-05)

Bug Fixes

• Fixed bug to allow polling in the case of parameterized endpoints with relative polling urls #14097

1.8.1 (2020-09-08)

Bug fixes

• SAS credential replicated "/" fix #13159

1.8.0 (2020-08-10)

Features

• Support params as list for exploding parameters #12410

1.7.0 (2020-07-06)

Bug fixes

• AzureKeyCredentialPolicy will now accept (and ignore) passed in kwargs #11963
• Better error messages if passed endpoint is incorrect #12106
• Do not JSON encore a string if content type is "text" #12137

Features

• Added http_logging_policy property on the Configuration object, allowing users to individually set the http logging policy of the config #12218

1.6.0 (2020-06-03)

Bug fixes

• Fixed deadlocks in AsyncBearerTokenCredentialPolicy #11543
• Fix AttributeException in StreamDownloadGenerator #11462

Features

• Added support for changesets as part of multipart message support #10485
• Add AsyncLROPoller in azure.core.polling #10801
• Add get_continuation_token/from_continuation_token/polling_method methods in pollers (sync and async) #10801
• HttpResponse and PipelineContext objects are now pickable #10801

1.5.0 (2020-05-04)

Features

• Support "x-ms-retry-after-ms" in response header #10743
• link and link_from_headers now accepts attributes #10765

Bug fixes

• Not retry if the status code is less than 400 #10778
• "x-ms-request-id" is not considered safe header for logging #10967

1.4.0 (2020-04-06)

Features

• Support a default error type in map_error #9773
• Added AzureKeyCredential and its respective policy. #10509
• Added azure.core.polling.base_polling module with a "Microsoft One API" polling implementation #10090 Also contains the async version in azure.core.polling.async_base_polling
• Support kwarg enforce_https to disable HTTPS check on authentication #9821
• Support additional kwargs in HttpRequest.set_multipart_mixed that will be passed into pipeline context.

1.3.0 (2020-03-09)

Bug fixes

• Appended RequestIdPolicy to the default pipeline #9841
• Rewind the body position in async_retry #10117

Features

• Add raw_request_hook support in custom_hook_policy #9958
• Add timeout support in retry_policy #10011
• Add OdataV4 error format auto-parsing in all exceptions ('error' attribute) #9738

1.2.2 (2020-02-10)

Bug fixes

• Fixed a bug that sends None as request_id #9545
• Enable mypy for customers #9572
• Handle TypeError in deep copy #9620
• Fix text/plain content-type in decoder #9589

1.2.1 (2020-01-14)

Bug fixes

• Fixed a regression in 1.2.0 that was incompatible with azure-keyvault-* 4.0.0 #9462

1.2.0 (2020-01-14)

Features

• Add user_agent & sdk_moniker kwargs in UserAgentPolicy init #9355
• Support OPTIONS HTTP verb #9322
• Add tracing_attributes to tracing decorator #9297
• Support auto_request_id in RequestIdPolicy #9163
• Support fixed retry #6419
• Support "retry-after-ms" in response header #9240

Bug fixes

• Removed __enter__ and __exit__ from async context managers #9313

1.1.1 (2019-12-03)

Bug fixes

• Bearer token authorization requires HTTPS
• Rewind the body position in retry #8307

1.1.0 (2019-11-25)

Features

• New RequestIdPolicy #8437
• Enable logging policy in default pipeline #8053
• Normalize transport timeout. #8000 Now we have:
  • 'connection_timeout' - a single float in seconds for the connection timeout. Default 5min
  • 'read_timeout' - a single float in seconds for the read timeout. Default 5min

Bug fixes

• RequestHistory: deepcopy fails if request contains a stream #7732
• Retry: retry raises error if response does not have http_response #8629
• Client kwargs are now passed to DistributedTracingPolicy correctly #8051
• NetworkLoggingPolicy now logs correctly all requests in case of retry #8262

1.0.0 (2019-10-29)

Features

• Tracing: DistributedTracingPolicy now accepts kwargs network_span_namer to change network span name #7773
• Tracing: Implementation of AbstractSpan can now use the mixin HttpSpanMixin to get HTTP span update automatically #7773
• Tracing: AbstractSpan contract "change_context" introduced #7773
• Introduce new policy HttpLoggingPolicy #7988

Bug fixes

• Fix AsyncioRequestsTransport if input stream is an async generator #7743
• Fix form-data with aiohttp transport #7749

Breaking changes

• Tracing: AbstractSpan.set_current_span is longer supported. Use change_context instead. #7773
• azure.core.pipeline.policies.ContentDecodePolicy.deserialize_from_text changed

1.0.0b4 (2019-10-07)

Features

• Tracing: network span context is available with the TRACING_CONTEXT in pipeline response #7252

• Tracing: Span contract now has kind, traceparent and is a context manager #7252

• SansIOHTTPPolicy methods can now be coroutines #7497

• Add multipart/mixed support #7083:

  • HttpRequest now has a "set_multipart_mixed" method to set the parts of this request
  • HttpRequest now has a "prepare_multipart_body" method to build final body.
  • HttpResponse now has a "parts" method to return an iterator of parts
  • AsyncHttpResponse now has a "parts" methods to return an async iterator of parts
  • Note that multipart/mixed is a Python 3.x only feature

Bug fixes

• Tracing: policy cannot fail the pipeline, even in the worst condition #7252
• Tracing: policy pass correctly status message if exception #7252
• Tracing: incorrect span if exception raised from decorated function #7133
• Fixed urllib3 ConnectTimeoutError being raised by Requests during a socket timeout. Now this exception is caught and wrapped as a ServiceRequestError #7542

Breaking changes

• Tracing: azure.core.tracing.context removed

• Tracing: azure.core.tracing.context.tracing_context.with_current_context renamed to azure.core.tracing.common.with_current_context #7252

• Tracing: link renamed link_from_headers and link takes now a string

• Tracing: opencensus implementation has been moved to the package azure-core-tracing-opencensus

• Some modules and classes that were importables from several different places have been removed:

  • azure.core.HttpResponseError is now only azure.core.exceptions.HttpResponseError
  • azure.core.Configuration is now only azure.core.configuration.Configuration
  • azure.core.HttpRequest is now only azure.core.pipeline.transport.HttpRequest
  • azure.core.version module has been removed. Use azure.core.__version__ to get version number.
  • azure.core.pipeline_client has been removed. Import from azure.core instead.
  • azure.core.pipeline_client_async has been removed. Import from azure.core instead.
  • azure.core.pipeline.base has been removed. Import from azure.core.pipeline instead.
  • azure.core.pipeline.base_async has been removed. Import from azure.core.pipeline instead.
  • azure.core.pipeline.policies.base has been removed. Import from azure.core.pipeline.policies instead.
  • azure.core.pipeline.policies.base_async has been removed. Import from azure.core.pipeline.policies instead.
  • azure.core.pipeline.policies.authentication has been removed. Import from azure.core.pipeline.policies instead.
  • azure.core.pipeline.policies.authentication_async has been removed. Import from azure.core.pipeline.policies instead.
  • azure.core.pipeline.policies.custom_hook has been removed. Import from azure.core.pipeline.policies instead.
  • azure.core.pipeline.policies.redirect has been removed. Import from azure.core.pipeline.policies instead.
  • azure.core.pipeline.policies.redirect_async has been removed. Import from azure.core.pipeline.policies instead.
  • azure.core.pipeline.policies.retry has been removed. Import from azure.core.pipeline.policies instead.
  • azure.core.pipeline.policies.retry_async has been removed. Import from azure.core.pipeline.policies instead.
  • azure.core.pipeline.policies.distributed_tracing has been removed. Import from azure.core.pipeline.policies instead.
  • azure.core.pipeline.policies.universal has been removed. Import from azure.core.pipeline.policies instead.
  • azure.core.tracing.abstract_span has been removed. Import from azure.core.tracing instead.
  • azure.core.pipeline.transport.base has been removed. Import from azure.core.pipeline.transport instead.
  • azure.core.pipeline.transport.base_async has been removed. Import from azure.core.pipeline.transport instead.
  • azure.core.pipeline.transport.requests_basic has been removed. Import from azure.core.pipeline.transport instead.
  • azure.core.pipeline.transport.requests_asyncio has been removed. Import from azure.core.pipeline.transport instead.
  • azure.core.pipeline.transport.requests_trio has been removed. Import from azure.core.pipeline.transport instead.
  • azure.core.pipeline.transport.aiohttp has been removed. Import from azure.core.pipeline.transport instead.
  • azure.core.polling.poller has been removed. Import from azure.core.polling instead.
  • azure.core.polling.async_poller has been removed. Import from azure.core.polling instead.

1.0.0b3 (2019-09-09)

Bug fixes

• Fix aiohttp auto-headers #6992
• Add tracing to policies module init #6951

1.0.0b2 (2019-08-05)

Breaking changes

• Transport classes don't take config parameter anymore (use kwargs instead) #6372
• azure.core.paging has been completely refactored #6420
• HttpResponse.content_type attribute is now a string (was a list) #6490
• For StreamDownloadGenerator subclasses, response is now an HttpResponse, and not a transport response like aiohttp.ClientResponse or requests.Response. The transport response is available in internal_response attribute #6490

Bug fixes

• aiohttp is not required to import async pipelines classes #6496
• AsyncioRequestsTransport.sleep is now a coroutine as expected #6490
• RequestsTransport is not tight to ProxyPolicy implementation details anymore #6372
• AiohttpTransport does not raise on unexpected kwargs #6355

Features

• New paging base classes that support continuation_token and by_page() #6420
• Proxy support for AiohttpTransport #6372

1.0.0b1 (2019-06-26)

• Preview 1 release