Microsoft Azure SDK for Python

这是Microsoft Azure消费客户端库。该软件包已在Python 3.6+上进行了测试。有关Azure库的更完整视图，请参阅azure sdk python发布。

免责声明

Azure SDK Python包对Python 2.7的支持已于2022年1月1日结束。有关更多信息及疑问，请参阅https://github.com/Azure/azure-sdk-for-python/issues/20691

用法

要了解如何使用此包，请参阅快速入门指南

有关文档和参考信息，请参阅 Python SDK 参考文档。本包的代码示例可在 docs.microsoft.com 上的 消耗 部分找到。不同 Azure 服务的额外代码示例可在 示例仓库 获取。

提供反馈

如果您遇到任何错误或有所建议，请在项目的 问题 部分提交问题。

版本历史

10.0.0 (2022-06-20)

功能

• 添加了操作 LotsOperations.list_by_customer

破坏性更改

• 模型 BudgetFilter 不再具有参数 not_property
• 操作 ReservationRecommendationDetailsOperations.get 新增参数 resource_scope
• 操作 ReservationRecommendationsOperations.list 新增参数 resource_scope
• 操作 ReservationRecommendationsOperations.list 不再具有参数 scope
• 操作 ReservationsDetailsOperations.list 新增参数 resource_scope
• 操作 ReservationsDetailsOperations.list 不再具有参数 scope
• 操作 ReservationsSummariesOperations.list 新增参数 resource_scope
• 操作 ReservationsSummariesOperations.list 不再具有参数 scope

9.0.0 (2022-01-06)

功能

• 添加了操作 EventsOperations.list_by_billing_account
• 添加了操作 EventsOperations.list_by_billing_profile
• 添加了操作 LotsOperations.list_by_billing_account
• 添加了操作 LotsOperations.list_by_billing_profile
• 模型 Balance 新增参数 etag
• 模型 Budget 新增参数 forecast_spend
• 模型 ChargeSummary 新增参数 e_tag
• 模型 CreditBalanceSummary 新增参数 estimated_balance_in_billing_currency
• 模型 CreditSummary 新增参数 billing_currency
• 模型 CreditSummary 新增参数 credit_currency
• 模型 CreditSummary 新增参数 e_tag
• 模型 CreditSummary 新增参数 etag
• 模型 CreditSummary 新增参数 reseller
• 模型 EventSummary 新增参数 adjustments_in_billing_currency
• 模型 EventSummary 新增参数 billing_currency
• 模型 EventSummary 新增参数 billing_profile_display_name
• 模型 EventSummary 新增参数 billing_profile_id
• 模型 EventSummary 新增参数 canceled_credit
• 模型 EventSummary 新增参数 charges_in_billing_currency
• 模型 EventSummary 新增参数 closed_balance_in_billing_currency
• 模型 EventSummary 新增参数 credit_currency
• 模型 EventSummary 新增参数 credit_expired_in_billing_currency
• 模型 EventSummary 新增参数 e_tag
• 模型 EventSummary 新增参数 e_tag_properties_e_tag
• 模型 EventSummary 新增参数 lot_id
• 模型 EventSummary 新增参数 lot_source
• 模型 EventSummary 新增参数 new_credit_in_billing_currency
• 模型 EventSummary 新增参数 reseller
• 模型 LegacyChargeSummary 新增参数 e_tag
• 模型 LegacyReservationRecommendation 新增参数 etag
• 模型 LegacyReservationRecommendation 新增参数 resource_type
• 模型 LegacyReservationTransaction 新增参数 billing_month
• 模型 LegacyReservationTransaction 新增参数 monetary_commitment
• 模型 LegacyReservationTransaction 新增参数 overage
• 模型 LegacyUsageDetail 新增参数 benefit_id
• 模型 LegacyUsageDetail 新增参数 benefit_name
• 模型 LegacyUsageDetail 新增参数 etag
• 模型 LegacyUsageDetail 新增参数 pay_g_price
• 模型 LegacyUsageDetail 新增参数 pricing_model
• 模型 LotSummary 新增参数 billing_currency
• 模型 LotSummary 新增参数 closed_balance_in_billing_currency
• 模型 LotSummary 新增参数 credit_currency
• 模型 LotSummary 新增参数 e_tag
• 模型 LotSummary 新增参数 e_tag_properties_e_tag
• 模型 LotSummary 新增参数 original_amount_in_billing_currency
• 模型 LotSummary 新增参数 purchased_date
• 模型 LotSummary 新增参数 reseller
• 模型 LotSummary 新增参数 status
• 模型管理组聚合成本结果模型新增参数 etag
• 模型市场新增参数 additional_info
• 模型市场新增参数 etag
• 模型现代计费摘要新增参数 e_tag
• 模型现代预订推荐新增参数 etag
• 模型现代预订推荐新增参数 location_properties_location
• 模型现代预订推荐新增参数 sku_name
• 模型现代使用详情新增参数 benefit_id
• 模型现代使用详情新增参数 benefit_name
• 模型现代使用详情新增参数 cost_allocation_rule_name
• 模型现代使用详情新增参数 effective_price
• 模型现代使用详情新增参数 etag
• 模型现代使用详情新增参数 pay_g_price
• 模型现代使用详情新增参数 pricing_model
• 模型现代使用详情新增参数 provider
• 模型通知新增参数 locale
• 模型操作新增参数 id
• 模型操作显示新增参数 description
• 模型价格表结果新增参数 download
• 模型价格表结果新增参数 etag
• 模型预订详情新增参数 etag
• 模型预订推荐新增参数 etag
• 模型预订推荐详情模型新增参数 etag
• 模型预订推荐列表结果新增参数 previous_link
• 模型预订摘要新增参数 etag
• 模型预订交易新增参数 billing_month
• 模型预订交易新增参数 monetary_commitment
• 模型预订交易新增参数 overage
• 模型资源新增参数 etag
• 模型标签新增参数 value
• 模型标签结果新增参数 next_link
• 模型标签结果新增参数 previous_link
• 模型使用详情新增参数 etag

