NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #3647 most downloaded on PyPI
Microsoft Azure Consumption Management Client Library for Python
Last release 2 months ago
20 Jul 2026
Release timing varies
gaps range from 4 weeks to 3.5 years
Nearly every release is documented
notes for 9 of 9 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
12 releases · first in 2017
Client ConsumptionManagementClient added parameter cloud_setting in method __init__
ConsumptionManagementClient added parameter cloud_setting in method __init__ConsumptionManagementClient added parameter polling_interval in method __init__ConsumptionManagementClient added method send_requestBalance added property system_dataBudget added property system_dataChargeSummary added property etagChargeSummary added property system_dataCreditSummary added property system_dataEventSummary added property system_dataLegacyChargeSummary added property etagLegacyChargeSummary added property system_dataLegacyReservationRecommendation added property system_dataLegacyReservationRecommendationProperties added property last_usage_dateLegacyReservationRecommendationProperties added property total_hoursLegacySharedScopeReservationRecommendationProperties added property last_usage_dateLegacySharedScopeReservationRecommendationProperties added property total_hoursLegacySingleScopeReservationRecommendationProperties added property last_usage_dateLegacySingleScopeReservationRecommendationProperties added property total_hoursLegacyUsageDetail added property system_dataLotSummary added property system_dataManagementGroupAggregatedCostResult added property system_dataMarketplace added property system_dataModernChargeSummary added property etagModernChargeSummary added property system_dataModernReservationRecommendation added property system_dataModernReservationTransaction added property system_dataModernUsageDetail added property system_dataPriceSheetProperties added property savings_planPriceSheetResult added property system_dataProxyResource added property system_dataReservationDetail added property system_dataReservationRecommendation added property system_dataReservationRecommendationDetailsModel added property system_dataReservationSummary added property system_dataReservationTransaction added property system_dataResource added property system_dataTagsResult added property system_dataTerm added member P1_MUsageDetail added property system_dataCreatedByTypeErrorAdditionalInfoExtensionResourceModernSharedScopeReservationRecommendationPropertiesModernSingleScopeReservationRecommendationPropertiesOperationStatusOperationStatusTypeOrganizationTypePricesheetDownloadPropertiesSavingsPlanSystemDataBudgetsOperations added parameter content_type in method create_or_updatePriceSheetOperations added method begin_download_by_billing_account_periodReservationRecommendationDetailsOperations added parameter filter in method getReservationTransactionsOperations added parameter preview_markup_percentage in method listReservationTransactionsOperations added parameter use_markup_if_partner in method listBalance moved instance variable adjustment_details, adjustments, azure_marketplace_service_charges, beginning_balance, billing_frequency, charges_billed_separately, currency, ending_balance, new_purchases, new_purchases_details, price_hidden, service_overage, total_overage, total_usage and utilized under property properties whose type is BalancePropertiesBudget moved instance variable amount, category, current_spend, filter, forecast_spend, notifications, time_grain and time_period under property properties whose type is BudgetPropertiesBudgetComparisonExpression renamed its instance variable values to values_propertyBudgetOperatorType.IN_ENUM to INCreditSummary moved instance variable balance_summary, billing_currency, credit_currency, expired_credit, pending_credit_adjustments, pending_eligible_charges and reseller under property properties whose type is CreditSummaryPropertiesEventSummary moved instance variable adjustments, adjustments_in_billing_currency, billing_currency, billing_profile_display_name, billing_profile_id, canceled_credit, charges, charges_in_billing_currency, closed_balance, closed_balance_in_billing_currency, credit_currency, credit_expired, credit_expired_in_billing_currency, description, event_type, invoice_number, lot_id, lot_source, new_credit, new_credit_in_billing_currency, reseller and transaction_date under property properties whose type is EventPropertiesLegacyChargeSummary moved instance variable azure_charges, billing_period_id, charges_billed_separately, currency, usage_end and usage_start under property properties whose type is LegacyChargeSummaryPropertiesLegacyReservationRecommendation moved instance variable cost_with_no_reserved_instances, first_usage_date, instance_flexibility_group, instance_flexibility_ratio, look_back_period, meter_id, net_savings, normalized_size, recommended_quantity, recommended_quantity_normalized, resource_type, scope, sku_properties, term and total_cost_with_reserved_instances under property properties whose type is LegacyReservationRecommendationPropertiesLegacyUsageDetail moved instance variable account_name, account_owner_id, additional_info, benefit_id, benefit_name, billing_account_id, billing_account_name, billing_currency, billing_period_end_date, billing_period_start_date, billing_profile_id, billing_profile_name, charge_type, consumed_service, cost, cost_center, date, effective_price, frequency, invoice_section, is_azure_credit_eligible, meter_details, meter_id, offer_id, part_number, pay_g_price, plan_name, pricing_model, product, product_order_id, product_order_name, publisher_name, publisher_type, quantity, reservation_id, reservation_name, resource_group, resource_id, resource_location, resource_name, service_info1, service_info2, subscription_id, subscription_name, term and unit_price under property properties whose type is LegacyUsageDetailPropertiesLotSummary moved instance variable billing_currency, closed_balance, closed_balance_in_billing_currency, credit_currency, expiration_date, original_amount, original_amount_in_billing_currency, po_number, purchased_date, reseller, source, start_date and status under property properties whose type is LotPropertiesManagementGroupAggregatedCostResult moved instance variable azure_charges, billing_period_id, charges_billed_separately, children, currency, excluded_subscriptions, included_subscriptions, marketplace_charges, usage_end and usage_start under property properties whose type is ManagementGroupAggregatedCostPropertiesMarketplace moved instance variable account_name, additional_info, billing_period_id, consumed_quantity, consumed_service, cost_center, currency, department_name, instance_id, instance_name, is_estimated, is_recurring_charge, meter_id, offer_name, order_number, plan_name, pretax_cost, publisher_name, resource_group, resource_rate, subscription_guid, subscription_name, unit_of_measure, usage_end and usage_start under property properties whose type is MarketplacePropertiesModernChargeSummary moved instance variable azure_charges, billing_account_id, billing_period_id, billing_profile_id, charges_billed_separately, customer_id, invoice_section_id, is_invoiced, marketplace_charges, usage_end and usage_start under property properties whose type is ModernChargeSummaryPropertiesModernReservationRecommendation moved instance variable cost_with_no_reserved_instances, first_usage_date, instance_flexibility_group, instance_flexibility_ratio, look_back_period, meter_id, net_savings, normalized_size, recommended_quantity, recommended_quantity_normalized, scope, sku_name, sku_properties, term and total_cost_with_reserved_instances under property properties whose type is ModernReservationRecommendationPropertiesModernReservationTransaction moved instance variable amount, arm_sku_name, billing_frequency, billing_profile_id, billing_profile_name, currency, description, event_date, event_type, invoice, invoice_id, invoice_section_id, invoice_section_name, purchasing_subscription_guid, purchasing_subscription_name, quantity, region, reservation_order_id, reservation_order_name and term under property properties whose type is ModernReservationTransactionPropertiesModernUsageDetail moved instance variable additional_info, benefit_id, benefit_name, billing_account_id, billing_account_name, billing_currency_code, billing_period_end_date, billing_period_start_date, billing_profile_id, billing_profile_name, charge_type, consumed_service, cost_allocation_rule_name, cost_center, cost_in_billing_currency, cost_in_pricing_currency, cost_in_usd, customer_name, customer_tenant_id, date, effective_price, exchange_rate, exchange_rate_date, exchange_rate_pricing_to_billing, frequency, instance_name, invoice_id, invoice_section_id, invoice_section_name, is_azure_credit_eligible, market_price, meter_category, meter_id, meter_name, meter_region, meter_sub_category, partner_earned_credit_applied, partner_earned_credit_rate, partner_name, partner_tenant_id, pay_g_price, payg_cost_in_billing_currency, payg_cost_in_usd, previous_invoice_id, pricing_currency_code, pricing_model, product, product_identifier, product_order_id, product_order_name, provider, publisher_id, publisher_name, publisher_type, quantity, reseller_mpn_id, reseller_name, reservation_id, reservation_name, resource_group, resource_location, resource_location_normalized, service_family, service_info1, service_info2, service_period_end_date, service_period_start_date, subscription_guid, subscription_name, term, unit_of_measure and unit_price under property properties whose type is ModernUsageDetailPropertiesPriceSheetResult moved instance variable download, next_link and pricesheets under property properties whose type is PriceSheetModelReservationDetail moved instance variable instance_flexibility_group, instance_flexibility_ratio, instance_id, kind, reservation_id, reservation_order_id, reserved_hours, sku_name, total_reserved_quantity, usage_date and used_hours under property properties whose type is ReservationDetailPropertiesReservationRecommendationDetailsModel moved instance variable currency, resource, resource_group, savings, scope and usage under property properties whose type is ReservationRecommendationDetailsPropertiesReservationSummary moved instance variable avg_utilization_percentage, kind, max_utilization_percentage, min_utilization_percentage, purchased_quantity, remaining_quantity, reservation_id, reservation_order_id, reserved_hours, sku_name, total_reserved_quantity, usage_date, used_hours, used_quantity and utilized_percentage under property properties whose type is ReservationSummaryPropertiesReservationTransaction moved instance variable account_name, account_owner_email, amount, arm_sku_name, billing_frequency, billing_month, cost_center, currency, current_enrollment, department_name, description, event_date, event_type, monetary_commitment, overage, purchasing_enrollment, purchasing_subscription_guid, purchasing_subscription_name, quantity, region, reservation_order_id, reservation_order_name and term under property properties whose type is LegacyReservationTransactionPropertiesTagsResult moved instance variable next_link, previous_link and tags under property properties whose type is TagPropertiesResource deleted or renamed its instance variable etagResource deleted or renamed its instance variable tagsLegacyChargeSummary deleted or renamed its instance variable e_tagLegacyChargeSummary deleted or renamed its instance variable marketplace_chargesModernChargeSummary deleted or renamed its instance variable e_tagChargeSummary deleted or renamed its instance variable e_tagProxyResource deleted or renamed its instance variable e_tagEventSummary deleted or renamed its instance variable e_tag_properties_e_tagLotSummary deleted or renamed its instance variable e_tag_properties_e_tagModernReservationRecommendation deleted or renamed its instance variable location_properties_locationErrorDetails to ErrorDetailChargesOperations.list changed its parameter apply/end_date/start_date from positional_or_keyword to keyword_onlyEventsOperations.list_by_billing_profile changed its parameter end_date/start_date from positional_or_keyword to keyword_onlyMarketplacesOperations.list changed its parameter skiptoken from positional_or_keyword to keyword_onlyPriceSheetOperations.get changed its parameter expand/skiptoken from positional_or_keyword to keyword_onlyPriceSheetOperations.get_by_billing_period changed its parameter expand/skiptoken from positional_or_keyword to keyword_onlyReservationRecommendationDetailsOperations.get changed its parameter look_back_period/product/region/scope/term from positional_or_keyword to keyword_onlyReservationsDetailsOperations.list changed its parameter end_date/reservation_id/reservation_order_id/start_date from positional_or_keyword to keyword_onlyReservationsSummariesOperations.list changed its parameter end_date/grain/reservation_id/reservation_order_id/start_date from positional_or_keyword to keyword_onlyReservationsSummariesOperations.list_by_reservation_order changed its parameter grain from positional_or_keyword to keyword_onlyReservationsSummariesOperations.list_by_reservation_order_and_reservation changed its parameter grain from positional_or_keyword to keyword_onlyUsageDetailsOperations.list changed its parameter expand/metric/skiptoken from positional_or_keyword to keyword_onlyBudgetsListResult/Events/Lots/MarketplacesListResult/ModernReservationTransactionsListResult/OperationListResult/ReservationDetailsListResult/ReservationSummariesListResult/ReservationTransactionsListResult/UsageDetailsListResult which actually were not used by SDK usersDownloadProperties/LegacyReservationTransaction/ReservationRecommendationsListResult/ReservationTransactionResource/ResourceAttributes which actually were not used by SDK usersBudgetsOperations.list changed return type from Iterable[BudgetsListResult] to ItemPaged[Budget]EventsOperations.list_by_billing_account changed return type from Iterable[Events] to ItemPaged[EventSummary]EventsOperations.list_by_billing_profile changed return type from Iterable[Events] to ItemPaged[EventSummary]LotsOperations.list_by_billing_account changed return type from Iterable[Lots] to ItemPaged[LotSummary]LotsOperations.list_by_billing_profile changed return type from Iterable[Lots] to ItemPaged[LotSummary]LotsOperations.list_by_customer changed return type from Iterable[Lots] to ItemPaged[LotSummary]MarketplacesOperations.list changed return type from Iterable[MarketplacesListResult] to ItemPaged[Marketplace]Operations.list changed return type from Iterable[OperationListResult] to ItemPaged[Operation]ReservationRecommendationsOperations.list changed return type from Iterable[ReservationRecommendationsListResult] to ItemPaged[ReservationRecommendation]ReservationTransactionsOperations.list changed return type from Iterable[ReservationTransactionsListResult] to ItemPaged[ReservationTransaction]ReservationTransactionsOperations.list_by_billing_profile changed return type from Iterable[ModernReservationTransactionsListResult] to ItemPaged[ModernReservationTransaction]ReservationsDetailsOperations.list changed return type from Iterable[ReservationDetailsListResult] to ItemPaged[ReservationDetail]ReservationsDetailsOperations.list_by_reservation_order changed return type from Iterable[ReservationDetailsListResult] to ItemPaged[ReservationDetail]ReservationsDetailsOperations.list_by_reservation_order_and_reservation changed return type from Iterable[ReservationDetailsListResult] to ItemPaged[ReservationDetail]ReservationsSummariesOperations.list changed return type from Iterable[ReservationSummariesListResult] to ItemPaged[ReservationSummary]ReservationsSummariesOperations.list_by_reservation_order changed return type from Iterable[ReservationSummariesListResult] to ItemPaged[ReservationSummary]ReservationsSummariesOperations.list_by_reservation_order_and_reservation changed return type from Iterable[ReservationSummariesListResult] to ItemPaged[ReservationSummary]UsageDetailsOperations.list changed return type from Iterable[UsageDetailsListResult] to ItemPaged[UsageDetail]One column per quarter.
Client ConsumptionManagementClient added parameter cloud_setting in method __init__
ConsumptionManagementClient added parameter cloud_setting in method __init__ConsumptionManagementClient added method send_requestBalance added property system_dataBudget added property system_dataChargeSummary added property system_dataCreditSummary added property tagsCreditSummary added property system_dataEventSummary added property system_dataLegacyChargeSummary added property system_dataLegacyReservationRecommendation added property system_dataLegacyReservationRecommendationProperties added property last_usage_dateLegacyReservationRecommendationProperties added property total_hoursLegacySharedScopeReservationRecommendationProperties added property last_usage_dateLegacySharedScopeReservationRecommendationProperties added property total_hoursLegacySingleScopeReservationRecommendationProperties added property last_usage_dateLegacySingleScopeReservationRecommendationProperties added property total_hoursLegacyUsageDetail added property system_dataLotSummary added property system_dataManagementGroupAggregatedCostResult added property system_dataMarketplace added property system_dataModernChargeSummary added property system_dataModernReservationRecommendation added property system_dataModernReservationRecommendationProperties added property last_usage_dateModernReservationRecommendationProperties added property total_hoursModernReservationTransaction added property system_dataModernSharedScopeReservationRecommendationProperties added property last_usage_dateModernSharedScopeReservationRecommendationProperties added property total_hoursModernSingleScopeReservationRecommendationProperties added property last_usage_dateModernSingleScopeReservationRecommendationProperties added property total_hoursModernUsageDetail added property system_dataPriceSheetProperties added property savings_planPriceSheetResult added property system_dataProxyResource added property system_dataReservationDetail added property system_dataReservationRecommendation added property system_dataReservationRecommendationDetailsModel added property system_dataReservationSummary added property system_dataReservationTransaction added property system_dataResource added property system_dataTagsResult added property system_dataTerm added member P1_MUsageDetail added property system_dataCreatedByTypeErrorAdditionalInfoErrorDetailExtensionResourceOperationStatusOperationStatusTypeOrganizationTypePricesheetDownloadPropertiesSavingsPlanSystemDataPriceSheetOperations added method begin_download_by_billing_account_periodReservationRecommendationDetailsOperations added parameter filter in method getReservationTransactionsOperations added parameter use_markup_if_partner in method listReservationTransactionsOperations added parameter preview_markup_percentage in method listBudgetComparisonExpression renamed its instance variable values to values_propertyChargeSummary deleted or renamed its instance variable tagsEventSummary moved instance variable transaction_date, description, new_credit, adjustments, credit_expired, charges, closed_balance, event_type, invoice_number, billing_profile_id, billing_profile_display_name, lot_id, lot_source, canceled_credit, credit_currency, billing_currency, reseller, credit_expired_in_billing_currency, new_credit_in_billing_currency, adjustments_in_billing_currency, charges_in_billing_currency, closed_balance_in_billing_currency and e_tag_properties_e_tag under property properties whose type is EventPropertiesLegacyReservationRecommendation moved instance variable look_back_period, instance_flexibility_ratio, instance_flexibility_group, normalized_size, recommended_quantity_normalized, meter_id, resource_type, term, cost_with_no_reserved_instances, recommended_quantity, total_cost_with_reserved_instances, net_savings, first_usage_date, scope and sku_properties under property properties whose type is LegacyReservationRecommendationPropertiesLotSummary moved instance variable original_amount, closed_balance, source, start_date, expiration_date, po_number, purchased_date, status, credit_currency, billing_currency, original_amount_in_billing_currency, closed_balance_in_billing_currency, reseller and e_tag_properties_e_tag under property properties whose type is LotPropertiesManagementGroupAggregatedCostResult moved instance variable billing_period_id, usage_start, usage_end, azure_charges, marketplace_charges, charges_billed_separately, currency, children, included_subscriptions and excluded_subscriptions under property properties whose type is ManagementGroupAggregatedCostPropertiesModernReservationRecommendation moved instance variable location_properties_location, look_back_period, instance_flexibility_ratio, instance_flexibility_group, normalized_size, recommended_quantity_normalized, meter_id, term, cost_with_no_reserved_instances, recommended_quantity, resource_type, total_cost_with_reserved_instances, net_savings, first_usage_date, scope, sku_properties and sku_name under property properties whose type is ModernReservationRecommendationPropertiesPriceSheetResult moved instance variable pricesheets, next_link and download under property properties whose type is PriceSheetModelProxyResource deleted or renamed its instance variable e_tagReservationRecommendationDetailsModel moved instance variable currency, resource, resource_group, savings, scope and usage under property properties whose type is ReservationRecommendationDetailsPropertiesReservationTransaction moved instance variable event_date, reservation_order_id, description, event_type, quantity, amount, currency, reservation_order_name, purchasing_enrollment, purchasing_subscription_guid, purchasing_subscription_name, arm_sku_name, term, region, account_name, account_owner_email, department_name, cost_center, current_enrollment, billing_frequency, billing_month, monetary_commitment and overage under property properties whose type is LegacyReservationTransactionPropertiesResource deleted or renamed its instance variable etagResource deleted or renamed its instance variable tagsTagsResult moved instance variable tags, next_link and previous_link under property properties whose type is TagPropertiesChargesOperations.list changed its parameter start_date/end_date/apply from positional_or_keyword to keyword_onlyEventsOperations.list_by_billing_profile changed its parameter start_date/end_date from positional_or_keyword to keyword_onlyMarketplacesOperations.list changed its parameter skiptoken from positional_or_keyword to keyword_onlyPriceSheetOperations.get changed its parameter expand/skiptoken from positional_or_keyword to keyword_onlyPriceSheetOperations.get_by_billing_period changed its parameter expand/skiptoken from positional_or_keyword to keyword_onlyReservationRecommendationDetailsOperations.get changed its parameter scope/region/term/look_back_period/product from positional_or_keyword to keyword_onlyReservationsDetailsOperations.list changed its parameter start_date/end_date/reservation_id/reservation_order_id from positional_or_keyword to keyword_onlyReservationsSummariesOperations.list changed its parameter grain/start_date/end_date/reservation_id/reservation_order_id from positional_or_keyword to keyword_onlyReservationsSummariesOperations.list_by_reservation_order changed its parameter grain from positional_or_keyword to keyword_onlyReservationsSummariesOperations.list_by_reservation_order_and_reservation changed its parameter grain from positional_or_keyword to keyword_onlyUsageDetailsOperations.list changed its parameter expand/skiptoken/metric from positional_or_keyword to keyword_onlyDownloadProperties/ErrorDetails/Events/LegacyReservationTransaction/Lots/ReservationTransactionResource/ResourceAttributes which actually were not used by SDK usersModel ChargeSummary has a new parameter etag
Added operation LotsOperations.list_by_customer
Features
Breaking changes
Added operation EventsOperations.list_by_billing_account
Features
Breaking changes
Model ReservationRecommendationDetailsCalculatedSavingsProperties has a new parameter reserved_unit_count
Features
This version uses a next-generation code generator that introduces important breaking changes, but also important new features (like unified authentic…
This is beta preview version. For detailed changelog please refer to equivalent stable version 3.0.0(https://pypi.org/project/azure-mgmt-consumption/3.0.0/)
This version uses a next-generation code generator that introduces important breaking changes, but also important new features (like unified authentication and async programming).
General breaking changes
Credential system has been completly revamped:
azure.common.credentials or msrestazure.azure_active_directory instances are no longer supported, use the azure-identity classes instead: https://pypi.org/project/azure-identity/credentials parameter has been renamed credentialThe config attribute no longer exists on a client, configuration should be passed as kwarg. Example: MyClient(credential, subscription_id, enable_logging=True). For a complete set of
supported options, see the parameters accept in init documentation of azure-core
You can't import a version module anymore, use __version__ instead
Operations that used to return a msrest.polling.LROPoller now returns a azure.core.polling.LROPoller and are prefixed with begin_.
Exceptions tree have been simplified and most exceptions are now azure.core.exceptions.HttpResponseError (CloudError has been removed).
Most of the operation kwarg have changed. Some of the most noticeable:
raw has been removed. Equivalent feature can be found using cls, a callback that will give access to internal HTTP response for advanced userGeneral new features
typing. SDKs are mypy ready.aio namespace of your package to find the async client.This version uses a next-generation code generator that *might* introduce breaking changes.
Features
Breaking changes
General Breaking changes
This version uses a next-generation code generator that might introduce breaking changes.
NameOfEnum.stringvalue. Format syntax
should be prefered.msrestazure.azure_operation.AzureOperationPoller to
msrest.polling.LROPoller. External API is the same.msrest.polling.LROPoller,
regardless of the optional parameters used.raw=True. Instead of
returning the initial call result as ClientRawResponse,
without polling, now this returns an LROPoller. After polling,
the final resource will be returned as a ClientRawResponse.polling parameter. The default behavior is
Polling=True which will poll using ARM algorithm. When
Polling=False, the response of the initial call will be
returned without polling.polling parameter accepts instances of subclasses of
msrest.polling.PollingMethod.add_done_callback will no longer raise if called after
polling is finished, but will instead execute the callback right
away.Marketplace data with and without billing period
Features
Breaking changes
Reservation summaries based on Reservation Order Id and/or ReservationId
Features
Featuring stable api GA version 2017-11-30
Features
Breaking changes
- Initial Release
Your coding agent can read these notes before it upgrades. Set up the MCP server →