Generate Reservation Details Report - By Billing Profile Id

서비스:

Cost Management

API 버전:

2023-11-01

청구 프로필에 의해 제공된 날짜 범위에 대한 예약 세부 정보 보고서를 비동기적으로 생성합니다. 예약 사용량 세부 정보는 기본적으로 특정 엔터프라이즈 역할에서만 볼 수 있습니다. 역할에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/en-us/azure/cost-management-billing/reservations/reservation-utilization#view-utilization-in-the-azure-portal-with-azure-rbac-access

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingAccountId	path	True	string	청구 계정 ID
billingProfileId	path	True	string	청구 프로필 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/00000000-0000-0000-0000-000000000000/billingProfiles/CZSFR-SDFXC-DSDF/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/00000000-0000-0000-0000-000000000000/billingProfiles/CZSFR-SDFXC-DSDF/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