Balances - Get By Billing Account

Service:

Consumption

API-versie:

2024-08-01

Hiermee haalt u de saldi voor een bereik op per billingAccountId. Saldo's zijn alleen beschikbaar via deze API voor 1 mei 2014 of hoger.

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

URI-parameters

Name	In	Vereist	Type	Description
billingAccountId	path	True	string	Factureringsaccount-id
api-version	query	True	string	Versie van de API die moet worden gebruikt met de clientaanvraag. De huidige versie is 2023-03-01.

Antwoorden

Name	Type	Description
200 OK	Balance	OK. De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Balances

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

200

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

Definities

Name	Description
AdjustmentDetails	Lijst met aanpassingen (promotietegoed, SIE-tegoed, enz.).
Balance	Een balansresource.
BillingFrequency	De factureringsfrequentie.
ErrorDetails	De details van de fout.
ErrorResponse	Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht. Enkele foutberichten: 429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'. Time-out van 504 gateway: er is een time-out opgetreden voor de service tijdens het verwerken van de aanvraag. Verminder indien mogelijk het datumbereik in de aanvraag.
NewPurchasesDetails	Lijst met nieuwe aankopen.

AdjustmentDetails

Object

Lijst met aanpassingen (promotietegoed, SIE-tegoed, enz.).

Name	Type	Description
name	string	de naam van de nieuwe aanpassing.
value	number (decimal)	de waarde van nieuwe aanpassing.

Balance

Object

Een balansresource.

Name	Type	Description
etag	string	De etag voor de resource.
id	string	De volledig gekwalificeerde ARM-id van een gebeurtenis.
name	string	De id waarmee een gebeurtenis uniek wordt geïdentificeerd.
properties.adjustmentDetails	AdjustmentDetails[]	Lijst met aanpassingen (promotietegoed, SIE-tegoed, enz.).
properties.adjustments	number (decimal)	Totale aanpassingsbedrag.
properties.azureMarketplaceServiceCharges	number (decimal)	Totale kosten voor Azure Marketplace.
properties.beginningBalance	number (decimal)	Het beginsaldo voor de factureringsperiode.
properties.billingFrequency	BillingFrequency	De factureringsfrequentie.
properties.chargesBilledSeparately	number (decimal)	Kosten worden afzonderlijk gefactureerd.
properties.currency	string	De ISO-valuta waarin de meter wordt in rekening gebracht, bijvoorbeeld USD.
properties.endingBalance	number (decimal)	Het eindsaldo voor de factureringsperiode (voor openstaande perioden wordt dit dagelijks bijgewerkt).
properties.newPurchases	number (decimal)	Totaal bedrag voor nieuwe aankoop.
properties.newPurchasesDetails	NewPurchasesDetails[]	Lijst met nieuwe aankopen.
properties.overageRefund	number (decimal)	Overschrijdingsrestituties
properties.priceHidden	boolean	Prijs is verborgen of niet.
properties.serviceOverage	number (decimal)	Overschrijding voor Azure-services.
properties.totalOverage	number (decimal)	serviceOverage + chargesBilledSeparately.
properties.totalUsage	number (decimal)	Azure-service-toezegging + totale overschrijding.
properties.utilized	number (decimal)	Totale toezeggingsgebruik.
tags	object	Resourcetags.
type	string	Resourcetype.

BillingFrequency

Inventarisatie

De factureringsfrequentie.

Waarde	Description
Month
Quarter
Year

ErrorDetails

Object

De details van de fout.

Name	Type	Description
code	string	Foutcode.
message	string	Foutbericht dat aangeeft waarom de bewerking is mislukt.

ErrorResponse

Object

Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht.

Enkele foutberichten:

• 429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header x-ms-ratelimit-microsoft.consumption-retry-after.

• 503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.

• Time-out van 504 gateway: er is een time-out opgetreden voor de service tijdens het verwerken van de aanvraag. Verminder indien mogelijk het datumbereik in de aanvraag.

Name	Type	Description
error	ErrorDetails	De details van de fout.

NewPurchasesDetails

Object

Lijst met nieuwe aankopen.

Name	Type	Description
name	string	de naam van de nieuwe aankoop.
value	number (decimal)	de waarde van een nieuwe aankoop.