从 EA 价目表 API 迁移

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

注意

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

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

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

调用价目表 API

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

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

支持的请求

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

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

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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?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	字符串	客户登录时的单价，或者如果是在登录之后，则为服务计量功能 GA 启动时的单价。它适用于企业协议用户
货币代码	字符串	签署企业协议时使用的货币
生效结束日期	字符串	价目表计费周期的有效结束日期
生效开始日期	字符串	价目表计费周期的有效开始日期
注册编号	字符串	EA 计费帐户的唯一标识符。
包含数量	字符串	EA 客户有权在不增加费用的情况下使用的特定服务的数量。
市场价格	字符串	给定产品或服务的当前标价。此价格未经过任何协商，基于您的 Microsoft 协议类型。对于 PriceType 消费，市场价格将反映为即用即付价格。对于 PriceType 节省计划，市场价格反映出在即用即付价格基础上的节省计划优惠，适用于相应的承诺期限。对于价格类型“保留实例”，市场价格反映了一年或三年订阅计划的总价格。注意：对于没有进行协商的 EA 客户，市场价格的显示可能会因舍入而与单价的十进制精度不同。
meterCategory	字符串	计量的分类类别的名称。例如，“云服务”、“网络”等。
meterId	字符串	计量的唯一标识符
计量名称	字符串	计量的名称。计量表示Azure服务的可部署资源。
meterRegion	字符串	服务计量可用的 Azure 区域的名称。
仪表子类别	字符串	计量子分类类别的名称。
计量表类型	字符串	计量类型的名称
零件编号	字符串	与计量关联的部件号
价格类型	字符串	产品的价格类型。例如，使用按需付费费率以及 priceType 为用量的Azure资源。其他价格类型包括 ReservedInstance 和 Savings Plan。
产品	字符串	产生费用的产品的名称。
productId	字符串	产品的已消耗计量的唯一标识符。
serviceFamily	数字	Azure服务的类型。例如，计算、分析、安全性。
skuId	字符串	SKU 的唯一标识符
term	字符串	Azure储蓄计划或预留期限为一年或三年（P1Y 或 P3Y）
计量单位	字符串	如何度量服务的使用情况
单价	字符串	给定产品或服务计费时的单价，包括基于市场价格的任何协商折扣。对于 PriceType ReservedInstance，单价反映一年或三年承诺的总成本，包括折扣。请注意：服务的不同层级中存在价格差异时，单价不同于使用情况详细信息下载内容中的有效价格。如果服务是多层级定价，则有效价格是不同层级的混合费率，不显示特定于层级的单价。混合价格或有效价格是针对多个层级（其中的每个层级有具体的单价）消耗的数量得出的净价格。

阅读从 EA 报告迁移到 ARM API 概述一文。

Last updated on 2026-04-10

Compartilhar via