Transactions - List By Invoice

參考

服務:: Billing

API 版本:: 2024-04-01

列出發票的交易。交易包括購買、退款和 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
billingAccountName	path	True	string	可唯一識別計費帳戶的標識碼。 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	可唯一識別發票的標識碼。 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	count 查詢選項可讓用戶端要求響應中資源隨附的相符資源計數。
filter	query		string	篩選查詢選項可讓客戶端篩選要求URL所尋址的資源集合。
orderBy	query		string	orderby 查詢選項可讓用戶端以特定順序要求資源。
search	query		string	搜尋查詢選項可讓用戶端要求集合內符合自由文字搜尋表達式的專案。僅支援字串欄位的搜尋。
skip	query		integer int64	skip 查詢選項會要求要略過且不包含在結果中的查詢集合中的項目數目。
top	query		integer int64	最上層查詢選項會要求結果中包含查詢集合中的項目數目。頂端支援的最大值為 50。

回應

名稱	類型	Description
200 OK	TransactionListResult	交易清單。
Other Status Codes	ErrorResponse	描述作業失敗原因的錯誤回應。

範例

TransactionsListByInvoice

範例要求

HTTP

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

範例回覆

狀態碼:: 200

{
  "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
AmountRefunded	退款金額。
AmountRequested	要求的退款金額。
AzureCreditApplied	自動套用至此交易的任何 Azure 點數數量。
ConsumptionCommitmentDecremented	Microsoft Azure 使用量承諾用量（MACC）透過交易遞減的數量。
createdByType	建立資源的身分識別類型。
CreditType	交易的信用類型。僅適用於信用交易。
EffectivePrice	套用任何折扣之後的產品價格。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
MarketPrice	產品的零售價格。
RefundTransactionDetails	交易的退款詳細數據。
SpecialTaxationType	識別用於發票的稅務計算類型。欄位僅適用於具有特殊稅務計算邏輯的發票。
SubTotal	交易的稅前收費金額。
systemData	與建立和上次修改資源相關的元數據。
Tax	套用至交易的稅額。
Transaction	交易。
TransactionAmount	與交易相關聯的費用。
TransactionKind	交易的類型、計費或未計費。
TransactionListResult	資源清單的容器
TransactionProperties	交易。

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	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

MarketPrice

產品的零售價格。

名稱	類型	Description
currency	string	金額值的貨幣。
value	number	數量值。例如，如果貨幣是美元，則值為 600$600.00。

RefundTransactionDetails

交易的退款詳細數據。

名稱	類型	Description
amountRefunded	AmountRefunded	退款金額。
amountRequested	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	createdByType	建立資源的身分識別類型。
lastModifiedAt	string	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

Tax

套用至交易的稅額。

名稱	類型	Description
currency	string	金額值的貨幣。
value	number	數量值。例如，如果貨幣是美元，則值為 600$600.00。

Transaction

交易。

名稱	類型	Description
id	string	資源的完整資源標識碼。例如 “/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

與交易相關聯的費用。

名稱	類型	Description
currency	string	金額值的貨幣。
value	number	數量值。例如，如果貨幣是美元，則值為 600$600.00。

TransactionKind

交易的類型、計費或未計費。

名稱	類型	Description
All	string
Other	string
Reservation	string

TransactionListResult

資源清單的容器

名稱	類型	Description
nextLink	string	結果下一頁的連結（url）。
value	Transaction[]	資源清單。

TransactionProperties

交易。

名稱	類型	Description
azureCreditApplied	AzureCreditApplied	自動套用至此交易的任何 Azure 點數數量。
azurePlan	string	Azure 方案的詳細數據。
billingCurrency	string	此交易計費貨幣的 ISO 4217 代碼。
billingProfileDisplayName		帳單配置檔的名稱。
billingProfileId	string	可唯一識別帳單配置檔的完整標識符。
consumptionCommitmentDecremented	ConsumptionCommitmentDecremented	Microsoft Azure 使用量承諾用量（MACC）透過交易遞減的數量。
creditType	CreditType	交易的信用類型。僅適用於信用交易。
customerDisplayName	string	客戶的名稱。
customerId	string	可唯一識別客戶的完整標識碼。
date	string	交易的日期。
discount	number	如果有任何折扣，則會套用至此交易的百分比折扣。
effectivePrice	EffectivePrice	套用任何折扣之後的產品價格。
exchangeRate	number	如果適用，用來將收費金額轉換為計費貨幣的匯率。
invoice	string	如果交易未計費，則為交易計費的發票名稱或「擱置中」。
invoiceId	string	交易計費之發票的完整標識碼。此欄位僅適用於計費的交易。
invoiceSectionDisplayName	string	發票區段的名稱。
invoiceSectionId	string	可唯一識別發票區段的完整標識符。
isThirdParty	boolean	交易是否為第三方。
kind	TransactionKind	交易的類型、計費或未計費。
marketPrice	MarketPrice	產品的零售價格。
partNumber	string	發生交易的產品部分編號。欄位僅適用於 Enterprise 合約發票。
pricingCurrency	string	產品的定價貨幣 ISO 4217 代碼。
productDescription	string	發生交易之產品的描述。
productFamily	string	交易所針對的產品系列。
productType	string	發生交易的產品型別。
productTypeId	string	發生交易之產品類型的標識碼。
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	用於指定產品的單位數目。

共用方式為