Transactions - List By Invoice
Listet die Transaktionen für eine Rechnung auf. Transaktionen umfassen Einkäufe, Erstattungen und Azure-Nutzungsgebühren.
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-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
billing
|
path | True |
string |
Die ID, die ein Abrechnungskonto eindeutig identifiziert. RegEx-Muster: |
invoice
|
path | True |
string |
Die ID, die eine Rechnung eindeutig identifiziert. RegEx-Muster: |
api-version
|
query | True |
string |
Die Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2024-04-01. |
count
|
query |
boolean |
Mit der Abfrageoption "Anzahl" können Clients eine Anzahl der übereinstimmenden Ressourcen anfordern, die in der Antwort enthalten sind. |
|
filter
|
query |
string |
Mit der Filterabfrageoption können Clients eine Sammlung von Ressourcen filtern, die von einer Anforderungs-URL adressiert werden. |
|
order
|
query |
string |
Mit der Option "Orderby-Abfrage" können Clients Ressourcen in einer bestimmten Reihenfolge anfordern. |
|
search
|
query |
string |
Mit der Suchabfrageoption können Clients Elemente innerhalb einer Sammlung anfordern, die einem Freitext-Suchausdruck entsprechen. Die Suche wird nur für Zeichenfolgenfelder unterstützt. |
|
skip
|
query |
integer int64 |
Die Option "Abfrage überspringen" fordert die Anzahl der Elemente in der abgefragten Auflistung an, die übersprungen und nicht in das Ergebnis einbezogen werden sollen. |
|
top
|
query |
integer int64 |
Die oberste Abfrageoption fordert die Anzahl der Elemente in der abgefragten Auflistung an, in das Ergebnis eingeschlossen zu werden. Der maximal unterstützte Wert für top ist 50. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Liste der Transaktionen. |
|
Other Status Codes |
Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
Beispiele
TransactionsListByInvoice
Beispielanforderung
Beispiel für eine Antwort
{
"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"
}
]
}
Definitionen
Name | Beschreibung |
---|---|
Amount |
Der Erstattungsbetrag. |
Amount |
Der Betrag der angeforderten Rückerstattung. |
Azure |
Der Betrag aller Azure-Gutschriften, die automatisch auf diese Transaktion angewendet werden. |
Consumption |
Die Menge der Microsoft Azure-Verbrauchsverpflichtung (MACC) wird durch die Transaktion erhöht. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Credit |
Der Kredittyp der Transaktion. Gilt nur für gutgeschriebene Transaktionen. |
Effective |
Der Preis des Produkts nach der Anwendung von Rabatten. |
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
Error |
Das Fehlerdetails. |
Error |
Fehlerantwort |
Market |
Der Verkaufspreis des Produkts. |
Refund |
Die Rückerstattungsdetails einer Transaktion. |
Special |
Gibt die Art der Steuerberechnung an, die für die Rechnung verwendet wird. Das Feld gilt nur für Rechnungen mit spezieller Steuerberechnungslogik. |
Sub |
Der Vorsteuerbetrag für die Transaktion. |
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
Tax |
Der auf die Transaktion angewendete Steuerbetrag. |
Transaction |
Eine Transaktion. |
Transaction |
Die mit der Transaktion verknüpfte Gebühr. |
Transaction |
Typ der Transaktion, in Rechnung gestellt oder ungebilligt. |
Transaction |
Ein Container für eine Liste von Ressourcen |
Transaction |
Eine Transaktion. |
AmountRefunded
Der Erstattungsbetrag.
Name | Typ | Beschreibung |
---|---|---|
currency |
string |
Die Währung für den Betragswert. |
value |
number |
Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00. |
AmountRequested
Der Betrag der angeforderten Rückerstattung.
Name | Typ | Beschreibung |
---|---|---|
currency |
string |
Die Währung für den Betragswert. |
value |
number |
Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00. |
AzureCreditApplied
Der Betrag aller Azure-Gutschriften, die automatisch auf diese Transaktion angewendet werden.
Name | Typ | Beschreibung |
---|---|---|
currency |
string |
Die Währung für den Betragswert. |
value |
number |
Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00. |
ConsumptionCommitmentDecremented
Die Menge der Microsoft Azure-Verbrauchsverpflichtung (MACC) wird durch die Transaktion erhöht.
Name | Typ | Beschreibung |
---|---|---|
currency |
string |
Die Währung für den Betragswert. |
value |
number |
Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
CreditType
Der Kredittyp der Transaktion. Gilt nur für gutgeschriebene Transaktionen.
Name | Typ | Beschreibung |
---|---|---|
AzureCreditOffer |
string |
|
AzureFreeCredit |
string |
|
Other |
string |
|
Refund |
string |
|
ServiceInterruption |
string |
EffectivePrice
Der Preis des Produkts nach der Anwendung von Rabatten.
Name | Typ | Beschreibung |
---|---|---|
currency |
string |
Die Währung für den Betragswert. |
value |
number |
Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00. |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Die zusätzlichen Informationen. |
type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
MarketPrice
Der Verkaufspreis des Produkts.
Name | Typ | Beschreibung |
---|---|---|
currency |
string |
Die Währung für den Betragswert. |
value |
number |
Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00. |
RefundTransactionDetails
Die Rückerstattungsdetails einer Transaktion.
Name | Typ | Beschreibung |
---|---|---|
amountRefunded |
Der Erstattungsbetrag. |
|
amountRequested |
Der Betrag der angeforderten Rückerstattung. |
|
refundOperationId |
string |
Die ID des Erstattungsvorgangs. |
SpecialTaxationType
Gibt die Art der Steuerberechnung an, die für die Rechnung verwendet wird. Das Feld gilt nur für Rechnungen mit spezieller Steuerberechnungslogik.
Name | Typ | Beschreibung |
---|---|---|
InvoiceLevel |
string |
|
SubtotalLevel |
string |
SubTotal
Der Vorsteuerbetrag für die Transaktion.
Name | Typ | Beschreibung |
---|---|---|
currency |
string |
Die Währung für den Betragswert. |
value |
number |
Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00. |
systemData
Metadaten zur Erstellung und letzten Änderung der Ressource.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
Tax
Der auf die Transaktion angewendete Steuerbetrag.
Name | Typ | Beschreibung |
---|---|---|
currency |
string |
Die Währung für den Betragswert. |
value |
number |
Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00. |
Transaction
Eine Transaktion.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Der Name der Ressource |
properties |
Eine Transaktion. |
|
systemData |
Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten. |
|
tags |
object |
Wörterbuch der Metadaten, die der Ressource zugeordnet sind. Möglicherweise wird sie nicht für alle Ressourcentypen aufgefüllt. Maximale Schlüssel-/Wertlänge unterstützt von 256 Zeichen. Schlüssel/Wert dürfen keinen leeren Wert oder null sein. Schlüssel können nicht <> % & \ enthalten? / |
type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
TransactionAmount
Die mit der Transaktion verknüpfte Gebühr.
Name | Typ | Beschreibung |
---|---|---|
currency |
string |
Die Währung für den Betragswert. |
value |
number |
Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00. |
TransactionKind
Typ der Transaktion, in Rechnung gestellt oder ungebilligt.
Name | Typ | Beschreibung |
---|---|---|
All |
string |
|
Other |
string |
|
Reservation |
string |
TransactionListResult
Ein Container für eine Liste von Ressourcen
Name | Typ | Beschreibung |
---|---|---|
nextLink |
string |
Der Link (URL) zur nächsten Seite der Ergebnisse. |
value |
Die Liste der Ressourcen. |
TransactionProperties
Eine Transaktion.
Name | Typ | Beschreibung |
---|---|---|
azureCreditApplied |
Der Betrag aller Azure-Gutschriften, die automatisch auf diese Transaktion angewendet werden. |
|
azurePlan |
string |
Details zum Azure-Plan. |
billingCurrency |
string |
Der ISO 4217-Code für die Währung, in der diese Transaktion in Rechnung gestellt wird. |
billingProfileDisplayName |
Der Name des Abrechnungsprofils. |
|
billingProfileId |
string |
Die vollqualifizierte ID, die ein Abrechnungsprofil eindeutig identifiziert. |
consumptionCommitmentDecremented |
Die Menge der Microsoft Azure-Verbrauchsverpflichtung (MACC) wird durch die Transaktion erhöht. |
|
creditType |
Der Kredittyp der Transaktion. Gilt nur für gutgeschriebene Transaktionen. |
|
customerDisplayName |
string |
Der Name des Kunden. |
customerId |
string |
Die vollqualifizierte ID, die einen Kunden eindeutig identifiziert. |
date |
string |
Das Datum der Transaktion. |
discount |
number |
Der Prozentsatzrabatt( falls vorhanden) für diese Transaktion. |
effectivePrice |
Der Preis des Produkts nach der Anwendung von Rabatten. |
|
exchangeRate |
number |
Der Wechselkurs, der verwendet wird, um den berechneten Betrag in die Abrechnungswährung umzurechnen, falls zutreffend. |
invoice |
string |
Rechnungsname, auf dem die Transaktion in Rechnung gestellt wurde, oder "Ausstehend", wenn die Transaktion nicht in Rechnung gestellt wird. |
invoiceId |
string |
Die vollqualifizierte ID der Rechnung, auf der die Transaktion in Rechnung gestellt wurde. Dieses Feld gilt nur für Transaktionen, die in Rechnung gestellt werden. |
invoiceSectionDisplayName |
string |
Der Name des Rechnungsabschnitts. |
invoiceSectionId |
string |
Die vollqualifizierte ID, die einen Rechnungsabschnitt eindeutig identifiziert. |
isThirdParty |
boolean |
Gibt an, ob es sich bei der Transaktion um Dritte handelt. |
kind |
Typ der Transaktion, in Rechnung gestellt oder ungebilligt. |
|
marketPrice |
Der Verkaufspreis des Produkts. |
|
partNumber |
string |
Die Teilnummer des Produkts, für das die Transaktion stattgefunden hat. Das Feld gilt nur für Enterprise Agreement-Rechnungen. |
pricingCurrency |
string |
Der ISO 4217-Code für die Währung, in der das Produkt preist. |
productDescription |
string |
Die Beschreibung des Produkts, für das die Transaktion erfolgte. |
productFamily |
string |
Die Familie des Produkts, für das die Transaktion erfolgte. |
productType |
string |
Der Typ des Produkts, für das die Transaktion stattgefunden hat. |
productTypeId |
string |
Die ID des Produkttyps, für den die Transaktion stattgefunden hat. |
quantity |
integer |
Die in der Transaktion erworbene Menge. |
reasonCode |
string |
Grundcode für die Transaktion. |
refundTransactionDetails |
Die Rückerstattungsdetails einer Transaktion. |
|
servicePeriodEndDate |
string |
Das Enddatum der Produktlaufzeit oder das Enddatum des Monats, in dem die Nutzung endete. |
servicePeriodStartDate |
string |
Das Datum des Kaufs des Produkts oder das Startdatum des Monats, in dem die Nutzung begonnen hat. |
specialTaxationType |
Gibt die Art der Steuerberechnung an, die für die Rechnung verwendet wird. Das Feld gilt nur für Rechnungen mit spezieller Steuerberechnungslogik. |
|
subTotal |
Der Vorsteuerbetrag für die Transaktion. |
|
tax |
Der auf die Transaktion angewendete Steuerbetrag. |
|
transactionAmount |
Die mit der Transaktion verknüpfte Gebühr. |
|
transactionType |
string |
Der Transaktionstyp. |
unitOfMeasure |
string |
Die Maßeinheit, die für die Abrechnung des Produkts verwendet wird. Beispielsweise werden Computedienste pro Stunde in Rechnung gestellt. |
unitType |
string |
Die Beschreibung für die Maßeinheit für ein bestimmtes Produkt. |
units |
number |
Die Anzahl der einheiten, die für ein bestimmtes Produkt verwendet werden. |