Generate Reservation Details Report - By Billing Account Id
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 |
---|---|---|---|---|
billing
|
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. |
end
|
query | True |
string |
Enddatum |
start
|
query | True |
string |
Startdatum |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Anforderungsverarbeitung wurde abgeschlossen. |
|
202 Accepted |
Akzeptiert: Die Anforderung wird verarbeitet. Verwenden Sie den Speicherortheader, um die status zu überprüfen. Header
|
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Flow.
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
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
Beispiel für eine Antwort
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": "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 |
---|---|
Error |
Die Details des Fehlers. |
Error |
Die Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben. Einige Fehlerantworten:
|
Operation |
Die status des zeitintensiven Vorgangs. |
Operation |
Die status des zeitintensiven Vorgangs. |
Reservation |
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 |
Die Details des Fehlers. |
OperationStatus
Die status des zeitintensiven Vorgangs.
Name | Typ | Beschreibung |
---|---|---|
properties.reportUrl |
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 |
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 |