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 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
billing
|
path | True |
string |
可唯一識別計費帳戶的標識碼。 Regex 模式: |
invoice
|
path | True |
string |
可唯一識別發票的標識碼。 Regex 模式: |
api-version
|
query | True |
string |
要與用戶端要求搭配使用的 API 版本。 目前的版本是 2024-04-01。 |
count
|
query |
boolean |
count 查詢選項可讓用戶端要求響應中資源隨附的相符資源計數。 |
|
filter
|
query |
string |
篩選查詢選項可讓客戶端篩選要求URL所尋址的資源集合。 |
|
order
|
query |
string |
orderby 查詢選項可讓用戶端以特定順序要求資源。 |
|
search
|
query |
string |
搜尋查詢選項可讓用戶端要求集合內符合自由文字搜尋表達式的專案。 僅支援字串欄位的搜尋。 |
|
skip
|
query |
integer int64 |
skip 查詢選項會要求要略過且不包含在結果中的查詢集合中的項目數目。 |
|
top
|
query |
integer int64 |
最上層查詢選項會要求結果中包含查詢集合中的項目數目。 頂端支援的最大值為 50。 |
回應
名稱 | 類型 | 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"
}
]
}
定義
名稱 | Description |
---|---|
Amount |
退款金額。 |
Amount |
要求的退款金額。 |
Azure |
自動套用至此交易的任何 Azure 點數數量。 |
Consumption |
Microsoft Azure 使用量承諾用量(MACC)透過交易遞減的數量。 |
created |
建立資源的身分識別類型。 |
Credit |
交易的信用類型。 僅適用於信用交易。 |
Effective |
套用任何折扣之後的產品價格。 |
Error |
資源管理錯誤其他資訊。 |
Error |
錯誤詳細數據。 |
Error |
錯誤回應 |
Market |
產品的零售價格。 |
Refund |
交易的退款詳細數據。 |
Special |
識別用於發票的稅務計算類型。 欄位僅適用於具有特殊稅務計算邏輯的發票。 |
Sub |
交易的稅前收費金額。 |
system |
與建立和上次修改資源相關的元數據。 |
Tax |
套用至交易的稅額。 |
Transaction |
交易。 |
Transaction |
與交易相關聯的費用。 |
Transaction |
交易的類型、計費或未計費。 |
Transaction |
資源清單的容器 |
Transaction |
交易。 |
AmountRefunded
退款金額。
名稱 | 類型 | Description |
---|---|---|
currency |
string |
金額值的貨幣。 |
value |
number |
數量值。 例如,如果貨幣是美元,則值為 600$600.00。 |
AmountRequested
要求的退款金額。
名稱 | 類型 | Description |
---|---|---|
currency |
string |
金額值的貨幣。 |
value |
number |
數量值。 例如,如果貨幣是美元,則值為 600$600.00。 |
AzureCreditApplied
自動套用至此交易的任何 Azure 點數數量。
名稱 | 類型 | Description |
---|---|---|
currency |
string |
金額值的貨幣。 |
value |
number |
數量值。 例如,如果貨幣是美元,則值為 600$600.00。 |
ConsumptionCommitmentDecremented
Microsoft Azure 使用量承諾用量(MACC)透過交易遞減的數量。
名稱 | 類型 | Description |
---|---|---|
currency |
string |
金額值的貨幣。 |
value |
number |
數量值。 例如,如果貨幣是美元,則值為 600$600.00。 |
createdByType
建立資源的身分識別類型。
名稱 | 類型 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
CreditType
交易的信用類型。 僅適用於信用交易。
名稱 | 類型 | Description |
---|---|---|
AzureCreditOffer |
string |
|
AzureFreeCredit |
string |
|
Other |
string |
|
Refund |
string |
|
ServiceInterruption |
string |
EffectivePrice
套用任何折扣之後的產品價格。
名稱 | 類型 | Description |
---|---|---|
currency |
string |
金額值的貨幣。 |
value |
number |
數量值。 例如,如果貨幣是美元,則值為 600$600.00。 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
名稱 | 類型 | Description |
---|---|---|
info |
object |
其他資訊。 |
type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
additionalInfo |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細數據。 |
|
message |
string |
錯誤訊息。 |
target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
名稱 | 類型 | Description |
---|---|---|
error |
error 物件。 |
MarketPrice
產品的零售價格。
名稱 | 類型 | Description |
---|---|---|
currency |
string |
金額值的貨幣。 |
value |
number |
數量值。 例如,如果貨幣是美元,則值為 600$600.00。 |
RefundTransactionDetails
交易的退款詳細數據。
名稱 | 類型 | Description |
---|---|---|
amountRefunded |
退款金額。 |
|
amountRequested |
要求的退款金額。 |
|
refundOperationId |
string |
退款作業的標識碼。 |
SpecialTaxationType
識別用於發票的稅務計算類型。 欄位僅適用於具有特殊稅務計算邏輯的發票。
名稱 | 類型 | Description |
---|---|---|
InvoiceLevel |
string |
|
SubtotalLevel |
string |
SubTotal
交易的稅前收費金額。
名稱 | 類型 | Description |
---|---|---|
currency |
string |
金額值的貨幣。 |
value |
number |
數量值。 例如,如果貨幣是美元,則值為 600$600.00。 |
systemData
與建立和上次修改資源相關的元數據。
名稱 | 類型 | Description |
---|---|---|
createdAt |
string |
資源建立的時間戳(UTC)。 |
createdBy |
string |
建立資源的身分識別。 |
createdByType |
建立資源的身分識別類型。 |
|
lastModifiedAt |
string |
上次修改的資源時間戳 (UTC) |
lastModifiedBy |
string |
上次修改資源的身分識別。 |
lastModifiedByType |
上次修改資源的身分識別類型。 |
Tax
套用至交易的稅額。
名稱 | 類型 | Description |
---|---|---|
currency |
string |
金額值的貨幣。 |
value |
number |
數量值。 例如,如果貨幣是美元,則值為 600$600.00。 |
Transaction
交易。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源的完整資源標識碼。 例如 “/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
與交易相關聯的費用。
名稱 | 類型 | Description |
---|---|---|
currency |
string |
金額值的貨幣。 |
value |
number |
數量值。 例如,如果貨幣是美元,則值為 600$600.00。 |
TransactionKind
交易的類型、計費或未計費。
名稱 | 類型 | Description |
---|---|---|
All |
string |
|
Other |
string |
|
Reservation |
string |
TransactionListResult
資源清單的容器
名稱 | 類型 | Description |
---|---|---|
nextLink |
string |
結果下一頁的連結(url)。 |
value |
資源清單。 |
TransactionProperties
交易。
名稱 | 類型 | Description |
---|---|---|
azureCreditApplied |
自動套用至此交易的任何 Azure 點數數量。 |
|
azurePlan |
string |
Azure 方案的詳細數據。 |
billingCurrency |
string |
此交易計費貨幣的 ISO 4217 代碼。 |
billingProfileDisplayName |
帳單配置檔的名稱。 |
|
billingProfileId |
string |
可唯一識別帳單配置檔的完整標識符。 |
consumptionCommitmentDecremented |
Microsoft Azure 使用量承諾用量(MACC)透過交易遞減的數量。 |
|
creditType |
交易的信用類型。 僅適用於信用交易。 |
|
customerDisplayName |
string |
客戶的名稱。 |
customerId |
string |
可唯一識別客戶的完整標識碼。 |
date |
string |
交易的日期。 |
discount |
number |
如果有任何折扣,則會套用至此交易的百分比折扣。 |
effectivePrice |
套用任何折扣之後的產品價格。 |
|
exchangeRate |
number |
如果適用,用來將收費金額轉換為計費貨幣的匯率。 |
invoice |
string |
如果交易未計費,則為交易計費的發票名稱或「擱置中」。 |
invoiceId |
string |
交易計費之發票的完整標識碼。 此欄位僅適用於計費的交易。 |
invoiceSectionDisplayName |
string |
發票區段的名稱。 |
invoiceSectionId |
string |
可唯一識別發票區段的完整標識符。 |
isThirdParty |
boolean |
交易是否為第三方。 |
kind |
交易的類型、計費或未計費。 |
|
marketPrice |
產品的零售價格。 |
|
partNumber |
string |
發生交易的產品部分編號。 欄位僅適用於 Enterprise 合約發票。 |
pricingCurrency |
string |
產品的定價貨幣 ISO 4217 代碼。 |
productDescription |
string |
發生交易之產品的描述。 |
productFamily |
string |
交易所針對的產品系列。 |
productType |
string |
發生交易的產品型別。 |
productTypeId |
string |
發生交易之產品類型的標識碼。 |
quantity |
integer |
交易中購買的數量。 |
reasonCode |
string |
交易有理由程序代碼。 |
refundTransactionDetails |
交易的退款詳細數據。 |
|
servicePeriodEndDate |
string |
產品字詞的結束日期,或使用量結束月份的結束日期。 |
servicePeriodStartDate |
string |
購買產品的日期,或使用量開始的月份開始日期。 |
specialTaxationType |
識別用於發票的稅務計算類型。 欄位僅適用於具有特殊稅務計算邏輯的發票。 |
|
subTotal |
交易的稅前收費金額。 |
|
tax |
套用至交易的稅額。 |
|
transactionAmount |
與交易相關聯的費用。 |
|
transactionType |
string |
交易的類型。 |
unitOfMeasure |
string |
用於為產品計費的量值單位。 例如,計算服務每小時計費。 |
unitType |
string |
指定產品的測量單位描述。 |
units |
number |
用於指定產品的單位數目。 |