Dela via


Transactions - List By Invoice

Visar en lista över transaktionerna för en faktura. Transaktioner inkluderar inköp, återbetalningar och Azure-användningsavgifter.

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

Name I Obligatorisk Typ Description
billingAccountName
path True

string

Det ID som unikt identifierar ett faktureringskonto.

Reguljärt uttrycksmönster: ^([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

Det ID som unikt identifierar en faktura.

Reguljärt uttrycksmönster: ^(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

Den version av API:et som ska användas med klientbegäran. Den aktuella versionen är 2024-04-01.

count
query

boolean

Med alternativet antal frågor kan klienter begära ett antal matchande resurser som ingår i resurserna i svaret.

filter
query

string

Med alternativet filterfråga kan klienter filtrera en samling resurser som adresseras av en begärande-URL.

orderBy
query

string

Med frågealternativet orderby kan klienter begära resurser i en viss ordning.

search
query

string

Med sökfrågealternativet kan klienter begära objekt i en samling som matchar ett fritextsökningsuttryck. sökning stöds endast för strängfält.

skip
query

integer

int64

Alternativet Hoppa över fråga begär antalet objekt i den efterfrågade samlingen som ska hoppas över och inte inkluderas i resultatet.

top
query

integer

int64

Det översta frågealternativet begär att antalet objekt i den efterfrågade samlingen inkluderas i resultatet. Det maximala värdet som stöds för top är 50.

Svar

Name Typ Description
200 OK

TransactionListResult

Listan över transaktioner.

Other Status Codes

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Exempel

TransactionsListByInvoice

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
AmountRefunded

Det återbetalade beloppet.

AmountRequested

Det begärda återbetalningsbeloppet.

AzureCreditApplied

Mängden Azure-krediter som tillämpas automatiskt på den här transaktionen.

ConsumptionCommitmentDecremented

Mängden minskning av Microsoft Azure Consumption Commitment (MACC) via transaktionen.

createdByType

Den typ av identitet som skapade resursen.

CreditType

Transaktionens kredittyp. Gäller endast för krediterade transaktioner.

EffectivePrice

Priset på produkten efter att ha tillämpat eventuella rabatter.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

MarketPrice

Produktens detaljhandelspris.

RefundTransactionDetails

Återbetalningsinformationen för en transaktion.

SpecialTaxationType

Identifierar vilken typ av skatteberäkning som används för fakturan. Fältet gäller endast för fakturor med särskild logik för skatteberäkning.

SubTotal

Det debiterade beloppet före skatt för transaktionen.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Tax

Det skattebelopp som tillämpas på transaktionen.

Transaction

En transaktion.

TransactionAmount

Den avgift som är associerad med transaktionen.

TransactionKind

Typ av transaktion, fakturerad eller ej fakturerad.

TransactionListResult

En container för en lista över resurser

TransactionProperties

En transaktion.

AmountRefunded

Det återbetalade beloppet.

Name Typ Description
currency

string

Valutan för beloppsvärdet.

value

number

Beloppsvärdet. Om valutan till exempel är USD skulle värdet 600 vara 600,00 USD.

AmountRequested

Det begärda återbetalningsbeloppet.

Name Typ Description
currency

string

Valutan för beloppsvärdet.

value

number

Beloppsvärdet. Om valutan till exempel är USD skulle värdet 600 vara 600,00 USD.

AzureCreditApplied

Mängden Azure-krediter som tillämpas automatiskt på den här transaktionen.

Name Typ Description
currency

string

Valutan för beloppsvärdet.

value

number

Beloppsvärdet. Om valutan till exempel är USD skulle värdet 600 vara 600,00 USD.

ConsumptionCommitmentDecremented

Mängden minskning av Microsoft Azure Consumption Commitment (MACC) via transaktionen.

Name Typ Description
currency

string

Valutan för beloppsvärdet.

value

number

Beloppsvärdet. Om valutan till exempel är USD skulle värdet 600 vara 600,00 USD.

createdByType

Den typ av identitet som skapade resursen.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

CreditType

Transaktionens kredittyp. Gäller endast för krediterade transaktioner.

Name Typ Description
AzureCreditOffer

string

AzureFreeCredit

string

Other

string

Refund

string

ServiceInterruption

string

EffectivePrice

Priset på produkten efter att ha tillämpat eventuella rabatter.

Name Typ Description
currency

string

Valutan för beloppsvärdet.

value

number

Beloppsvärdet. Om valutan till exempel är USD skulle värdet 600 vara 600,00 USD.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

MarketPrice

Produktens detaljhandelspris.

Name Typ Description
currency

string

Valutan för beloppsvärdet.

value

number

Beloppsvärdet. Om valutan till exempel är USD skulle värdet 600 vara 600,00 USD.

RefundTransactionDetails

Återbetalningsinformationen för en transaktion.

Name Typ Description
amountRefunded

AmountRefunded

Det återbetalade beloppet.

amountRequested

AmountRequested

Det begärda återbetalningsbeloppet.

refundOperationId

string

ID för återbetalningsåtgärden.

SpecialTaxationType

Identifierar vilken typ av skatteberäkning som används för fakturan. Fältet gäller endast för fakturor med särskild logik för skatteberäkning.

Name Typ Description
InvoiceLevel

string

SubtotalLevel

string

SubTotal

Det debiterade beloppet före skatt för transaktionen.

Name Typ Description
currency

string

Valutan för beloppsvärdet.

value

number

Beloppsvärdet. Om valutan till exempel är USD skulle värdet 600 vara 600,00 USD.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string

Tidsstämpeln för resursens senaste ändring (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.

Tax

Det skattebelopp som tillämpas på transaktionen.

Name Typ Description
currency

string

Valutan för beloppsvärdet.

value

number

Beloppsvärdet. Om valutan till exempel är USD skulle värdet 600 vara 600,00 USD.

Transaction

En transaktion.

Name Typ Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Namnet på resursen

properties

TransactionProperties

En transaktion.

systemData

systemData

Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.

tags

object

Ordlista med metadata som är associerade med resursen. Den kanske inte fylls i för alla resurstyper. Maximal nyckel/värdelängd som stöds på 256 tecken. Nycklar/värde får inte vara tomt eller null. Nycklar kan inte innehålla <> % & \ ? /

type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

TransactionAmount

Den avgift som är associerad med transaktionen.

Name Typ Description
currency

string

Valutan för beloppsvärdet.

value

number

Beloppsvärdet. Om valutan till exempel är USD skulle värdet 600 vara 600,00 USD.

TransactionKind

Typ av transaktion, fakturerad eller ej fakturerad.

Name Typ Description
All

string

Other

string

Reservation

string

TransactionListResult

En container för en lista över resurser

Name Typ Description
nextLink

string

Länken (url) till nästa resultatsida.

value

Transaction[]

Listan över resurser.

TransactionProperties

En transaktion.

Name Typ Description
azureCreditApplied

AzureCreditApplied

Mängden Azure-krediter som tillämpas automatiskt på den här transaktionen.

azurePlan

string

Information om Azure-planen.

billingCurrency

string

ISO 4217-koden för den valuta där transaktionen faktureras.

billingProfileDisplayName

Namnet på faktureringsprofilen.

billingProfileId

string

Det fullständigt kvalificerade ID som unikt identifierar en faktureringsprofil.

consumptionCommitmentDecremented

ConsumptionCommitmentDecremented

Mängden minskning av Microsoft Azure Consumption Commitment (MACC) via transaktionen.

creditType

CreditType

Transaktionens kredittyp. Gäller endast för krediterade transaktioner.

customerDisplayName

string

Kundens namn.

customerId

string

Det fullständigt kvalificerade ID som unikt identifierar en kund.

date

string

Transaktionsdatumet.

discount

number

Den eventuella procentrabatten som tillämpas på den här transaktionen.

effectivePrice

EffectivePrice

Priset på produkten efter att ha tillämpat eventuella rabatter.

exchangeRate

number

Växelkursen som används för att konvertera debiterat belopp till faktureringsvaluta, om tillämpligt.

invoice

string

Fakturanamn där transaktionen fakturerades eller "Väntar" om transaktionen inte faktureras.

invoiceId

string

Det fullständigt kvalificerade ID:t för fakturan som transaktionen fakturerades på. Det här fältet gäller endast för transaktioner som faktureras.

invoiceSectionDisplayName

string

Namnet på fakturaavsnittet.

invoiceSectionId

string

Det fullständigt kvalificerade ID som unikt identifierar ett fakturaavsnitt.

isThirdParty

boolean

Om transaktionen är tredje part eller inte.

kind

TransactionKind

Typ av transaktion, fakturerad eller ej fakturerad.

marketPrice

MarketPrice

Produktens detaljhandelspris.

partNumber

string

Delnumret för den produkt som transaktionen ägde rum för. Fältet gäller endast för Enterprise-avtalsfakturor.

pricingCurrency

string

ISO 4217-koden för den valuta där produkten prissätts.

productDescription

string

Beskrivningen av den produkt som transaktionen ägde rum för.

productFamily

string

Produktfamiljen för vilken transaktionen ägde rum.

productType

string

Typ av produkt som transaktionen ägde rum för.

productTypeId

string

ID:t för den produkttyp som transaktionen ägde rum för.

quantity

integer

Den kvantitet som köpts i transaktionen.

reasonCode

string

Det finns orsakskod för transaktionen.

refundTransactionDetails

RefundTransactionDetails

Återbetalningsinformationen för en transaktion.

servicePeriodEndDate

string

Slutdatumet för produktperioden eller slutdatumet för den månad då användningen avslutades.

servicePeriodStartDate

string

Datumet för köpet av produkten eller startdatumet för den månad då användningen startade.

specialTaxationType

SpecialTaxationType

Identifierar vilken typ av skatteberäkning som används för fakturan. Fältet gäller endast för fakturor med särskild logik för skatteberäkning.

subTotal

SubTotal

Det debiterade beloppet före skatt för transaktionen.

tax

Tax

Det skattebelopp som tillämpas på transaktionen.

transactionAmount

TransactionAmount

Den avgift som är associerad med transaktionen.

transactionType

string

Typen av transaktion.

unitOfMeasure

string

Måttenheten som används för att fakturera för produkten. Till exempel debiteras beräkningstjänster per timme.

unitType

string

Beskrivningen av måttenheten för en viss produkt.

units

number

Antalet enheter som används för en viss produkt.