다음을 통해 공유


Transactions - List By Invoice

청구서에 대한 트랜잭션을 나열합니다. 거래에는 구매, 환불 및 Azure 사용 요금이 포함됩니다.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices/{invoiceName}/transactions?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices/{invoiceName}/transactions?api-version=2024-04-01&filter={filter}&orderBy={orderBy}&top={top}&skip={skip}&count={count}&search={search}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
billingAccountName
path True

string

청구 계정을 고유하게 식별하는 ID입니다.

regex 패턴: ^([0-9]+|([Pp][Cc][Nn]\.[A-Za-z0-9]+)|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$

invoiceName
path True

string

청구서를 고유하게 식별하는 ID입니다.

regex 패턴: ^(H[0-9]-[A-Z0-9]+)$|^(?:([GHT]|HT){1}[A-Z0-9]{9})$|^(?:[D]{1}[A-Z0-9]{9})$|^(?:E{1}[B-Z0-9]{1}[A-Z0-9]{8})$|^(?:EA[A-Z0-9]{8})$

api-version
query True

string

클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2024-04-01입니다.

count
query

boolean

개수 쿼리 옵션을 사용하면 클라이언트가 응답의 리소스에 포함된 일치하는 리소스의 수를 요청할 수 있습니다.

filter
query

string

필터 쿼리 옵션을 사용하면 클라이언트가 요청 URL로 처리되는 리소스 컬렉션을 필터링할 수 있습니다.

orderBy
query

string

orderby 쿼리 옵션을 사용하면 클라이언트가 특정 순서로 리소스를 요청할 수 있습니다.

search
query

string

검색 쿼리 옵션을 사용하면 클라이언트가 자유 텍스트 검색 식과 일치하는 컬렉션 내의 항목을 요청할 수 있습니다. 검색은 문자열 필드에 대해서만 지원됩니다.

skip
query

integer

int64

건너뛰기 쿼리 옵션은 건너뛰고 결과에 포함되지 않을 쿼리된 컬렉션의 항목 수를 요청합니다.

top
query

integer

int64

최상위 쿼리 옵션은 쿼리된 컬렉션의 항목 수를 결과에 포함하도록 요청합니다. 상위에 지원되는 최대값은 50입니다.

응답

Name 형식 Description
200 OK

TransactionListResult

트랜잭션 목록입니다.

Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

예제

TransactionsListByInvoice

샘플 요청

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/G123456789/transactions?api-version=2024-04-01

샘플 응답

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/BillingProfiles/xxxx-xxxx-xxx-xxx/transactions/41000000-0000-0000-0000-000000000000",
      "name": "41000000-0000-0000-0000-000000000000",
      "properties": {
        "azureCreditApplied": {
          "currency": "USD",
          "value": 2000
        },
        "billingCurrency": "USD",
        "billingProfileDisplayName": "Contoso operations billing",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx",
        "consumptionCommitmentDecremented": {
          "currency": "USD",
          "value": 100
        },
        "date": "2023-05-01T00:00:00Z",
        "discount": 0.1,
        "effectivePrice": {
          "currency": "USD",
          "value": 10
        },
        "exchangeRate": 1,
        "invoice": "G123456789",
        "invoiceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/G123456789",
        "invoiceSectionDisplayName": "Contoso operations invoiceSection",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/invoiceSections/22000000-0000-0000-0000-000000000000",
        "marketPrice": {
          "currency": "USD",
          "value": 20
        },
        "partNumber": "0001",
        "pricingCurrency": "USD",
        "productDescription": "Standard D1, US West 3",
        "productFamily": "Storage",
        "productTypeId": "A12345",
        "productType": "VM Instance",
        "quantity": 1,
        "servicePeriodStartDate": "2023-05-01T00:00:00Z",
        "servicePeriodEndDate": "2023-09-30T00:00:00Z",
        "subTotal": {
          "currency": "USD",
          "value": 4500
        },
        "tax": {
          "currency": "USD",
          "value": 500
        },
        "transactionAmount": {
          "currency": "USD",
          "value": 5000
        },
        "transactionType": "Purchase",
        "units": 11.25,
        "unitOfMeasure": "1 Minute",
        "unitType": "1 Runtime Minute"
      },
      "type": "Microsoft.Billing/billingAccounts/billingProfiles/transactions"
    },
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/BillingProfiles/xxxx-xxxx-xxx-xxx/transactions/51000000-0000-0000-0000-000000000000",
      "name": "51000000-0000-0000-0000-000000000000",
      "properties": {
        "azureCreditApplied": {
          "currency": "USD",
          "value": 20
        },
        "billingCurrency": "USD",
        "billingProfileDisplayName": "Contoso operations billing",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx",
        "consumptionCommitmentDecremented": {
          "currency": "USD",
          "value": 50
        },
        "date": "2024-04-01T00:00:00Z",
        "discount": 0.1,
        "effectivePrice": {
          "currency": "USD",
          "value": 10
        },
        "exchangeRate": 1,
        "invoice": "pending",
        "invoiceSectionDisplayName": "Contoso operations invoiceSection",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/invoiceSections/22000000-0000-0000-0000-000000000000",
        "marketPrice": {
          "currency": "USD",
          "value": 20
        },
        "partNumber": "0002",
        "pricingCurrency": "USD",
        "productDescription": "Standard Support",
        "productFamily": "Storage",
        "productTypeId": "A12345",
        "productType": "VM Instance",
        "quantity": 1,
        "servicePeriodStartDate": "2023-05-01T00:00:00Z",
        "servicePeriodEndDate": "2023-09-30T00:00:00Z",
        "subTotal": {
          "currency": "USD",
          "value": 45
        },
        "tax": {
          "currency": "USD",
          "value": 5
        },
        "transactionAmount": {
          "currency": "USD",
          "value": 50
        },
        "transactionType": "Cancel",
        "units": 1.25,
        "unitOfMeasure": "1 Minute",
        "unitType": "1 Runtime Minute"
      },
      "type": "Microsoft.Billing/billingAccounts/billingProfiles/transactions"
    }
  ]
}

