Generate Reservation Details Report - By Billing Account Id

Usługa:

Cost Management

Wersja interfejsu API:

2025-03-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?api-version=2025-03-01&startDate={startDate}&endDate={endDate}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
billingAccountId	path	True	string	Identyfikator konta rozliczeniowego
api-version	query	True	string minLength: 1	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	Operacja platformy Azure została ukończona pomyślnie.
202 Accepted		Zaakceptowano operację zasobu. Nagłówki Location: string
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

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

Zakresów

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

ReservationDetails

Przykładowe zapytanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

200

{
  "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"
  },
  "status": "Completed"
}

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

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. \n\nNiektóre odpowiedzi błędów: \n\n * 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". \n\n * 503 UsługaNiedostępna – 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	Enum reprezentujące status operacji asynchronicznej.
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

Sprzeciwiać się

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

Sprzeciwiać się

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć przychodzącego żądania. Przyczyna jest podana w komunikacie o błędzie. \n\nNiektóre odpowiedzi błędów: \n\n * 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". \n\n * 503 UsługaNiedostępna – 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

Sprzeciwiać się

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 (date-time)	Czas, w którym adres URL raportu staje się nieprawidłowy.
status	OperationStatusType	Stan długotrwałej operacji.

OperationStatusType

Wyliczenie

Enum reprezentujące status operacji asynchronicznej.

Wartość	Opis
Running
Completed
Failed

ReservationReportSchema

Wyliczenie

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

Wartość	Opis
InstanceFlexibilityGroup
InstanceFlexibilityRatio
InstanceId
Kind
ReservationId
ReservationOrderId
ReservedHours
SkuName
TotalReservedQuantity
UsageDate
UsedHours