从 EA 价目表 API 迁移

以前使用 Enterprise Reporting consumption.azure.com API 获取价目表的 EA 客户需要迁移到替换 Azure 资源管理器 API。 以下说明可帮助迁移,它们还讨论了旧 API 与新 API 之间的任何协定差异。

注意

所有 Azure 企业报告 API 均已停用。 你应尽快迁移到 Microsoft 成本管理 API

向服务主体分配权限以调用 API

在调用 API 之前,需要配置具有正确权限的服务主体 (SPN)。 使用服务主体调用 API。 有关详细信息,请参阅向成本管理 API 分配权限

调用价目表 API

价目表 API 以异步方式生成价目表,并生成下载的文件。

在调用新的价目表 API 时,请使用以下请求 URI:

支持的请求

可以使用以下作用域调用 API:

注册:providers/Microsoft.Billing/billingAccounts/{billingAccountId}

按指定计费周期的计费帐户下载

POST https://management.chinacloudapi.cn/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

POST 请求返回位置以轮询报告生成状态,如以下响应中所述:

示例响应

状态代码:202

Location: https://management.chinacloudapi.cn/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01
Retry-After: 60

状态代码:200

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://myaccount.blob.core.chinacloudapi.cn/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

轮询报告生成状态的示例请求

GET https://management.chinacloudapi.cn/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01

响应正文更改

[
        {
              "id": "enrollments/57354989/billingperiods/201601/products/343/pricesheets",
              "billingPeriodId": "201704",
            "meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
              "meterName": "A1 VM",
              "unitOfMeasure": "100 Hours",
              "includedQuantity": 0,
              "partNumber": "N7H-00015",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        {
              "id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
              "billingPeriodId": "201404",
            "meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
              "meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
              "unitOfMeasure": "100 GB",
              "includedQuantity": 0,
              "partNumber": "N9H-00402",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        ...
]

新的响应更改

价目表属性如下所示:

Name 类型 描述
basePrice string 客户签署时的单价,或者服务计量 GA 启动时(如果是在登录后启动)的单价。

它适用于企业协议用户
currencyCode string 签署企业协议时使用的货币
effectiveEndDate string 价目表计费周期的有效结束日期
effectiveStartDate string 价目表计费周期的有效开始日期
enrollmentNumber string EA 计费帐户的唯一标识符。
includedQuantity string EA 客户有权在不增加费用的情况下使用的特定服务的数量。
marketPrice string 给定产品或服务的当前标价。 此价格无需任何协商,而是基于你的 Microsoft 协议类型。

对于 PriceType 消费,市场价格将反映为即用即付价格。

对于 PriceType 节省计划,市场价格反映相应承诺期限内在即用即付价格基础上的“节省计划”权益。

对于 PriceType ReservedInstance,marketPrice 反映一年或三年承诺的总价格。

注意:对于无协商的 EA 客户,市场价格可能会舍入到与单价不同的十进制精度。
meterCategory string 计量的分类类别的名称。 例如,“云服务”、“网络”等。
meterId string 计量的唯一标识符
meterName string 计量的名称。 此计量表示 Azure 服务的可部署资源。
meterRegion string 提供服务计量的 Azure 区域的名称。
meterSubCategory string 计量子分类类别的名称。
meterType string 计量类型的名称
partNumber string 与计量关联的部件号
priceType string 产品的价格类型。 例如,某个 Azure 资源具有即用即付费率,priceType 为 Consumption。 其他价格类型包括 ReservedInstance 和 Savings Plan。
product string 产生费用的产品的名称。
productId string 其计量已消耗的产品的唯一标识符。
serviceFamily 数字 Azure 服务的类型。 例如,计算、分析、安全性。
skuId string SKU 的唯一标识符
term string Azure 节省计划期限或预留期限为一年或三年(P1Y 或 P3Y)
unitOfMeasure string 如何度量服务的使用情况
unitPrice string 给定产品或服务计费时的单价,包括基于市场价格的任何协商折扣。

对于 PriceType ReservedInstance,单价反映一年或三年承诺的总成本,包括折扣。

请注意:服务的不同层级中存在价格差异时,单价不同于使用情况详细信息下载内容中的有效价格。

如果服务是多层级定价,则有效价格是不同层级的混合费率,不显示特定于层级的单价。 混合价格或有效价格是针对多个层级(其中的每个层级有具体的单价)消耗的数量得出的净价格。