使用 Microsoft 图形 API导出合作伙伴计费数据

项目
03/06/2024

注意

此 API 仅适用于云解决方案提供商 (CSP) 合作伙伴，以访问租户的计费和未计费对帐数据。若要详细了解 CSP 计划，请参阅 Microsoft 云解决方案提供商。

作为 Microsoft 合作伙伴中心生态系统的一部分，云解决方案提供商计划中的 Microsoft 直接合作伙伴可以请求以异步方式将其计费和未计费数据导出到Azure Blob 存储。这样就无需保持开放连接数小时并循环访问数百万个事务。异步 API 提供了一种快速访问可管理区块中的计费和对帐数据的方法。

合作伙伴计费 API 在 OData 子空间 microsoft.graph.partners.billing中定义。

注意

每日分级的使用情况通常需要 24 小时才能显示在 Microsoft 合作伙伴中心或通过 API 提供。

Authorization

若要导出对帐数据，调用主体必须位于合作伙伴租户中，并被授予相应的合作伙伴计费特权权限。合作伙伴计费 API 支持以下合作伙伴权限。

权限类型	最低特权权限	更高特权权限
委派（工作或学校帐户）	PartnerBilling.Read.All	不支持。
委派（个人 Microsoft 帐户）	不支持。	不支持。
应用程序	PartnerBilling.Read.All	不支持。

零信任

此功能可帮助组织将其标识与零信任体系结构的三个指导原则保持一致：

显式验证
使用最低特权
假定漏洞

若要详细了解零信任和其他使组织符合指导原则的方法，请参阅零信任指导中心。

常见用例

合作伙伴计费 API 提供的方法和操作允许 Microsoft 直接合作伙伴导出其大量计费对帐数据以及计费和未计费的 Azure 使用情况数据。

计费使用情况数据

用例	API
创建新的导出操作以导出计费使用情况数据	billedUsage： export
轮询操作状态更新	获取操作

未计费的使用情况数据

用例	API
创建新的导出操作以导出未计费的使用情况数据	unbilledUsage： export
轮询操作状态更新	获取操作

计费发票对帐数据

用例	API
创建新的导出操作以导出计费发票对帐数据	billedReconciliation： export
轮询操作状态更新	获取操作

异步数据检索

使用情况或对帐数据的下载是一项长时间运行的操作，由以下操作组成。

使用情况行项终结点

使用 billedUsage： export 或 unbilledUsage： export API 访问计费或未计费的消耗行项。 API 返回响应 202 Accepted 代码和 Location 标头，其中包含长时间运行的操作的 URL。可以通过定期发出 GET 请求来检查长时间运行的操作的状态，直到收到包含清单 URL 的成功状态。

非使用情况行项终结点

使用 billedReconciliation： export API 访问计费的发票对帐行项。 API 返回响应 202 Accepted 代码和 Location 标头，其中包含长时间运行的操作的 URL。可以通过定期发出 GET 请求来检查长时间运行的操作的状态，直到收到包含清单 URL 的成功状态。

操作状态终结点

在收到成功状态之前，请定期轮询获取操作 API。如果请求的数据不可用，API 响应将包含一个 Retry-After 标头，指示发送另一个请求之前应等待的时间。操作成功完成后，响应还会提供一个清单，其中包含生成的文件的详细信息。清单提供了一个存储文件夹，可从中下载实际计费数据。响应拆分或分区文件以优化吞吐量和 I/O 并行度。

通过