面向合作伙伴的自动化

项目
06/21/2023

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

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

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

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

获取计费帐户的列表

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

获取客户的列表

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

获取订阅的列表

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

获取一段时间的发票列表

GET https://management.chinacloudapi.cn/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.chinacloudapi.cn/{id}/providers/Microsoft.Consumption/UsageDetails?api-version=2019-10-01

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

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

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

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

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

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

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

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

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

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

首先使用以下 post 调用。

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

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

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

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

获取聚合成本

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

为合作伙伴创建预算

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

为客户创建预算

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

删除预算

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