Freigeben über


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
billingAccountName
path True

string

Die ID, die ein Abrechnungskonto eindeutig identifiziert.

RegEx-Muster: ^([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

Die ID, die eine Rechnung eindeutig identifiziert.

RegEx-Muster: ^(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

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.

orderBy
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

TransactionListResult

Die Liste der Transaktionen.

Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

TransactionsListByInvoice

Beispielanforderung

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

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
AmountRefunded

Der Erstattungsbetrag.

AmountRequested

Der Betrag der angeforderten Rückerstattung.

AzureCreditApplied

Der Betrag aller Azure-Gutschriften, die automatisch auf diese Transaktion angewendet werden.

ConsumptionCommitmentDecremented

Die Menge der Microsoft Azure-Verbrauchsverpflichtung (MACC) wird durch die Transaktion erhöht.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

CreditType

Der Kredittyp der Transaktion. Gilt nur für gutgeschriebene Transaktionen.

EffectivePrice

Der Preis des Produkts nach der Anwendung von Rabatten.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

MarketPrice

Der Verkaufspreis des Produkts.

RefundTransactionDetails

Die Rückerstattungsdetails einer Transaktion.

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.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Tax

Der auf die Transaktion angewendete Steuerbetrag.

Transaction

Eine Transaktion.

TransactionAmount

Die mit der Transaktion verknüpfte Gebühr.

TransactionKind

Typ der Transaktion, in Rechnung gestellt oder ungebilligt.

TransactionListResult

Ein Container für eine Liste von Ressourcen

TransactionProperties

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

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

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

AmountRefunded

Der Erstattungsbetrag.

amountRequested

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

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

createdByType

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

TransactionProperties

Eine Transaktion.

systemData

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

Transaction[]

Die Liste der Ressourcen.

TransactionProperties

Eine Transaktion.

Name Typ Beschreibung
azureCreditApplied

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

ConsumptionCommitmentDecremented

Die Menge der Microsoft Azure-Verbrauchsverpflichtung (MACC) wird durch die Transaktion erhöht.

creditType

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

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

TransactionKind

Typ der Transaktion, in Rechnung gestellt oder ungebilligt.

marketPrice

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

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

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

SubTotal

Der Vorsteuerbetrag für die Transaktion.

tax

Tax

Der auf die Transaktion angewendete Steuerbetrag.

transactionAmount

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.