Balances - Get By Billing Account

Dienst:: Consumption

API-Version:: 2024-08-01

Ruft die Saldos für einen Bereich durch billingAccountId ab. Saldos sind nur für den 1. Mai 2014 oder höher über diese API verfügbar.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/balances?api-version=2024-08-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
billingAccountId	path	True	string	BillingAccount-ID
api-version	query	True	string minLength: 1	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	Balance	Die Anforderung ist erfolgreich.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Balances

Beispielanforderung

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/balances?api-version=2024-08-01

Beispiel für eine Antwort

Statuscode:: 200

{
  "name": "balanceId1",
  "type": "Microsoft.Consumption/balances",
  "id": "/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/balances/balanceId1",
  "properties": {
    "adjustmentDetails": [
      {
        "name": "Promo Credit",
        "value": 1.1
      },
      {
        "name": "SIE Credit",
        "value": 1
      }
    ],
    "adjustments": 0,
    "azureMarketplaceServiceCharges": 609.82,
    "beginningBalance": 3396469.19,
    "billingFrequency": "Month",
    "chargesBilledSeparately": 0,
    "currency": "USD  ",
    "endingBalance": 2922371.02,
    "newPurchases": 0,
    "newPurchasesDetails": [
      {
        "name": "Promo Purchase",
        "value": 1
      }
    ],
    "overageRefund": 2012.61,
    "priceHidden": false,
    "serviceOverage": 0,
    "totalOverage": 0,
    "totalUsage": 474098.17,
    "utilized": 474098.17
  }
}

Definitionen

Name	Beschreibung
Balance	Eine Saldoressource.
BalancePropertiesAdjustmentDetailsItem
BalancePropertiesNewPurchasesDetailsItem
BillingFrequency	Die Abrechnungshäufigkeit.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

Balance

Objekt

Eine Saldoressource.

Name	Typ	Beschreibung
etag	string	Das Etag für die Ressource.
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Der Name der Ressource
properties.adjustmentDetails	BalancePropertiesAdjustmentDetailsItem[]	Liste der Anpassungen (Promo-Gutschrift, SIE-Gutschrift usw.).
properties.adjustments	number (decimal)	Gesamtanpassungsbetrag.
properties.azureMarketplaceServiceCharges	number (decimal)	Gesamtgebühren für Azure Marketplace.
properties.beginningBalance	number (decimal)	Der Anfangssaldo für den Abrechnungszeitraum.
properties.billingFrequency	BillingFrequency	Die Abrechnungshäufigkeit.
properties.chargesBilledSeparately	number (decimal)	Gebühren separat abgerechnet.
properties.currency	string	Die ISO-Währung, in der der Zähler berechnet wird, z. B. USD.
properties.endingBalance	number (decimal)	Der Endsaldo für den Abrechnungszeitraum (für offene Zeiträume wird dies täglich aktualisiert).
properties.newPurchases	number (decimal)	Gesamtsumme des neuen Einkaufsbetrags.
properties.newPurchasesDetails	BalancePropertiesNewPurchasesDetailsItem[]	Liste der neuen Einkäufe.
properties.overageRefund	number (decimal)	Überlastung von Rückerstattungen
properties.priceHidden	boolean	Der Preis ist ausgeblendet oder nicht.
properties.serviceOverage	number (decimal)	Überlastung für Azure-Dienste.
properties.totalOverage	number (decimal)	ServiceÜberschreitung + GebührenSeparat abgerechnet.
properties.totalUsage	number (decimal)	Azure-Dienstverpflichtung + Gesamtüberlastung.
properties.utilized	number (decimal)	Gesamtnutzung der Verpflichtung.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

BalancePropertiesAdjustmentDetailsItem

Objekt

Name	Typ	Beschreibung
name	string	der Name der neuen Anpassung.
value	number (decimal)	der Wert der neuen Anpassung.

BalancePropertiesNewPurchasesDetailsItem

Objekt

Name	Typ	Beschreibung
name	string	der Name des neuen Kaufs.
value	number (decimal)	der Wert des neuen Kaufs.

BillingFrequency

Enumeration

Die Abrechnungshäufigkeit.

Wert	Beschreibung
Month
Quarter
Year

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

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

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	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 (date-time)	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.

Freigeben über

Balances - Get By Billing Account

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Balances

Beispielanforderung

Beispiel für eine Antwort

Definitionen

Balance

BalancePropertiesAdjustmentDetailsItem

BalancePropertiesNewPurchasesDetailsItem

BillingFrequency

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

systemData