破坏性更改

• 模型计费摘要不再有参数 tags
• 模型事件摘要不再有参数 tags
• 模型遗留计费摘要不再有参数 tags
• 模型批次摘要不再有参数 tags
• 模型现代计费摘要不再有参数 tags
• 操作预订推荐详情 Operations.get 有新的签名
• 模型遗留预订推荐参数范围现在是必需的
• 模型遗留预订推荐参数范围现在是必需的
• 删除了操作 EventsOperations.list
• 删除了操作 LotsOperations.list
• 删除了操作组 ForecastsOperations

8.0.0 (2020-12-22)

功能

• 模型预订推荐详情计算节省属性新增参数 reserved_unit_count
• 模型预订推荐详情模型新增参数 location
• 模型预订推荐详情模型新增参数 sku

8.0.0b1 (2020-10-31)

这是测试预览版本。有关详细变更日志，请参阅等效的稳定版本 3.0.0（https://pypi.ac.cn/project/azure-mgmt-consumption/3.0.0/）

本版本使用下一代代码生成器，引入了重要的破坏性变更，但也引入了重要的新功能（如统一身份验证和异步编程）。

一般破坏性变更

• 凭证系统已完全重写

  • azure.common.credentials 或 msrestazure.azure_active_directory 实例不再受支持，请使用 azure-identity 类： https://pypi.ac.cn/project/azure-identity/
  • credentials 参数已重命名为 credential

• 客户端上的 config 属性不再存在，配置应作为关键字参数传递。例如：MyClient(credential, subscription_id, enable_logging=True)。有关支持选项的完整列表，请参阅azure-core 初始化文档中的参数接受

• 您不能再导入 version 模块，请使用 __version__ 代替

• 之前返回 msrest.polling.LROPoller 的操作现在返回 azure.core.polling.LROPoller，并且以 begin_ 前缀。

• 异常树已简化，大多数异常现在是 azure.core.exceptions.HttpResponseError（已移除 CloudError）。

