你当前正在访问 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 minLength: 1	用于此操作的 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

Object

错误的详细信息。

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

ErrorResponse

Object

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

一些错误响应：

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

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

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

OperationStatus

Object

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

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

OperationStatusType

枚举

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

值	说明
Completed
Failed
Running

ReservationReportSchema

枚举

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

值	说明
InstanceFlexibilityGroup
InstanceFlexibilityRatio
InstanceId
Kind
ReservationId
ReservationOrderId
ReservedHours
SkuName
TotalReservedQuantity
UsageDate
UsedHours