Generate Reservation Details Report - By Billing Account Id

Service:

Cost Management

API Version:

2023-11-01

Generiert den Reservierungsdetailsbericht für den angegebenen Datumsbereich asynchron basierend auf der Registrierungs-ID. Die Details zur Reservierungsnutzung 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=2023-11-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
billingAccountId	path	True	string	Registrierungs-ID (Legacy BillingAccount-ID)
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.
endDate	query	True	string	Enddatum
startDate	query	True	string	Startdatum

Antworten

Name	Typ	Beschreibung
200 OK	OperationStatus	Die Anforderungsverarbeitung wurde abgeschlossen.
202 Accepted		Akzeptiert: Die Anforderung wird verarbeitet. Verwenden Sie den Speicherortheader, um die status zu überprüfen. Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

ReservationDetails

Sample Request

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=2023-11-01

Sample Response

Status code:

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

Status code:

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	Die Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben. Einige Fehlerantworten: 429 TooManyRequests: Die Anforderung wird gedrosselt. Wiederholen Sie den Vorgang, nachdem Sie auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit gewartet haben. 503 ServiceUnavailable: Der Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang, nachdem Sie die im Header „Retry-After“ angegebene Zeit abgewartet haben.
OperationStatus	Die status des zeitintensiven Vorgangs.
OperationStatusType	Die status des zeitintensiven Vorgangs.
ReservationReportSchema	Die CSV-Datei aus dem reportUrl-Bloblink 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	Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponse

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

Einige Fehlerantworten:

• 429 TooManyRequests: Die Anforderung wird gedrosselt. Wiederholen Sie den Vorgang, nachdem Sie auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit gewartet haben.

• 503 ServiceUnavailable: Der Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang, nachdem Sie die im Header „Retry-After“ angegebene Zeit abgewartet haben.

Name	Typ	Beschreibung
error	ErrorDetails	Die Details des Fehlers.

OperationStatus

Die status des zeitintensiven Vorgangs.

Name	Typ	Beschreibung
properties.reportUrl	ReservationReportSchema	Die CSV-Datei aus dem reportUrl-Bloblink 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	Die status des zeitintensiven Vorgangs.

OperationStatusType

Die status des zeitintensiven Vorgangs.

Name	Typ	Beschreibung
Completed	string
Failed	string
Running	string

ReservationReportSchema

Die CSV-Datei aus dem reportUrl-Bloblink 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