Generate Reservation Details Report - By Billing Account Id

Služba:

Cost Management

Verze rozhraní API:

2024-08-01

Vygeneruje sestavu podrobností rezervací pro zadaný rozsah kalendářních dat asynchronně na základě ID registrace. Podrobnosti o využití rezervací můžou zobrazit jenom určité podnikové role. Další podrobnosti o rolích najdete v tématu 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 identifikátoru URI

Name	V	Vyžadováno	Typ	Description
billingAccountId	path	True	string	ID registrace (STARŠÍ ID fakturačního účtu)
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.
endDate	query	True	string	Koncové datum
startDate	query	True	string	Počáteční datum

Odpovědi

Name	Typ	Description
200 OK	OperationStatus	Zpracování požadavku bylo dokončeno.
202 Accepted		Přijal. Žádost bude zpracována. Pomocí záhlaví umístění zkontrolujte stav. Hlavičky Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

ReservationDetails

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Stavový kód:

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

Definice

Name	Description
ErrorDetails	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě. Některé chybové odpovědi: 429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.
OperationStatus	Stav dlouhotrvající operace.
OperationStatusType	Stav dlouhotrvající operace.
ReservationReportSchema	Soubor CSV z odkazu objektu blob reportUrl se skládá z dat o využití rezervací s následujícím schématem v denní členitosti.

ErrorDetails

Podrobnosti o chybě.

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva označující, proč operace selhala.

ErrorResponse

Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě.

Některé chybové odpovědi:

• 429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after.

• 503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.

Name	Typ	Description
error	ErrorDetails	Podrobnosti o chybě.

OperationStatus

Stav dlouhotrvající operace.

Name	Typ	Description
properties.reportUrl	ReservationReportSchema	Soubor CSV z odkazu objektu blob reportUrl se skládá z dat o využití rezervací s následujícím schématem v denní členitosti.
properties.validUntil	string	Čas, kdy bude adresa URL sestavy neplatná.
status	OperationStatusType	Stav dlouhotrvající operace.

OperationStatusType

Stav dlouhotrvající operace.

Name	Typ	Description
Completed	string
Failed	string
Running	string

ReservationReportSchema

Soubor CSV z odkazu objektu blob reportUrl se skládá z dat o využití rezervací s následujícím schématem v denní členitosti.

Name	Typ	Description
InstanceFlexibilityGroup	string
InstanceFlexibilityRatio	string
InstanceId	string
Kind	string
ReservationId	string
ReservationOrderId	string
ReservedHours	string
SkuName	string
TotalReservedQuantity	string
UsageDate	string
UsedHours	string