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

Generate Reservation Details Report - By Billing Account Id

  • 参考
服务:
Cost Management
API 版本:
2023-11-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=2023-11-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

示例请求

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate=2020-01-01&endDate=2020-01-30&api-version=2023-11-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