Skip to content

commerce.md

Latest commit

 

History

History
68 lines (53 loc) · 2.06 KB

commerce.md

File metadata and controls

68 lines (53 loc) · 2.06 KB
title Azure Commerce SDK for Python
description Reference for Azure Commerce SDK for Python
ms.date 02/27/2026
ms.topic reference
ms.devlang python
ms.service commerce
manager routlaw
keywords Azure, python, SDK, API, Commerce

Azure Commerce libraries for python

Management API

pip install azure-mgmt-commerce

Create the commerce client

The following code creates an instance of the management client.

You will need to provide your subscription_id which can be retrieved from your subscription list.

See Resource Management Authentication for details on handling Azure Active Directory authentication with the Python SDK, and creating a Credentials instance.

from azure.mgmt.commerce import UsageManagementClient
from azure.common.credentials import UserPassCredentials

# Replace this with your subscription id
subscription_id = 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'

# See above for details on creating different types of AAD credentials
credentials = UserPassCredentials(
    'user@domain.com',	# Your user
    'my_password',		# Your password
)

commerce_client = UsageManagementClient(
    credentials,
    subscription_id
)

Get rate card

# OfferDurableID: https://azure.microsoft.com/en-us/support/legal/offer-details/
rate = commerce_client.rate_card.get(
    "OfferDurableId eq 'MS-AZR-0062P' and Currency eq 'USD' and Locale eq 'en-US' and RegionInfo eq 'US'"
)

Get Usage

from datetime import date, timedelta

# Takes onky dates in full ISO8601 with 'T00:00:00Z'
# Return an iterator like object: https://docs.python.org/3/library/stdtypes.html#iterator-types
usage_iterator = commerce_client.usage_aggregates.list(
    str(date.today() - timedelta(days=1))+'T00:00:00Z',
    str(date.today())+'T00:00:00Z'
)

[!div class="nextstepaction"] Explore the Management APIs