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 |
---|---|---|---|---|
billing
|
path | True |
string |
청구 계정을 고유하게 식별하는 ID입니다. regex 패턴: |
invoice
|
path | True |
string |
청구서를 고유하게 식별하는 ID입니다. regex 패턴: |
api-version
|
query | True |
string |
클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2024-04-01입니다. |
count
|
query |
boolean |
개수 쿼리 옵션을 사용하면 클라이언트가 응답의 리소스에 포함된 일치하는 리소스의 수를 요청할 수 있습니다. |
|
filter
|
query |
string |
필터 쿼리 옵션을 사용하면 클라이언트가 요청 URL로 처리되는 리소스 컬렉션을 필터링할 수 있습니다. |
|
order
|
query |
string |
orderby 쿼리 옵션을 사용하면 클라이언트가 특정 순서로 리소스를 요청할 수 있습니다. |
|
search
|
query |
string |
검색 쿼리 옵션을 사용하면 클라이언트가 자유 텍스트 검색 식과 일치하는 컬렉션 내의 항목을 요청할 수 있습니다. 검색은 문자열 필드에 대해서만 지원됩니다. |
|
skip
|
query |
integer int64 |
건너뛰기 쿼리 옵션은 건너뛰고 결과에 포함되지 않을 쿼리된 컬렉션의 항목 수를 요청합니다. |
|
top
|
query |
integer int64 |
최상위 쿼리 옵션은 쿼리된 컬렉션의 항목 수를 결과에 포함하도록 요청합니다. 상위에 지원되는 최대값은 50입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
트랜잭션 목록입니다. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
예제
TransactionsListByInvoice
샘플 요청
샘플 응답
{
"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 |
---|---|
Amount |
환불된 금액입니다. |
Amount |
요청된 환불 금액입니다. |
Azure |
이 트랜잭션에 자동으로 적용되는 Azure 크레딧의 양입니다. |
Consumption |
트랜잭션을 통해 감소하는 MICROSOFT Azure MACC(소비 약정)의 양입니다. |
created |
리소스를 만든 ID의 형식입니다. |
Credit |
트랜잭션의 크레딧 유형입니다. 크레딧된 트랜잭션에만 적용됩니다. |
Effective |
할인을 적용한 후의 제품 가격입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Market |
제품의 소매 가격입니다. |
Refund |
트랜잭션의 환불 세부 정보입니다. |
Special |
청구서에 사용되는 세금 계산 유형을 식별합니다. 이 필드는 특별 세금 계산 논리가 있는 청구서에만 적용됩니다. |
Sub |
거래에 대한 세전 청구 금액입니다. |
system |
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다. |
Tax |
거래에 적용되는 세금 금액입니다. |
Transaction |
트랜잭션입니다. |
Transaction |
트랜잭션과 관련된 요금입니다. |
Transaction |
청구되거나 청구되지 않은 트랜잭션의 유형입니다. |
Transaction |
리소스 목록에 대한 컨테이너 |
Transaction |
트랜잭션입니다. |
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 |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
오류 개체입니다. |
MarketPrice
제품의 소매 가격입니다.
Name | 형식 | Description |
---|---|---|
currency |
string |
금액 값의 통화입니다. |
value |
number |
금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다. |
RefundTransactionDetails
트랜잭션의 환불 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
amountRefunded |
환불된 금액입니다. |
|
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 |
리소스를 만든 ID의 형식입니다. |
|
lastModifiedAt |
string |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 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 |
트랜잭션입니다. |
|
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 |
리소스 목록입니다. |
TransactionProperties
트랜잭션입니다.
Name | 형식 | Description |
---|---|---|
azureCreditApplied |
이 트랜잭션에 자동으로 적용되는 Azure 크레딧의 양입니다. |
|
azurePlan |
string |
Azure 계획의 세부 정보입니다. |
billingCurrency |
string |
이 트랜잭션이 청구되는 통화에 대한 ISO 4217 코드입니다. |
billingProfileDisplayName |
청구 프로필의 이름입니다. |
|
billingProfileId |
string |
청구 프로필을 고유하게 식별하는 정규화된 ID입니다. |
consumptionCommitmentDecremented |
트랜잭션을 통해 감소하는 MICROSOFT Azure MACC(소비 약정)의 양입니다. |
|
creditType |
트랜잭션의 크레딧 유형입니다. 크레딧된 트랜잭션에만 적용됩니다. |
|
customerDisplayName |
string |
고객의 이름입니다. |
customerId |
string |
고객을 고유하게 식별하는 정규화된 ID입니다. |
date |
string |
트랜잭션 날짜입니다. |
discount |
number |
이 트랜잭션에 적용되는 할인율(있는 경우)입니다. |
effectivePrice |
할인을 적용한 후의 제품 가격입니다. |
|
exchangeRate |
number |
해당하는 경우 청구 금액을 청구 통화로 변환하는 데 사용되는 환율입니다. |
invoice |
string |
트랜잭션이 청구된 송장 이름 또는 트랜잭션이 청구되지 않은 경우 '보류 중'입니다. |
invoiceId |
string |
트랜잭션이 청구된 청구서의 정규화된 ID입니다. 이 필드는 청구되는 트랜잭션에만 적용됩니다. |
invoiceSectionDisplayName |
string |
청구서 섹션의 이름입니다. |
invoiceSectionId |
string |
청구서 섹션을 고유하게 식별하는 정규화된 ID입니다. |
isThirdParty |
boolean |
트랜잭션이 타사인지 여부입니다. |
kind |
청구되거나 청구되지 않은 트랜잭션의 유형입니다. |
|
marketPrice |
제품의 소매 가격입니다. |
|
partNumber |
string |
트랜잭션이 발생한 제품의 부품 번호입니다. 이 필드는 기업계약 청구서에만 적용됩니다. |
pricingCurrency |
string |
제품 가격이 책정되는 통화에 대한 ISO 4217 코드입니다. |
productDescription |
string |
트랜잭션이 발생한 제품에 대한 설명입니다. |
productFamily |
string |
트랜잭션이 발생한 제품의 제품군입니다. |
productType |
string |
트랜잭션이 발생한 제품의 형식입니다. |
productTypeId |
string |
트랜잭션이 발생한 제품 유형의 ID입니다. |
quantity |
integer |
트랜잭션에서 구매한 수량입니다. |
reasonCode |
string |
트랜잭션에 대한 이유 코드가 있습니다. |
refundTransactionDetails |
트랜잭션의 환불 세부 정보입니다. |
|
servicePeriodEndDate |
string |
제품 기간의 종료 날짜 또는 사용이 종료된 월의 종료 날짜입니다. |
servicePeriodStartDate |
string |
제품 구매 날짜 또는 사용이 시작된 월의 시작 날짜입니다. |
specialTaxationType |
청구서에 사용되는 세금 계산 유형을 식별합니다. 이 필드는 특별 세금 계산 논리가 있는 청구서에만 적용됩니다. |
|
subTotal |
거래에 대한 세전 청구 금액입니다. |
|
tax |
거래에 적용되는 세금 금액입니다. |
|
transactionAmount |
트랜잭션과 관련된 요금입니다. |
|
transactionType |
string |
트랜잭션의 형식입니다. |
unitOfMeasure |
string |
제품 청구에 사용되는 측정 단위입니다. 예를 들어 컴퓨팅 서비스는 시간당 요금이 청구됩니다. |
unitType |
string |
지정된 제품의 측정 단위에 대한 설명입니다. |
units |
number |
지정된 제품에 사용되는 단위 수입니다. |