Reservation Transactions - List

참조

서비스:: Consumption

API 버전:: 2024-08-01

청구 계정 범위의 예약 인스턴스에 대한 트랜잭션 목록입니다. 참고: 환불 트랜잭션은 구매 거래(즉, 구매 청구 월)와 함께 게시됩니다. 예를 들어 환불은 2021년 5월에 요청됩니다. 이 환불 거래는 이벤트 날짜가 2021년 5월이지만 예약 구매가 이루어진 2020년 4월의 청구 월입니다. 참고: ARM의 페이로드 크기 제한은 12MB이므로 응답 크기가 ARM 제한을 초과하면 현재 호출자는 400을 받습니다. 이러한 경우 API 호출은 더 작은 날짜 범위로 이루어져야 합니다.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationTransactions?api-version=2024-08-01

선택적 매개 변수:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationTransactions?$filter={$filter}&api-version=2024-08-01&useMarkupIfPartner={useMarkupIfPartner}&previewMarkupPercentage={previewMarkupPercentage}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingAccountId	path	True	string	BillingAccount ID
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2023-03-01입니다.
$filter	query		string	날짜 범위별로 예약 트랜잭션을 필터링합니다. 시작 날짜 및 종료 날짜의 속성/EventDate입니다. 필터는 'le' 및 'ge'를 지원합니다. 참고: API는 전체 시작 날짜 및 종료 날짜의 청구 월에 대한 데이터를 반환합니다. 예를 들어 filter properties/eventDate+ge+2020-01-01+AND+properties/eventDate+le+2020-12-29에는 2020년 12월 전체의 데이터가 포함됩니다(즉, 12월 30일과 31일 날짜에 대한 레코드가 포함됨).
previewMarkupPercentage	query		number (decimal)	적용할 미리 보기 태그 백분율입니다.
useMarkupIfPartner	query		boolean	호출자가 파트너인 경우 트랜잭션에 표시를 적용합니다.

응답

Name	형식	Description
200 OK	ReservationTransactionsListResult	그래. 요청이 성공했습니다.
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	사용자 계정 가장

예제

ReservationTransactionsByEnrollmentNumber

샘플 요청

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/reservationTransactions?$filter=properties/eventDate+ge+2020-05-20+AND+properties/eventDate+le+2020-05-30&api-version=2024-08-01&useMarkupIfPartner=True&previewMarkupPercentage=15.5

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "id": "/billingAccounts/123456/providers/Microsoft.Consumption/reservationtransactions/201909091919",
      "name": "201909091919",
      "type": "Microsoft.Consumption/reservationTransactions",
      "tags": [],
      "properties": {
        "eventDate": "2019-09-09T19:19:04Z",
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "description": "Standard_DS1_v2 westus 1 Year",
        "eventType": "Refund",
        "quantity": 1,
        "amount": -21,
        "currency": "USD",
        "reservationOrderName": "Transaction-DS1_v2",
        "purchasingEnrollment": "123456",
        "armSkuName": "Standard_DS1_v2",
        "term": "P1Y",
        "region": "westus",
        "purchasingSubscriptionGuid": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
        "purchasingSubscriptionName": "Infrastructure Subscription",
        "accountName": "Microsoft Infrastructure",
        "accountOwnerEmail": "admin@microsoft.com",
        "departmentName": "Unassigned",
        "costCenter": "",
        "currentEnrollment": "123456",
        "billingFrequency": "recurring",
        "billingMonth": 20190901,
        "monetaryCommitment": 523123.9,
        "overage": 23234.49
      }
    },
    {
      "id": "/billingAccounts/123456/providers/Microsoft.Consumption/reservationtransactions/201909091919",
      "name": "201909091919",
      "type": "Microsoft.Consumption/reservationTransactions",
      "tags": [],
      "properties": {
        "eventDate": "2019-09-09T19:19:04Z",
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "description": "Standard_DS1_v2 westus 1 Year",
        "eventType": "Purchase",
        "quantity": 1,
        "amount": 21,
        "currency": "USD",
        "reservationOrderName": "Transaction-DS1_v2",
        "purchasingEnrollment": "123456",
        "armSkuName": "Standard_DS1_v2",
        "term": "P1Y",
        "region": "westus",
        "purchasingSubscriptionGuid": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
        "purchasingSubscriptionName": "Infrastructure Subscription",
        "accountName": "Microsoft Infrastructure",
        "accountOwnerEmail": "admin@microsoft.com",
        "departmentName": "Unassigned",
        "costCenter": "",
        "currentEnrollment": "123456",
        "billingFrequency": "recurring",
        "billingMonth": 20190901,
        "monetaryCommitment": 523123.9,
        "overage": 23234.49
      }
    }
  ]
}

정의

Name	Description
ErrorDetails	오류의 세부 정보입니다.
ErrorResponse	오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다. 일부 오류 응답: 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다. 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다. 504 게이트웨이 시간 제한 - 요청을 처리하는 동안 서비스가 시간 초과되었습니다. 가능한 경우 요청의 날짜 범위를 줄입니다.
ReservationTransaction	예약 트랜잭션 리소스입니다.
ReservationTransactionsListResult	예약 권장 사항을 나열한 결과입니다.

ErrorDetails

Object

오류의 세부 정보입니다.

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

ErrorResponse

Object

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

일부 오류 응답:

429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.
503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.
504 게이트웨이 시간 제한 - 요청을 처리하는 동안 서비스가 시간 초과되었습니다. 가능한 경우 요청의 날짜 범위를 줄입니다.

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