Generate Reservation Details Report - By Billing Account Id

Usługa:

Cost Management

Wersja interfejsu API:

2024-08-01

Generuje raport szczegółów rezerwacji dla podanego zakresu dat asynchronicznie na podstawie identyfikatora rejestracji. Szczegóły użycia rezerwacji mogą być wyświetlane tylko przez niektóre role przedsiębiorstwa. Aby uzyskać więcej informacji na temat ról, zobacz 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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
billingAccountId	path	True	string	Identyfikator rejestracji (starszy identyfikator konta rozliczeniowego)
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.
endDate	query	True	string	Data zakończenia
startDate	query	True	string	Data rozpoczęcia

Odpowiedzi

Nazwa	Typ	Opis
200 OK	OperationStatus	Przetwarzanie żądań zostało zakończone.
202 Accepted		Akceptowane. Żądanie zostanie przetworzone. Użyj nagłówka lokalizacji, aby sprawdzić stan. Nagłówki Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

ReservationDetails

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Kod stanu:

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"
  }
}

Definicje

Nazwa	Opis
ErrorDetails	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć przychodzącego żądania. Przyczyna jest podana w komunikacie o błędzie. Niektóre odpowiedzi na błędy: 429 TooManyRequests — żądanie jest ograniczane. Ponów próbę po upływie czasu określonego w nagłówku "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable — usługa jest tymczasowo niedostępna. Ponów próbę po upływie czasu określonego w nagłówku "Ponów próbę po".
OperationStatus	Stan długotrwałej operacji.
OperationStatusType	Stan długotrwałej operacji.
ReservationReportSchema	Plik CSV z linku obiektu blob reportUrl składa się z danych użycia rezerwacji z następującym schematem z dziennym stopniem szczegółowości

ErrorDetails

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Kod błędu.
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

ErrorResponse

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć przychodzącego żądania. Przyczyna jest podana w komunikacie o błędzie.

Niektóre odpowiedzi na błędy:

• 429 TooManyRequests — żądanie jest ograniczane. Ponów próbę po upływie czasu określonego w nagłówku "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiceUnavailable — usługa jest tymczasowo niedostępna. Ponów próbę po upływie czasu określonego w nagłówku "Ponów próbę po".

Nazwa	Typ	Opis
error	ErrorDetails	Szczegóły błędu.

OperationStatus

Stan długotrwałej operacji.

Nazwa	Typ	Opis
properties.reportUrl	ReservationReportSchema	Plik CSV z linku obiektu blob reportUrl składa się z danych użycia rezerwacji z następującym schematem z dziennym stopniem szczegółowości
properties.validUntil	string	Czas, w którym adres URL raportu staje się nieprawidłowy.
status	OperationStatusType	Stan długotrwałej operacji.

OperationStatusType

Stan długotrwałej operacji.

Nazwa	Typ	Opis
Completed	string
Failed	string
Running	string

ReservationReportSchema

Plik CSV z linku obiektu blob reportUrl składa się z danych użycia rezerwacji z następującym schematem z dziennym stopniem szczegółowości

Nazwa	Typ	Opis
InstanceFlexibilityGroup	string
InstanceFlexibilityRatio	string
InstanceId	string
Kind	string
ReservationId	string
ReservationOrderId	string
ReservedHours	string
SkuName	string
TotalReservedQuantity	string
UsageDate	string
UsedHours	string