Skip to main content

AutoRest swagger generator Python client runtime. Azure-specific module.

Project description

https://travis-ci.org/Azure/msrestazure-for-python.svg?branch=master https://codecov.io/gh/azure/msrestazure-for-python/branch/master/graph/badge.svg

Installation

To install:

$ pip install msrestazure

Release History

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:

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:

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:

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

2016-10-17 Version 0.4.4

Bugfixes

2016-09-14 Version 0.4.3

Bugfixes

2016-09-01 Version 0.4.2

Bugfixes

This version needs msrest >= 0.4.3

2016-06-08 Version 0.4.1

Bugfixes

2016-05-25 Version 0.4.0

Update msrest dependency to 0.4.0

Bugfixes

Behaviour changes

  • Needs Autorest > 0.17.0 Nightly 20160525

2016-04-26 Version 0.3.0

Update msrest dependency to 0.3.0

Bugfixes

Behaviour changes

  • Needs Autorest > 0.16.0 Nightly 20160426

2016-03-31 Version 0.2.1

Bugfixes

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

2016-03-04 Version 0.1.1

Bugfixes

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

2016-02-19 Version 0.0.1

  • Initial release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

msrestazure-0.6.0.tar.gz (33.2 kB view details)

Uploaded Source

Built Distribution

msrestazure-0.6.0-py2.py3-none-any.whl (39.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file msrestazure-0.6.0.tar.gz.

File metadata

  • Download URL: msrestazure-0.6.0.tar.gz
  • Upload date:
  • Size: 33.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.7

File hashes

Hashes for msrestazure-0.6.0.tar.gz
Algorithm Hash digest
SHA256 99b185dcfc94f4ac2f7792691b865958c5a9871281cd618c50963c6b8d23401b
MD5 7ba57eef6c1cafd91650a1117292ba77
BLAKE2b-256 a3a89c97984f706491c47fd30b113cf0ecc90ad6e61d86d37cd3ca05d2cb3444

See more details on using hashes here.

File details

Details for the file msrestazure-0.6.0-py2.py3-none-any.whl.

File metadata

  • Download URL: msrestazure-0.6.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 39.4 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.7

File hashes

Hashes for msrestazure-0.6.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 86695c9728e91ee6f4cbb3b6e82ebd92233b72b6e145f7dcafa6b2da17412b88
MD5 7b528699b4c60220924b3cfefdd99eca
BLAKE2b-256 46ba7870308e3d3b4b3956880eed2df20669a5690436793e6fc1442c8b73e01c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page