Generate Reservation Details Report - By Billing Account Id

Dienst:

Cost Management

API-Version:

2024-08-01

Generiert den Reservierungsdetails-Bericht für den angegebenen Datumsbereich asynchron basierend auf der Registrierungs-ID. Die Reservierungsnutzungsdetails können nur von bestimmten Unternehmensrollen angezeigt werden. Weitere Informationen zu den Rollen finden Sie unter https://docs.microsoft.com/en-us/azure/cost-management-billing/manage/understand-ea-roles#usage-and-costs-access-by-role

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2024-08-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
billingAccountId	path	True	string	Registrierungs-ID (Legacy BillingAccount ID)
api-version	query	True	string	Die API-Version, die für diesen Vorgang verwendet werden soll.
endDate	query	True	string	Enddatum
startDate	query	True	string	Startdatum

Antworten

Name	Typ	Beschreibung
200 OK	OperationStatus	Die Anforderungsverarbeitung wurde abgeschlossen.
202 Accepted		Angenommen. Die Anforderung wird verarbeitet. Verwenden Sie den Speicherortheader, um den Status zu überprüfen. 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

ReservationDetails

Beispielanforderung

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate=2020-01-01&endDate=2020-01-30&api-version=2024-08-01

Beispiel für eine Antwort

Statuscode:

202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2019-11-01
Retry-After: 60

Statuscode:

200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

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.
OperationStatus	Der Status des vorgangs mit langer Ausführung.
OperationStatusType	Der Status des vorgangs mit langer Ausführung.
ReservationReportSchema	Die CSV-Datei aus der reportUrl-BLOB-Verknüpfung besteht aus Reservierungsnutzungsdaten mit dem folgenden Schema bei täglicher Granularität

ErrorDetails

Die Details des Fehlers.

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

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.

Name	Typ	Beschreibung
error	ErrorDetails	Die Details des Fehlers.

OperationStatus

Der Status des vorgangs mit langer Ausführung.

Name	Typ	Beschreibung
properties.reportUrl	ReservationReportSchema	Die CSV-Datei aus der reportUrl-BLOB-Verknüpfung besteht aus Reservierungsnutzungsdaten mit dem folgenden Schema bei täglicher Granularität
properties.validUntil	string	Der Zeitpunkt, zu dem die Berichts-URL ungültig wird.
status	OperationStatusType	Der Status des vorgangs mit langer Ausführung.

OperationStatusType

Der Status des vorgangs mit langer Ausführung.

Name	Typ	Beschreibung
Completed	string
Failed	string
Running	string

ReservationReportSchema

Die CSV-Datei aus der reportUrl-BLOB-Verknüpfung besteht aus Reservierungsnutzungsdaten mit dem folgenden Schema bei täglicher Granularität

Name	Typ	Beschreibung
InstanceFlexibilityGroup	string
InstanceFlexibilityRatio	string
InstanceId	string
Kind	string
ReservationId	string
ReservationOrderId	string
ReservedHours	string
SkuName	string
TotalReservedQuantity	string
UsageDate	string
UsedHours	string