AutoRest: Python Client Runtime - Azure Module

.. image:: https://travis-ci.org/Azure/msrestazure-for-python.svg?branch=master
:target: https://travis-ci.org/Azure/msrestazure-for-python

.. image:: https://codecov.io/gh/azure/msrestazure-for-python/branch/master/graph/badge.svg
:target: https://codecov.io/gh/azure/msrestazure-for-python

Disclaimer

This package is deprecated and no longer receives updates

The authentication part of this package has been moved to azure-identity <https://pypi.org/project/azure-identity/>_
The other parts of this library are covered by azure-mgmt-core <https://pypi.org/project/azure-mgmt-core/>_

As such, we will no longer accept PR and fix issues on this project.

Installation

To install:

.. code-block:: bash

$ pip install msrestazure

Release History

2020-06-29 Version 0.6.4
++++++++++++++++++++++++

Bugfix

Unable to raise exception if JSON body contains UTF-8 characters on Python 2 #150

2020-03-17 Version 0.6.3
++++++++++++++++++++++++

Bugfix

Unable to raise exception if JSON body contains UTF-8 characters #144
Prepare old poller implementation to Python 3.9 #138

Features

Add Microsoft Graph to Cloud environment #142

Thanks to @psignoret and @tirkarthi for his contribution

2019-09-16 Version 0.6.2
++++++++++++++++++++++++

Bugfix

Fix ARM error parsing if Type info is used #135

2019-06-10 Version 0.6.1
++++++++++++++++++++++++

Features

Add User Assigned identity support for WebApp/Functions #124
Add timeout parameter for MSI token, is used from a VM #131

Thanks to @noelbundick for his contribution

2018-12-17 Version 0.6.0
++++++++++++++++++++++++

Features

Implementation of LRO async, based on msrest 0.6.x series (experimental)

Disclaimer

This version contains no direct breaking changes, but is bumped to 0.6.x since it requires a breaking change version of msrest.

Thanks to @gison93 for his documentation contribution

2018-11-01 Version 0.5.1
++++++++++++++++++++++++

Bugfixes

Fix CloudError if response and error message are provided at the same time #114
Fix LRO polling if last call is an empty Location (Autorest.Python 3.x only) #120

Features

Altered resource id parsing logic to allow for resource group IDs #117

2018-08-02 Version 0.5.0
++++++++++++++++++++++++

Features

Implementation is now using ADAL and not request-oauthlib. This allows more AD scenarios (like federated) #94
Add additionalInfo parsing for CloudError #102

Breaking changes

These breaking changes applies to ServicePrincipalCredentials, UserPassCredentials, AADTokenCredentials

Remove "auth_uri" attribute and parameter. This was unused.
Remove "state" attribute. This was unused.
Remove "client" attribute. This was exposed by mistake and should have been internal. No replacement is possible.
Remove "token_uri" attribute and parameter. Use "cloud_environment" and "tenant" to impact the login url now.
Remove token caching based on "keyring". Token caching should be implemented using ADAL now. This implies:
- Remove the "keyring" parameter
- Remove the "clear_cached_token" method
- Remove the "retrieve_session" method

2018-07-03 Version 0.4.35
+++++++++++++++++++++++++

Bugfixes

MSIAuthentication regression for KeyVault since IMDS support #109

2018-07-02 Version 0.4.34
+++++++++++++++++++++++++

Bugfixes

MSIAuthentication should initialize the token attribute on creation #106

2018-06-21 Version 0.4.33
+++++++++++++++++++++++++

Bugfixes

Fixes refreshToken in UserPassCredentials and AADTokenCredentials #103
Fix US government cloud definition #104

Thanks to mjcaley for his contribution

2018-06-13 Version 0.4.32
+++++++++++++++++++++++++

Features

Implement new LRO options of Autorest #101

Bug fixes

Reduce max MSI polling time for VM #100

2018-05-17 Version 0.4.31
+++++++++++++++++++++++++

