你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

面向合作伙伴的自动化

Microsoft 成本管理原生可用于已将其客户加入 Microsoft 客户协议并已购买 Azure 计划的直接合作伙伴。 合作伙伴及其客户可以使用成本管理 API 执行常见任务。 有关非自动化方案的详细信息,请参阅面向合作伙伴的成本管理

注意

尽管本文的示例所示为特定的 API 版本,但建议使用可用的最新 API 版本。 较新的 API 版本可能会有改进的功能。 更高的 API 版本支持以前的版本。

Microsoft 成本管理 API - 直接和间接提供程序

有权访问合作伙伴租户中的计费范围的合作伙伴可以使用以下 API 来查看开票成本。

无论成本策略如何,合作伙伴都可以调用订阅范围内的 API,只要这些 API 能够访问订阅。 有权访问订阅的其他用户(例如客户或经销商)只有在合作伙伴为客户租户启用了成本策略之后,才能调用 API。

获取计费帐户的列表

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview 

获取客户的列表

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers?api-version=2019-10-01-preview 

获取订阅的列表

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2019-10-01-preview 

获取特定时间段的发票列表

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices?api-version=2019-10-01-preview&periodStartDate={periodStartDate}&periodEndDate={periodEndDate} 

API 调用将返回发票数组,其中包含类似于以下 JSON 代码的元素。

   {      "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountID}/billingProfiles/{BillingProfileID}/invoices/{InvoiceID}",      "name": "{InvoiceID}",      "properties": {        "amountDue": {          "currency": "USD",          "value": x.xx        },        ...    } 

使用前面返回的 ID 字段值,并在以下示例中将它替换为范围,以查询使用情况详细信息。

GET https://management.azure.com/{id}/providers/Microsoft.Consumption/UsageDetails?api-version=2019-10-01 

该示例返回与特定发票关联的使用情况记录。

获取客户的策略以查看成本

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview 

设置客户的策略以查看成本

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview 

获取计费帐户的 Azure 服务使用情况

建议为这些方案配置导出。 有关详细信息,请参阅利用导出检索大型使用数据集

下载客户的 Azure 服务使用情况

我们建议你也为此方案配置导出。 但是,如果需要按需下载数据,可以使用成本详细信息 API。 有关详细信息,请参阅按需获取小型成本数据集

获取或下载所用 Azure 服务的价目表

首先使用以下 post 调用。

POST https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheet/default/download?api-version=2019-10-01-preview&format=csv" -verbose 

然后调用异步操作属性值。 例如:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheetDownloadOperations/{operation}?sessiontoken=0:11186&api-version=2019-10-01-preview 

以上 get 调用返回包含价目表的下载链接。

获取聚合成本

POST https://management.azure.com/providers/microsoft.billing/billingAccounts/{billingAccountName}/providers/microsoft.costmanagement/query?api-version=2019-10-01 

为合作伙伴创建预算

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/providers/Microsoft.CostManagement/budgets/partnerworkshopbudget?api-version=2019-10-01 

为客户创建预算

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/providers/Microsoft.Consumption/budgets/{budgetName}?api-version=2019-10-01 

删除预算

DELETE https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/budgets/{budgetName}?api-version=2019-10-01