共用方式為


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
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

範例要求

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"
    }
  ]
}

定義

名稱 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

用於指定產品的單位數目。