Price Sheet - Download By Billing Account Period

Dienst:

Consumption

API-Version:

2024-08-01

Generiert das Preisblatt für den bereitgestellten Abrechnungszeitraum asynchron basierend auf der Registrierungs-ID.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/download?api-version=2024-08-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
billingAccountId	path	True	string	BillingAccount-ID
billingPeriodName	path	True	string pattern: ^[0-9]*$	Name des Abrechnungszeitraums.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	OperationStatus	Die Anforderungsverarbeitung wurde abgeschlossen.
202 Accepted		Angenommen Header Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

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

EAPriceSheetForBillingPeriod

Beispielanforderung

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202305/providers/Microsoft.Consumption/pricesheets/download?api-version=2024-08-01

Beispiel für eine Antwort

Statuscode:

202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.Consumption/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-03-01
Retry-After: 10

Statuscode:

200

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://xxxxxx.blob.core.windows.net/armpricesheetreportdownloadcontainer/20230510/00000000-0000-0000-0000-000000000000",
    "validTill": "2023-05-11T05:12:50.4266333Z"
  }
}

Definitionen

Name	Beschreibung
ErrorDetails	Die Details des Fehlers.
ErrorResponse	Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben. Einige Fehlerantworten: 429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit. 503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit. 504 Gatewaytimeout – Diensttimeout beim Verarbeiten der Anforderung. Verringern Sie den Datumsbereich in der Anforderung, falls möglich.
OperationStatus	Der Status des vorgangs mit langer Ausführung.
OperationStatusType	Der Status des vorgangs mit langer Ausführung.

ErrorDetails

Objekt

Die Details des Fehlers.

Name	Typ	Beschreibung
code	string	Fehlercode.
message	string	Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponse

Objekt

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Einige Fehlerantworten:

• 429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit.

• 503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.

• 504 Gatewaytimeout – Diensttimeout beim Verarbeiten der Anforderung. Verringern Sie den Datumsbereich in der Anforderung, falls möglich.

Name	Typ	Beschreibung
error	ErrorDetails	Die Details des Fehlers.

OperationStatus

Objekt

Der Status des vorgangs mit langer Ausführung.

Name	Typ	Beschreibung
properties.downloadUrl	string	Der Link (URL), um das Preisblatt herunterzuladen.
properties.validTill	string (date-time)	Gültigkeit des Downloadlinks.
status	OperationStatusType	Der Status des vorgangs mit langer Ausführung.

OperationStatusType

Enumeration

Der Status des vorgangs mit langer Ausführung.

Wert	Beschreibung
Completed
Failed
Running