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

Generate Reservation Details Report - By Billing Account Id

服务:

Cost Management

API 版本:

2024-08-01

根据注册 ID 异步生成提供的日期范围的预留详细信息报告。预留使用情况详细信息只能由某些企业角色查看。 有关角色的详细信息，请参阅 https://docs.microsoft.com/en-us/azure/cost-management-billing/manage/understand-ea-roles#usage-and-costs-access-by-role

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2024-08-01

URI 参数

名称	在	必需	类型	说明
billingAccountId	path	True	string	注册 ID （旧版 BillingAccount ID）
api-version	query	True	string	用于此操作的 API 版本。
endDate	query	True	string	结束日期
startDate	query	True	string	开始日期

响应

名称	类型	说明
200 OK	OperationStatus	请求处理已完成。
202 Accepted		接受。 将处理请求。 使用位置标头检查状态。 标头 Location: string Retry-After: integer
Other Status Codes	ErrorResponse	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

ReservationDetails

示例请求

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate=2020-01-01&endDate=2020-01-30&api-version=2024-08-01

示例响应

状态代码:

202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2019-11-01
Retry-After: 60

状态代码:

200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

定义

名称	说明
ErrorDetails	错误的详细信息。
ErrorResponse	错误响应指示服务无法处理传入请求。 错误消息中提供了原因。 一些错误响应： 429 TooManyRequests - 请求受到限制。 等待“x-ms-ratelimit-microsoft.consumption-retry-after”标头中指定的时间后重试。 503 ServiceUnavailable - 服务暂时不可用。 在等待“Retry-After”标头中指定的时间后重试。
OperationStatus	长时间运行的操作的状态。
OperationStatusType	长时间运行的操作的状态。
ReservationReportSchema	reportUrl blob 链接中的 CSV 文件包含预留使用情况数据，每日粒度为以下架构

ErrorDetails

错误的详细信息。

名称	类型	说明
code	string	错误代码。
message	string	指示操作失败的原因的错误消息。

ErrorResponse

错误响应指示服务无法处理传入请求。 错误消息中提供了原因。

一些错误响应：

• 429 TooManyRequests - 请求受到限制。 等待“x-ms-ratelimit-microsoft.consumption-retry-after”标头中指定的时间后重试。

• 503 ServiceUnavailable - 服务暂时不可用。 在等待“Retry-After”标头中指定的时间后重试。

名称	类型	说明
error	ErrorDetails	错误的详细信息。

OperationStatus

长时间运行的操作的状态。

名称	类型	说明
properties.reportUrl	ReservationReportSchema	reportUrl blob 链接中的 CSV 文件包含预留使用情况数据，每日粒度为以下架构
properties.validUntil	string	报表 URL 无效的时间。
status	OperationStatusType	长时间运行的操作的状态。

OperationStatusType

长时间运行的操作的状态。

名称	类型	说明
Completed	string
Failed	string
Running	string

ReservationReportSchema

reportUrl blob 链接中的 CSV 文件包含预留使用情况数据，每日粒度为以下架构

名称	类型	说明
InstanceFlexibilityGroup	string
InstanceFlexibilityRatio	string
InstanceId	string
Kind	string
ReservationId	string
ReservationOrderId	string
ReservedHours	string
SkuName	string
TotalReservedQuantity	string
UsageDate	string
UsedHours	string