Generate Reservation Details Report - By Billing Profile Id
Generiert den Reservierungsdetailsbericht für den angegebenen Datumsbereich asynchron nach Abrechnungsprofil. Die Details zur Reservierungsnutzung können standardmäßig nur für bestimmte Unternehmensrollen angezeigt werden. Weitere Informationen zu den Rollen finden Sie unter: https://docs.microsoft.com/en-us/azure/cost-management-billing/reservations/reservation-utilization#view-utilization-in-the-azure-portal-with-azure-rbac-access
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2023-11-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
billing
|
path | True |
string |
ID des Abrechnungskontos |
billing
|
path | True |
string |
Id des Abrechnungsprofils. |
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 Location-Header, um die status zu überprüfen. Headers
|
|
Other Status Codes |
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
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000/billingProfiles/CZSFR-SDFXC-DSDF/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate=2020-01-01&endDate=2020-01-30&api-version=2023-11-01
Sample Response
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000/billingProfiles/CZSFR-SDFXC-DSDF/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 |