정의

Name Description
AmountRefunded

환불된 금액입니다.

AmountRequested

요청된 환불 금액입니다.

AzureCreditApplied

이 트랜잭션에 자동으로 적용되는 Azure 크레딧의 양입니다.

ConsumptionCommitmentDecremented

트랜잭션을 통해 감소하는 MICROSOFT Azure MACC(소비 약정)의 양입니다.

createdByType

리소스를 만든 ID의 형식입니다.

CreditType

트랜잭션의 크레딧 유형입니다. 크레딧된 트랜잭션에만 적용됩니다.

EffectivePrice

할인을 적용한 후의 제품 가격입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

MarketPrice

제품의 소매 가격입니다.

RefundTransactionDetails

트랜잭션의 환불 세부 정보입니다.

SpecialTaxationType

청구서에 사용되는 세금 계산 유형을 식별합니다. 이 필드는 특별 세금 계산 논리가 있는 청구서에만 적용됩니다.

SubTotal

거래에 대한 세전 청구 금액입니다.

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Tax

거래에 적용되는 세금 금액입니다.

Transaction

트랜잭션입니다.

TransactionAmount

트랜잭션과 관련된 요금입니다.

TransactionKind

청구되거나 청구되지 않은 트랜잭션의 유형입니다.

TransactionListResult

리소스 목록에 대한 컨테이너

TransactionProperties

트랜잭션입니다.

AmountRefunded

환불된 금액입니다.

Name 형식 Description
currency

string

금액 값의 통화입니다.

value

number

금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

AmountRequested

요청된 환불 금액입니다.

Name 형식 Description
currency

string

금액 값의 통화입니다.

value

number

금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

AzureCreditApplied

이 트랜잭션에 자동으로 적용되는 Azure 크레딧의 양입니다.

Name 형식 Description
currency

string

금액 값의 통화입니다.

value

number

금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

ConsumptionCommitmentDecremented

트랜잭션을 통해 감소하는 MICROSOFT Azure MACC(소비 약정)의 양입니다.

Name 형식 Description
currency

string

금액 값의 통화입니다.

value

number

금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

createdByType

리소스를 만든 ID의 형식입니다.

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

CreditType

트랜잭션의 크레딧 유형입니다. 크레딧된 트랜잭션에만 적용됩니다.

Name 형식 Description
AzureCreditOffer

string

AzureFreeCredit

string

Other

string

Refund

string

ServiceInterruption

string

EffectivePrice

할인을 적용한 후의 제품 가격입니다.

Name 형식 Description
currency

string

금액 값의 통화입니다.

value

number

금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

MarketPrice

제품의 소매 가격입니다.

Name 형식 Description
currency

string

금액 값의 통화입니다.

value

number

금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

RefundTransactionDetails

트랜잭션의 환불 세부 정보입니다.

Name 형식 Description
amountRefunded

AmountRefunded

환불된 금액입니다.

amountRequested

AmountRequested

요청된 환불 금액입니다.

refundOperationId

string

환불 작업의 ID입니다.

SpecialTaxationType

청구서에 사용되는 세금 계산 유형을 식별합니다. 이 필드는 특별 세금 계산 논리가 있는 청구서에만 적용됩니다.

Name 형식 Description
InvoiceLevel

string

SubtotalLevel

string

SubTotal

거래에 대한 세전 청구 금액입니다.

Name 형식 Description
currency

string

금액 값의 통화입니다.

value

number

금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

리소스 만들기의 타임스탬프(UTC)입니다.

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

리소스를 만든 ID의 형식입니다.

lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID의 형식입니다.

Tax

거래에 적용되는 세금 금액입니다.

Name 형식 Description
currency

string

금액 값의 통화입니다.

value

number

금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

Transaction