• 大多数操作 kwarg 已更改。一些最明显的变化

  • raw 已移除。等效功能可以通过使用 cls，一个将提供对内部 HTTP 响应的访问的回调来找到，这对于高级用户而言
  • 有关支持的完整选项集，请参阅 azure-core 请求文档中的参数接受

通用新功能

• 支持使用 typing 的类型注解。SDKs 已准备好使用 mypy。
• 此客户端现在提供稳定和官方的异步支持。检查您的包中的 aio 命名空间以找到异步客户端。
• 此客户端现在原生支持 OpenCensus 或 OpenTelemetry 等跟踪库。查看此 跟踪快速入门 了解概述。

3.0.0 (2018-05-16)

功能

• 模型 MeterDetails 有一个新参数 service_name
• 模型 MeterDetails 有一个新参数 service_tier
• 模型 Filters 有一个新参数 tags
• 模型 Marketplace 有一个新参数 is_recurring_charge
• 模型 PriceSheetProperties 有一个新参数 offer_id
• 添加了操作 UsageDetailsOperations.download
• 添加了操作组 ForecastsOperations
• 添加了操作组 ChargesOperations
• 添加了操作组 TagsOperations
• 添加了操作组 BalancesOperations
• 添加了操作组 ReservationRecommendationsOperations
• 添加了操作组 AggregatedCostOperations

破坏性更改

• 模型 UsageDetail 有一个新的签名
• 移除了操作 BudgetsOperations.create_or_update_by_resource_group_name
• 移除了操作 BudgetsOperations.get_by_resource_group_name
• 移除了操作 BudgetsOperations.list_by_resource_group_name
• 移除了操作 BudgetsOperations.delete_by_resource_group_name
• 移除了操作 UsageDetailsOperations.list_by_billing_period
• 移除了操作 MarketplacesOperations.list_by_billing_period

通用重大更改

本版本使用下一代代码生成器，可能会引入重大更改。

• 模型签名现在仅使用关键字参数语法。所有位置参数都必须重写为关键字参数。为了在大多数情况下保持自动完成，现在为 Python 2 和 Python 3 生成模型。Python 3 使用 "*" 语法用于关键字仅参数。
• 枚举类型现在使用 "str" 混合（类 AzureEnum(str, Enum)）以提高遇到未知枚举值时的行为。虽然这不是一个重大更改，但区别很重要，并在以下文档中记录：https://docs.pythonlang.cn/3/library/enum.html#others 简要概述
  • 不应使用 "is"。
  • "format" 将返回字符串值，而 "%s" 字符串格式化将返回 NameOfEnum.stringvalue。应首选格式化语法。
• 新的长运行操作
  • 返回类型从 msrestazure.azure_operation.AzureOperationPoller 更改为 msrest.polling.LROPoller。外部 API 与之前相同。
  • 现在始终返回 msrest.polling.LROPoller，无论使用的是可选参数。
  • 使用 raw=True 时，行为已更改。现在不再以 ClientRawResponse 返回初始调用结果，而无需轮询；现在返回 LROPoller。轮询后，最终资源将以 ClientRawResponse 返回。
  • 新 polling 参数。默认行为是 Polling=True，将使用 ARM 算法进行轮询。当 Polling=False 时，将返回初始调用的响应，而无需轮询。
  • polling 参数接受 msrest.polling.PollingMethod 子类的实例。
  • 如果轮询完成后调用 add_done_callback，则不会引发异常，而是立即执行回调。

2.0.0 (2018-02-06)

功能

• 具有和没有计费期间的 Marketplace 数据
• 包含和不包含账单期间的定价单数据
• 支持预算CRUD操作

破坏性更改

• 从usage_details、预订摘要和详细操作中删除作用域。

1.1.0 (2017-12-12)

功能

• 根据预订订单ID和/或预订ID生成预订摘要
• 根据预订订单ID和/或预订ID生成预订详情

1.0.0 (2017-11-15)

功能

• 提供稳定的API GA版本 2017-11-30
• 支持Azure消费使用详情的EA客户

破坏性更改

• 将不再支持使用'invoice_id'调用usage_details.list()。将在未来的版本中提供此功能。

0.1.0 (2017-05-18)

• 初始发布