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 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingAccountId	path	True	string	등록 ID(레거시 BillingAccount ID)
api-version	query	True	string	이 작업에 사용할 API 버전입니다.
endDate	query	True	string	종료 날짜
startDate	query	True	string	시작 날짜

응답

Name	형식	Description
200 OK	OperationStatus	요청 처리가 완료되었습니다.
202 Accepted		허용. 요청이 처리됩니다. 위치 헤더를 사용하여 상태를 확인합니다. 헤더 Location: string Retry-After: integer
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
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"
  }
}

정의

Name	Description
ErrorDetails	오류의 세부 정보입니다.
ErrorResponse	오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다. 일부 오류 응답: 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다. 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.
OperationStatus	장기 실행 작업의 상태입니다.
OperationStatusType	장기 실행 작업의 상태입니다.
ReservationReportSchema	reportUrl Blob 링크의 CSV 파일은 매일 세분성으로 다음 스키마가 있는 예약 사용량 현황 데이터로 구성됩니다.

ErrorDetails

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드입니다.
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.

ErrorResponse

오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.

일부 오류 응답:

• 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.

• 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.

Name	형식	Description
error	ErrorDetails	오류의 세부 정보입니다.

OperationStatus

장기 실행 작업의 상태입니다.

Name	형식	Description
properties.reportUrl	ReservationReportSchema	reportUrl Blob 링크의 CSV 파일은 매일 세분성으로 다음 스키마가 있는 예약 사용량 현황 데이터로 구성됩니다.
properties.validUntil	string	보고서 URL이 유효하지 않은 시간입니다.
status	OperationStatusType	장기 실행 작업의 상태입니다.

OperationStatusType

장기 실행 작업의 상태입니다.

Name	형식	Description
Completed	string
Failed	string
Running	string

ReservationReportSchema

reportUrl Blob 링크의 CSV 파일은 매일 세분성으로 다음 스키마가 있는 예약 사용량 현황 데이터로 구성됩니다.

Name	형식	Description
InstanceFlexibilityGroup	string
InstanceFlexibilityRatio	string
InstanceId	string
Kind	string
ReservationId	string
ReservationOrderId	string
ReservedHours	string
SkuName	string
TotalReservedQuantity	string
UsageDate	string
UsedHours	string