Microsoft Azure SDK for Python

This is the Microsoft Azure Billingbenefits Management Client Library. This package has been tested with Python 3.9+. For a more complete view of Azure libraries, see the azure sdk python release.

Disclaimer

Azure SDK Python packages support for Python 2.7 has ended 01 January 2022. For more information and questions, please refer to https://github.com/Azure/azure-sdk-for-python/issues/20691

Getting started

Prerequisites

• Python 3.9+ is required to use this package.
• Azure subscription

Install the package

pip install azure-mgmt-billingbenefits
pip install azure-identity

Authentication

By default, Azure Active Directory token authentication depends on correct configuration of the following environment variables.

• AZURE_CLIENT_ID for Azure client ID.
• AZURE_TENANT_ID for Azure tenant ID.
• AZURE_CLIENT_SECRET for Azure client secret.

In addition, Azure subscription ID can be configured via environment variable AZURE_SUBSCRIPTION_ID.

With above configuration, client can be authenticated by following code:

from azure.identity import DefaultAzureCredential
from azure.mgmt.billingbenefits import BillingBenefitsMgmtClient
import os

sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
client = BillingBenefitsMgmtClient(credential=DefaultAzureCredential(), subscription_id=sub_id)

Examples

Code samples for this package can be found at:

• Search Billingbenefits Management on docs.microsoft.com
• Azure Python Mgmt SDK Samples Repo

Troubleshooting

Next steps

Provide Feedback

If you encounter any bugs or have suggestions, please file an issue in the Issues section of the project.

Release History

1.0.0b2 (2026-03-31)

Features Added

• Enum CommitmentGrain added member FULL_TERM
• Enum CommitmentGrain added member UNKNOWN
• Model Sku added property tier
• Model Sku added property size
• Model Sku added property family
• Model Sku added property capacity
• Enum Term added member P1M
• Added model ApplicableMacc
• Added enum ApplyDiscountOn
• Added model AutomaticShortfallSuppressReason
• Added model Award
• Added enum BenefitType
• Added model BenefitValidateModel
• Added model BenefitValidateRequest
• Added model BenefitValidateResponse
• Added model BenefitValidateResponseProperty
• Added model CatalogClaimsItem
• Added model ChargeShortfallRequest
• Added model ConditionalCredit
• Added model ConditionalCreditContributor
• Added enum ConditionalCreditEntityType
• Added model ConditionalCreditMilestone
• Added model ConditionalCreditMilestoneBase
• Added model ConditionalCreditPatchRequest
• Added model ConditionalCreditPatchRequestProperties
• Added model ConditionalCreditProperties
• Added enum ConditionalCreditStatus
• Added enum ConditionalCreditsProvisioningState
• Added model ConditionalCreditsValidateModel
• Added model ConditionsItem
• Added model Contributor
• Added model ContributorConditionalCreditMilestone
• Added model ContributorConditionalCreditProperties
• Added model Credit
• Added model CreditBreakdownItem
• Added model CreditDimension
• Added enum CreditExpirationPolicy
• Added model CreditPatchProperties
• Added model CreditPatchRequest
• Added model CreditPolicies
• Added model CreditProperties
• Added model CreditReason
• Added enum CreditRedemptionPolicy
• Added model CreditSource
• Added model CreditSourcePatchRequest
• Added model CreditSourceProperties
• Added enum CreditStatus
• Added model CreditsValidateModel
• Added model CustomPriceProperties
• Added model Discount
• Added enum DiscountAppliedScopeType
• Added enum DiscountCombinationRule
• Added enum DiscountEntityType
• Added model DiscountPatchRequest
• Added model DiscountPatchRequestProperties
• Added model DiscountProperties
• Added enum DiscountProvisioningState
• Added enum DiscountRuleType
• Added enum DiscountStatus
• Added enum DiscountType
• Added model DiscountTypeCustomPrice
• Added model DiscountTypeCustomPriceMultiCurrency
• Added model DiscountTypeProduct
• Added model DiscountTypeProductFamily
• Added model DiscountTypeProductSku
• Added model DiscountTypeProperties
• Added enum EnablementMode
• Added model EntityTypeAffiliateDiscount
• Added model EntityTypePrimaryDiscount
• Added model FreeServices
• Added model FreeServicesPatchRequest
• Added model FreeServicesPatchRequestProperties
• Added model FreeServicesProperties
• Added enum FreeServicesStatus
• Added model Macc
• Added enum MaccEntityType
• Added model MaccMilestone
• Added enum MaccMilestoneStatus
• Added model MaccModelProperties
• Added model MaccPatchRequest
• Added model MaccPatchRequestProperties
• Added enum MaccStatus
• Added model MaccValidateModel
• Added model ManagedServiceIdentity
• Added enum ManagedServiceIdentityType
• Added model MarketSetPricesItems
• Added enum MilestoneStatus
• Added model Plan
• Added model PriceGuaranteeProperties
• Added enum PricingPolicy
• Added model PrimaryConditionalCreditProperties
• Added model ProxyResource
• Added model ResourceSku
• Added model SavingsPlanValidateModel
• Added model SellerResourceListRequest
• Added model SellerResourceListRequestProperties
• Added model ServiceManagedIdentity
• Added enum ServiceManagedIdentityType
• Added model Shortfall
• Added enum SkuTier
• Added model TrackedResource
• Added model UserAssignedIdentity
• Operation group SavingsPlanOperations added method begin_update
• Added operation group ApplicableMaccsOperations
• Added operation group BenefitOperations
• Added operation group ConditionalCreditContributorsOperations
• Added operation group ConditionalCreditsOperations
• Added operation group ContributorsOperations
• Added operation group CreditsOperations
• Added operation group DiscountOperations
• Added operation group DiscountsOperations
• Added operation group FreeServicesOperations
• Added operation group MaccsOperations
• Added operation group SellerResourceOperations
• Added operation group SourcesOperations

Breaking Changes

• This version introduces new hybrid models which have dual dictionary and model nature. Please follow https://aka.ms/azsdk/python/migrate/hybrid-models for migration.
• For the method breakings, please refer to https://aka.ms/azsdk/python/migrate/operations for migration.
• Renamed client BillingBenefitsRP to BillingBenefitsMgmtClient
• Model SavingsPlanOrderAliasModel moved instance variable display_name, savings_plan_order_id, provisioning_state, billing_scope_id, term, billing_plan, applied_scope_type, applied_scope_properties and commitment under property properties whose type is SavingsPlanOrderAliasProperties
• Deleted or renamed model BillingInformation
• Deleted or renamed model OperationResultError
• Deleted or renamed model PricingCurrencyDuration
• Deleted or renamed model PricingCurrencyTotal
• Deleted or renamed model SavingsPlanPurchaseValidateRequest
• Method SavingsPlanOperations.list_all changed its parameter orderby/refresh_summary/skiptoken/selected_state/take from positional_or_keyword to keyword_only
• Renamed method SavingsPlanOperations.update to SavingsPlanOperations.begin_update

Other Changes

• Deleted model SavingsPlanModelList/SavingsPlanOrderModelList/BillingBenefitsRPOperationsMixin which actually were not used by SDK users

1.0.0b1 (2022-12-14)

• Initial Release