Features

Improve MSI for VM token polling algorithm

2018-05-16 Version 0.4.30
+++++++++++++++++++++++++

Features

Allow ADAL 0.5.0 to 2.0.0 excluded as valid ADAL dependency

2018-04-30 Version 0.4.29
+++++++++++++++++++++++++

Bugfixes

Fix refresh Token on AADTokenCredentials (was broken in 0.4.27)
Now UserPasswordCredentials correctly use the refreshToken, and not user/password to refresh the session (was broken in 0.4.27)
Bring back keyring, with minimal dependency 12.0.2 that fixes the installation problem on old Python

2018-04-23 Version 0.4.28
+++++++++++++++++++++++++

Disclaimer

Do to some stability issues with "keyring" dependency that highly change from one system to another,
this package is no longer a dependency of "msrestazure".
If you were using the secured token cache of ServicePrincipalCredentials and UserPassCredentials,
the feature is still available, but you need to install manually "keyring". The functionnality will activate automatically.

2018-04-18 Version 0.4.27
+++++++++++++++++++++++++

Features

Implements new features of msrest 0.4.28 on session improvement. See msrest ChangeLog for details.

Update msrest dependency to 0.4.28

2018-04-17 Version 0.4.26
+++++++++++++++++++++++++

Bugfixes

