다음을 통해 공유


Generate Reservation Details Report - By Billing Profile Id

청구 프로필에 의해 제공된 날짜 범위에 대한 예약 세부 정보 보고서를 비동기적으로 생성합니다. 예약 사용량 세부 정보는 기본적으로 특정 엔터프라이즈 역할에서만 볼 수 있습니다. 역할에 대한 자세한 내용은 다음을 참조하세요. 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

샘플 요청

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

샘플 응답

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
{
  "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