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 |
---|---|---|---|---|
billing
|
path | True |
string |
Det ID som unikt identifierar ett faktureringskonto. Reguljärt uttrycksmönster: |
invoice
|
path | True |
string |
Det ID som unikt identifierar en faktura. Reguljärt uttrycksmönster: |
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. |
|
order
|
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 |
Listan över transaktioner. |
|
Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Exempel
TransactionsListByInvoice
Exempelbegäran
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 |
---|---|
Amount |
Det återbetalade beloppet. |
Amount |
Det begärda återbetalningsbeloppet. |
Azure |
Mängden Azure-krediter som tillämpas automatiskt på den här transaktionen. |
Consumption |
Mängden minskning av Microsoft Azure Consumption Commitment (MACC) via transaktionen. |
created |
Den typ av identitet som skapade resursen. |
Credit |
Transaktionens kredittyp. Gäller endast för krediterade transaktioner. |
Effective |
Priset på produkten efter att ha tillämpat eventuella rabatter. |
Error |
Ytterligare information om resurshanteringsfelet. |
Error |
Felinformationen. |
Error |
Felsvar |
Market |
Produktens detaljhandelspris. |
Refund |
Återbetalningsinformationen för en transaktion. |
Special |
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. |
Sub |
Det debiterade beloppet före skatt för transaktionen. |
system |
Metadata som rör skapande och senaste ändring av resursen. |
Tax |
Det skattebelopp som tillämpas på transaktionen. |
Transaction |
En transaktion. |
Transaction |
Den avgift som är associerad med transaktionen. |
Transaction |
Typ av transaktion, fakturerad eller ej fakturerad. |
Transaction |
En container för en lista över resurser |
Transaction |
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 |
Ytterligare information om felet. |
|
code |
string |
Felkoden. |
details |
Felinformationen. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
ErrorResponse
Felsvar
Name | Typ | Description |
---|---|---|
error |
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 |
Det återbetalade beloppet. |
|
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 |
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 |
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 |
En transaktion. |
|
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 |
Listan över resurser. |
TransactionProperties
En transaktion.
Name | Typ | Description |
---|---|---|
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 |
Mängden minskning av Microsoft Azure Consumption Commitment (MACC) via transaktionen. |
|
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 |
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 |
Typ av transaktion, fakturerad eller ej fakturerad. |
|
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 |
Å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 |
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. |
|
tax |
Det skattebelopp som tillämpas på transaktionen. |
|
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. |