트랜잭션입니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

리소스의 이름

properties

TransactionProperties

트랜잭션입니다.

systemData

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.

tags

object

리소스와 연결된 메타데이터의 사전입니다. 모든 리소스 종류에 대해 채워지지 않을 수 있습니다. 최대 키/값 길이는 256자로 지원됩니다. 키/값은 값이나 null을 비워서는 안 됩니다. 키에는 <> % & \ ? /

type

string

리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

TransactionAmount

트랜잭션과 관련된 요금입니다.

Name 형식 Description
currency

string

금액 값의 통화입니다.

value

number

금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

TransactionKind

청구되거나 청구되지 않은 트랜잭션의 유형입니다.

Name 형식 Description
All

string

Other

string

Reservation

string

TransactionListResult

리소스 목록에 대한 컨테이너

Name 형식 Description
nextLink

string

결과의 다음 페이지에 대한 링크(URL)입니다.

value

Transaction[]

리소스 목록입니다.

TransactionProperties

트랜잭션입니다.

Name 형식 Description
azureCreditApplied

AzureCreditApplied

이 트랜잭션에 자동으로 적용되는 Azure 크레딧의 양입니다.

azurePlan

string

Azure 계획의 세부 정보입니다.

billingCurrency

string

이 트랜잭션이 청구되는 통화에 대한 ISO 4217 코드입니다.

billingProfileDisplayName

청구 프로필의 이름입니다.

billingProfileId

string

청구 프로필을 고유하게 식별하는 정규화된 ID입니다.

consumptionCommitmentDecremented

ConsumptionCommitmentDecremented

트랜잭션을 통해 감소하는 MICROSOFT Azure MACC(소비 약정)의 양입니다.

creditType

CreditType

트랜잭션의 크레딧 유형입니다. 크레딧된 트랜잭션에만 적용됩니다.

customerDisplayName

string

고객의 이름입니다.

customerId

string

고객을 고유하게 식별하는 정규화된 ID입니다.

date

string

트랜잭션 날짜입니다.

discount

number

이 트랜잭션에 적용되는 할인율(있는 경우)입니다.

effectivePrice

EffectivePrice

할인을 적용한 후의 제품 가격입니다.

exchangeRate

number

해당하는 경우 청구 금액을 청구 통화로 변환하는 데 사용되는 환율입니다.

invoice

string

트랜잭션이 청구된 송장 이름 또는 트랜잭션이 청구되지 않은 경우 '보류 중'입니다.

invoiceId

string

트랜잭션이 청구된 청구서의 정규화된 ID입니다. 이 필드는 청구되는 트랜잭션에만 적용됩니다.

invoiceSectionDisplayName

string

청구서 섹션의 이름입니다.

invoiceSectionId

string

청구서 섹션을 고유하게 식별하는 정규화된 ID입니다.

isThirdParty

boolean

트랜잭션이 타사인지 여부입니다.

kind

TransactionKind

청구되거나 청구되지 않은 트랜잭션의 유형입니다.

marketPrice

MarketPrice

제품의 소매 가격입니다.

partNumber

string

트랜잭션이 발생한 제품의 부품 번호입니다. 이 필드는 기업계약 청구서에만 적용됩니다.

pricingCurrency

string

제품 가격이 책정되는 통화에 대한 ISO 4217 코드입니다.

productDescription

string

트랜잭션이 발생한 제품에 대한 설명입니다.

productFamily

string

트랜잭션이 발생한 제품의 제품군입니다.

productType

string

트랜잭션이 발생한 제품의 형식입니다.

productTypeId

string

트랜잭션이 발생한 제품 유형의 ID입니다.

quantity

integer

트랜잭션에서 구매한 수량입니다.

reasonCode

string

트랜잭션에 대한 이유 코드가 있습니다.

refundTransactionDetails

RefundTransactionDetails

트랜잭션의 환불 세부 정보입니다.

servicePeriodEndDate

string

제품 기간의 종료 날짜 또는 사용이 종료된 월의 종료 날짜입니다.

servicePeriodStartDate

string

제품 구매 날짜 또는 사용이 시작된 월의 시작 날짜입니다.

specialTaxationType

SpecialTaxationType

청구서에 사용되는 세금 계산 유형을 식별합니다. 이 필드는 특별 세금 계산 논리가 있는 청구서에만 적용됩니다.

subTotal

SubTotal

거래에 대한 세전 청구 금액입니다.

tax

Tax

거래에 적용되는 세금 금액입니다.

transactionAmount

TransactionAmount

트랜잭션과 관련된 요금입니다.

transactionType

string

트랜잭션의 형식입니다.

unitOfMeasure

string

제품 청구에 사용되는 측정 단위입니다. 예를 들어 컴퓨팅 서비스는 시간당 요금이 청구됩니다.

unitType

string

지정된 제품의 측정 단위에 대한 설명입니다.

units

number

지정된 제품에 사용되는 단위 수입니다.