Transactions - Get

서비스:: Billing

API 버전:: 2019-10-01-preview

ID별로 트랜잭션을 가져옵니다. 이 작업은 계약 유형이 Microsoft 고객 계약 또는 Microsoft 파트너 계약인 청구 계정에 대해 지원됩니다.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/transactions/{transactionName}?periodStartDate={periodStartDate}&periodEndDate={periodEndDate}&api-version=2019-10-01-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingAccountName	path	True	string	청구 계정을 고유하게 식별하는 ID입니다.
billingProfileName	path	True	string	청구 프로필을 고유하게 식별하는 ID입니다.
transactionName	path	True	string	트랜잭션을 고유하게 식별하는 ID입니다.
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2019-10-01-preview입니다.
periodEndDate	query	True	string	트랜잭션을 가져올 종료 날짜입니다. 날짜는 MMDD-YYYY 형식으로 지정해야 합니다.
periodStartDate	query	True	string	트랜잭션을 가져올 시작 날짜입니다. 날짜는 MMDD-YYYY 형식으로 지정해야 합니다.

응답

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

예제

Transaction

샘플 요청

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/transactions/{transactionName}?periodStartDate=2018-04-01&periodEndDate=2018-05-30&api-version=2019-10-01-preview

샘플 응답

상태 코드:: 200

{
  "id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/transactions/{transactionName}",
  "name": "{transactionName}",
  "type": "Microsoft.Billing/billingAccounts/billingProfiles/transactions",
  "properties": {
    "kind": "all",
    "date": "2018-05-01T00:00:00Z",
    "invoice": "2344233",
    "productFamily": "Storage",
    "productTypeId": "A12345",
    "productType": "Reserved VM Instance",
    "productDescription": "Standard D1, US West 3",
    "transactionType": "Purchase",
    "transactionAmount": {
      "currency": "USD",
      "value": 5000
    },
    "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}",
    "invoiceSectionDisplayName": "Contoso operations invoiceSection",
    "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000000",
    "billingProfileDisplayName": "Contoso operations billing",
    "azureCreditApplied": {
      "currency": "USD",
      "value": 2000
    },
    "billingCurrency": "USD",
    "discount": 0.1,
    "effectivePrice": {
      "currency": "USD",
      "value": 10
    },
    "exchangeRate": 1,
    "marketPrice": {
      "currency": "USD",
      "value": 20
    },
    "pricingCurrency": "USD",
    "quantity": 1,
    "servicePeriodStartDate": "2018-05-01T00:00:00Z",
    "servicePeriodEndDate": "2018-09-30T00:00:00Z",
    "subTotal": {
      "currency": "USD",
      "value": 4500
    },
    "tax": {
      "currency": "USD",
      "value": 500
    },
    "unitOfMeasure": "1 Minute",
    "units": 11.25,
    "unitType": "1 Runtime Minute"
  }
}

정의

Name	Description
Amount	금액입니다.
ErrorDetails	오류의 세부 정보입니다.
ErrorResponse	오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.
ErrorSubDetails
ReservationType	트랜잭션의 형식입니다.
Transaction	트랜잭션입니다.
TransactionTypeKind	트랜잭션의 종류입니다. 옵션은 모두 또는 예약입니다.

Amount

Object

금액입니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다.

ErrorDetails

Object

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드입니다.
details	ErrorSubDetails[]	오류의 하위 세부 정보입니다.
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.
target	string	특정 오류의 대상입니다.

ErrorResponse

Object

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

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

ErrorSubDetails

Object

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

ReservationType

열거형

트랜잭션의 형식입니다.

값	Description
Purchase
Usage Charge

Transaction

Object

트랜잭션입니다.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.azureCreditApplied	Amount	이 트랜잭션에 자동으로 적용되는 Azure 크레딧의 양입니다.
properties.billingCurrency	string	이 트랜잭션이 청구되는 통화에 대한 ISO 4217 코드입니다.
properties.billingProfileDisplayName	string	트랜잭션에 대해 청구될 청구 프로필의 이름입니다.
properties.billingProfileId	string	트랜잭션에 대해 청구될 청구 프로필의 ID입니다.
properties.customerDisplayName	string	트랜잭션이 발생한 고객의 이름입니다. 이 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다.
properties.customerId	string	트랜잭션이 발생한 고객의 ID입니다. 이 필드는 Microsoft 파트너 계약 청구 계정에만 적용됩니다.
properties.date	string (date-time)	트랜잭션 날짜입니다.
properties.discount	number	이 트랜잭션에 적용되는 할인율(있는 경우)입니다.
properties.effectivePrice	Amount	할인을 적용한 후의 제품 가격입니다.
properties.exchangeRate	number	해당하는 경우 청구 금액을 청구 통화로 변환하는 데 사용되는 환율입니다.
properties.invoice	string	트랜잭션이 청구된 송장 또는 트랜잭션이 청구되지 않은 경우 '보류 중'입니다.
properties.invoiceSectionDisplayName	string	트랜잭션에 대해 청구될 청구서 섹션의 이름입니다.
properties.invoiceSectionId	string	트랜잭션에 대해 청구될 청구서 섹션의 ID입니다.
properties.kind	TransactionTypeKind	트랜잭션의 종류입니다. 옵션은 모두 또는 예약입니다.
properties.marketPrice	Amount	제품의 소매 가격입니다.
properties.orderId	string	예약의 주문 ID입니다. 이 필드는 종류 예약 트랜잭션에만 적용됩니다.
properties.orderName	string	예약 주문의 이름입니다. 이 필드는 종류 예약 트랜잭션에만 적용됩니다.
properties.pricingCurrency	string	제품 가격이 책정되는 통화에 대한 ISO 4217 코드입니다.
properties.productDescription	string	트랜잭션이 발생한 제품에 대한 설명입니다.
properties.productFamily	string	트랜잭션이 발생한 제품의 제품군입니다.
properties.productType	string	트랜잭션이 발생한 제품의 형식입니다.
properties.productTypeId	string	트랜잭션이 발생한 제품 유형의 ID입니다.
properties.quantity	integer (int32)	트랜잭션에서 구매한 수량입니다.
properties.servicePeriodEndDate	string (date-time)	제품 기간의 종료 날짜 또는 사용이 종료된 월의 종료 날짜입니다.
properties.servicePeriodStartDate	string (date-time)	제품 구매 날짜 또는 사용이 시작된 월의 시작 날짜입니다.
properties.subTotal	Amount	거래에 대한 세전 청구 금액입니다.
properties.subscriptionId	string	트랜잭션에 사용된 구독의 ID입니다. 이 필드는 종류 예약 트랜잭션에만 적용됩니다.
properties.subscriptionName	string	트랜잭션에 사용된 구독의 이름입니다. 이 필드는 종류 예약 트랜잭션에만 적용됩니다.
properties.tax	Amount	거래에 적용되는 세금 금액입니다.
properties.transactionAmount	Amount	트랜잭션과 관련된 요금입니다.
properties.transactionType	ReservationType	트랜잭션의 형식입니다.
properties.unitOfMeasure	string	제품 청구에 사용되는 측정 단위입니다. 예를 들어 컴퓨팅 서비스는 시간당 청구됩니다.
properties.unitType	string	지정된 제품의 측정 단위에 대한 설명입니다.
properties.units	number	지정된 제품에 사용되는 단위 수입니다.
type	string	리소스 종류입니다.

TransactionTypeKind

열거형

트랜잭션의 종류입니다. 옵션은 모두 또는 예약입니다.

값	Description
all
reservation