IMDS/MSI: Retry on more error codes (#87)
IMDS/MSI: fix a boundary case on timeout (#86)

2018-03-29 Version 0.4.25
+++++++++++++++++++++++++

Features

MSIAuthentication now uses IMDS endpoint if available
MSIAuthentication can be used in any environment that defines MSI_ENDPOINT env variable

2018-03-26 Version 0.4.24
+++++++++++++++++++++++++

Bugfix

Fix parse_resource_id() tool to be case-insensitive to keywords when matching #81
Add missing baseclass init call for AdalAuthentication #82

2018-03-19 Version 0.4.23
+++++++++++++++++++++++++

Bugfix

Fix LRO result if POST uses AsyncOperation header (Autorest.Python 3.0 only) #79

2018-02-27 Version 0.4.22
+++++++++++++++++++++++++

Bugfix

Remove a possible infinite loop with MSIAuthentication #77

Disclaimer

From this version, MSIAuthentication will fail instantly if you try to get MSI token
from a VM where the extension is not installed, or not yet ready.
You need to do your own retry mechanism if you think the extension is provisioning and
the call might succeed later.
This behavior is consistent with other Azure SDK implementation of MSI scenarios.

2018-01-26 Version 0.4.21
+++++++++++++++++++++++++

Update allowed ADAL dependency to 0.5.x

2018-01-08 Version 0.4.20
+++++++++++++++++++++++++

Features

CloudError now includes the "innererror" attribute to match OData v4 #73
Introduces ARMPolling implementation of Azure Resource Management LRO. Requires msrest 0.4.25 (new dependency).
This is used by code generated with Autorest.Python 3.0, and is not used by code generated by previous Autorest version.
Change msrest dependency to ">=0.4.25,<2.0.0" to allow (future) msrest 1.0.0 as compatible dependency.

Thank you to demyanenko for his contribution.

2017-12-14 Version 0.4.19
+++++++++++++++++++++++++

Feature

Improve MSIAuthentication to support User Assigned Identity #70

Bugfixes

Fix session obj for cloudmetadata endpoint #67
Fix authentication resource node for AzureSatck #65
Better detection of AppService with MSIAuthentication #70

2017-12-01 Version 0.4.18
+++++++++++++++++++++++++

Bugfixes

get_cloud_from_metadata_endpoint incorrect on AzureStack #62
get_cloud_from_metadata_endpoint certificate issue #61

2017-11-22 Version 0.4.17
+++++++++++++++++++++++++

Bugfixes

Fix AttributeError if error JSON from ARM does not follow ODatav4 (as it should)

2017-10-31 Version 0.4.16
+++++++++++++++++++++++++

Bugfixes

Fix AttributeError if input JSON is not a dict (#54)

2017-10-13 Version 0.4.15
+++++++++++++++++++++++++

Features

Add support for WebApp/Functions in MSIAuthentication classes
Add parse_resource_id(), resource_id(), validate_resource_id() to parse ARM ids
Retry strategy now n reach 24 seconds (instead of 12 seconds)

2017-09-11 Version 0.4.14
+++++++++++++++++++++++++

Features

Add Managed Service Integrated (MSI) authentication

Bug fix

Fix AdalError handling in some scenarios (#44)

Thank you to Hexadite-Omer for his contribution

2017-08-24 Version 0.4.13
+++++++++++++++++++++++++

Features

"keyring" is now completely optional

2017-08-23 Version 0.4.12
+++++++++++++++++++++++++

Features

add "timeout" to ServicePrincipalCredentials and UserPasswordCredentials
Threads created by AzureOperationPoller have now a name prefixed by "AzureOperationPoller" to help identify them

Bugfixes

Do not fail if keyring is badly installed
Update Azure Gov login endpoint
Update metadata ARM endpoint parser

Breaking changes

Remove InteractiveCredentials. This class was deprecated and unusable. Use ADAL device code instead.

2017-06-29 Version 0.4.11
+++++++++++++++++++++++++

Features

Add cloud definitions for public Azure, German Azure, China Azure and Azure Gov
Add get_cloud_from_metadata_endpoint to automatically create a Cloud object from an ARM endpoint
Add cloud_environment to all Credentials objects (except AdalAuthentication)

Note

This deprecates "china=True", to be replaced by "cloud_environment=AZURE_CHINA_CLOUD"

Example:

.. code:: python

from msrestazure.azure_cloud import AZURE_CHINA_CLOUD
from msrestazure.azure_active_directory import UserPassCredentials

credentials = UserPassCredentials(
login,
password,
cloud_environment=AZURE_CHINA_CLOUD
)

base_url of SDK client can be pointed to "cloud_environment.endpoints.resource_manager" for basic scenario:

Example:

.. code:: python

from msrestazure.azure_cloud import AZURE_CHINA_CLOUD
from msrestazure.azure_active_directory import UserPassCredentials
from azure.mgmt.resource import ResourceManagementClient

credentials = UserPassCredentials(
login,
password,
cloud_environment=AZURE_CHINA_CLOUD
)
client = ResourceManagementClient(
credentials,
subscription_id,
base_url=AZURE_CHINA_CLOUD.endpoints.resource_manager
)

Azure Stack connection can be done:

.. code:: python

from msrestazure.azure_cloud import get_cloud_from_metadata_endpoint
from msrestazure.azure_active_directory import UserPassCredentials
from azure.mgmt.resource import ResourceManagementClient

mystack_cloud = get_cloud_from_metadata_endpoint("https://myazurestack-arm-endpoint.com")
credentials = UserPassCredentials(
login,
password,
cloud_environment=mystack_cloud
)
client = ResourceManagementClient(
credentials,
subscription_id,
base_url=mystack_cloud.endpoints.resource_manager
)

2017-06-27 Version 0.4.10
+++++++++++++++++++++++++

Bugfixes

Accept PATCH/201 as LRO valid state
Close token session on exit (ServicePrincipal and UserPassword credentials)

2017-06-19 Version 0.4.9
++++++++++++++++++++++++

Features

Add proxies parameters to ServicePrincipal and UserPassword credentials class #29
Add automatic Azure provider registration if needed (requires msrest 0.4.10) #28

Thank you to likel for his contribution

2017-05-31 Version 0.4.8
++++++++++++++++++++++++

Bugfixes

Fix LRO if first call never returns 200, but ends on 201 (#26)
FiX LRO AttributeError if timeout is short (#21)

Features

Expose a "status()" method in AzureOperationPoller (#18)

2017-01-23 Version 0.4.7
++++++++++++++++++++++++

Bugfixes

Adding accept_language and generate_client_request_id default values

2016-12-12 Version 0.4.6
++++++++++++++++++++++++

Bugfixes

Refactor Long Running Operation algorithm.

There is no breaking changes, however you might need to record again your offline HTTP records
if you use unittests with VCRpy.
Fix a couple of latent bugs

2016-11-30 Version 0.4.5
++++++++++++++++++++++++

New features

Add AdalAuthentification class to wrap ADAL library (https://github.com/Azure/msrestazure-for-python/pull/8)

2016-10-17 Version 0.4.4
++++++++++++++++++++++++

Bugfixes

More informative and well-formed CloudError exceptions (https://github.com/Azure/autorest/issues/1460)
Raise CustomException is defined in Swagger (https://github.com/Azure/autorest/issues/1404)

2016-09-14 Version 0.4.3
++++++++++++++++++++++++

Bugfixes

Make AzureOperationPoller thread as daemon (do not block anymore a Ctrl+C) (https://github.com/Azure/autorest/pull/1379)

2016-09-01 Version 0.4.2
++++++++++++++++++++++++

Bugfixes

Better exception message (https://github.com/Azure/autorest/pull/1300)

This version needs msrest >= 0.4.3

2016-06-08 Version 0.4.1
++++++++++++++++++++++++

Bugfixes

Fix for LRO PUT operation https://github.com/Azure/autorest/issues/1133

2016-05-25 Version 0.4.0
++++++++++++++++++++++++

Update msrest dependency to 0.4.0

Bugfixes

Fix for several AAD issues https://github.com/Azure/autorest/issues/1055
Fix for LRO PATCH bug and refactor https://github.com/Azure/autorest/issues/993

Behaviour changes

Needs Autorest > 0.17.0 Nightly 20160525

2016-04-26 Version 0.3.0
++++++++++++++++++++++++

Update msrest dependency to 0.3.0

Bugfixes

Read only values are no longer in init or sent to the server (https://github.com/Azure/autorest/pull/959)
Useless kwarg removed

Behaviour changes

Needs Autorest > 0.16.0 Nightly 20160426

2016-03-31 Version 0.2.1
++++++++++++++++++++++++

Bugfixes

Fix AzurePollerOperation if Swagger defines provisioning status as enum type (https://github.com/Azure/autorest/pull/892)

2016-03-25 Version 0.2.0
++++++++++++++++++++++++

Update msrest dependency to 0.2.0

Behaviour change

async methods called with raw=True don't return anymore AzureOperationPoller but ClientRawResponse
Needs Autorest > 0.16.0 Nightly 20160324

2016-03-21 Version 0.1.2
++++++++++++++++++++++++

Update msrest dependency to 0.1.3

Bugfixes

AzureOperationPoller.wait() failed to raise exception if query error (https://github.com/Azure/autorest/pull/856)

2016-03-04 Version 0.1.1
++++++++++++++++++++++++

Bugfixes

Source package corrupted in Pypi (https://github.com/Azure/autorest/issues/799)

2016-03-04 Version 0.1.0
++++++++++++++++++++++++

Behaviour change

Replaced _required attribute in CloudErrorData class with _validation dict.

2016-02-29 Version 0.0.2
++++++++++++++++++++++++

Bugfixes

Fixed AAD bug to include connection verification in UserPassCredentials. (https://github.com/Azure/autorest/pull/725)
Source package corrupted in Pypi (https://github.com/Azure/autorest/issues/718)

2016-02-19 Version 0.0.1
++++++++++++++++++++++++

Initial release.

Dependencies of msrestazure (3).
Dependency	Optional
adal	false
msrest	false
six	false

Package profile

msrestazure

Releases

Release table

PyPI Downloads

Dependencies

Details

Project URLs

Dependencies

Package description