Generate Reservation Details Report - By Billing Account Id

서비스:

Cost Management

API 버전:

2025-03-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?api-version=2025-03-01&startDate={startDate}&endDate={endDate}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingAccountId	path	True	string	청구 계정 ID
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.
endDate	query	True	string	종료 날짜
startDate	query	True	string	시작 날짜

응답

Name	형식	Description
200 OK	OperationStatus	Azure 작업이 성공적으로 완료되었습니다.
202 Accepted		리소스 작업이 수락되었습니다. 헤더 Location: string
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: 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?api-version=2025-03-01&startDate=2020-01-01&endDate=2020-01-30

샘플 응답

상태 코드:

200

{
  "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"
  },
  "status": "Completed"
}

상태 코드:

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

정의

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

ErrorDetails

Object

오류의 세부 정보입니다.

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

ErrorResponse

Object

오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다. \n\n일부 오류 응답: \n\n * 429 TooManyRequests - 요청이 속도 제한됨. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다. \n\n * 503 서비스 사용 불가 - 서비스가 일시적으로 사용 불가입니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.

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

OperationStatus

Object

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

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

OperationStatusType

열거형

Enum은 비동기 연산의 상태를 나타냅니다.

값	Description
Running
Completed
Failed

ReservationReportSchema

열거형

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

값	Description
InstanceFlexibilityGroup
InstanceFlexibilityRatio
InstanceId
Kind
ReservationId
ReservationOrderId
ReservedHours
SkuName
TotalReservedQuantity
UsageDate
UsedHours