Microsoft Azure Billing Client Library for Python

Warnings

• breaking Version 7.0.0 introduced significant breaking changes, including the deletion or renaming of client operation groups such as 'BillingManagementClient.instructions', 'BillingManagementClient.billing_role_definitions', and 'BillingManagementClient.billing_periods'. Additionally, the 'Agreement' model had its 'agreement_link', 'category', 'acceptance_mode', and 'effective_date' instance variables deleted or renamed.
  Fix: Refer to the official SDK documentation for 7.0.0 to update usage patterns and model properties. Re-evaluate calls to affected operation groups and model attributes.
• breaking The Azure SDK for Python underwent a major regeneration around version 6.0.0. This change revamped the credential system (deprecating `azure.common.credentials` and `msrestazure.azure_active_directory` in favor of `azure-identity`), renamed the `credentials` parameter to `credential`, removed the `config` attribute from clients, and introduced the `begin_` prefix for long-running asynchronous operations (LROs).
  Fix: Migrate authentication to `azure-identity.DefaultAzureCredential`. Update client instantiation to pass configuration as keyword arguments. Add the `begin_` prefix to LRO method calls and handle the `LROPoller` return type.
• deprecated Support for Python 2.7 in Azure SDK Python packages officially ended on January 1, 2022. Using this library with Python 2.7 is unsupported and may lead to security vulnerabilities or unexpected behavior.
  Fix: Upgrade your Python environment to Python 3.8 or higher. The current version of azure-mgmt-billing requires Python 3.8+.
• gotcha Many resource management operations in the Azure SDK for Python (especially those involving creating, updating, or deleting resources) are asynchronous and return an `LROPoller` object. These methods are typically prefixed with `begin_`.
  Fix: When calling a method prefixed with `begin_`, remember that it returns a poller. You must call `.result()` on the poller to wait for the operation to complete and get its final result (e.g., `resource = client.resource_groups.begin_create_or_update(...).result()`).

Install

• pip install azure-mgmt-billing azure-identity Install stable version with identity

Imports

• BillingManagementClient

  from azure.mgmt.billing import BillingManagementClient

• DefaultAzureCredential

  from azure.identity import DefaultAzureCredential

Quickstart

Initializes the BillingManagementClient using DefaultAzureCredential for authentication. This requires Azure Active Directory environment variables (AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET) and AZURE_SUBSCRIPTION_ID to be set. It then demonstrates how to create a client instance.

import os
from azure.identity import DefaultAzureCredential
from azure.mgmt.billing import BillingManagementClient

# Set these environment variables for authentication
# AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET
# AZURE_SUBSCRIPTION_ID (for billing operations)

subscription_id = os.environ.get('AZURE_SUBSCRIPTION_ID', 'YOUR_SUBSCRIPTION_ID')

# Authenticate using DefaultAzureCredential
credential = DefaultAzureCredential()

# Create a BillingManagementClient
billing_client = BillingManagementClient(credential=credential, subscription_id=subscription_id)

# Example: List billing accounts (this operation might not require subscription_id directly, 
# but the client is often initialized with it for consistency across management clients)
# Replace with an actual operation relevant to your billing scenario
# For example: print(list(billing_client.billing_accounts.list()))
print('BillingManagementClient initialized successfully.')