Generate Reservation Details Report - By Billing Account Id

Service:

Cost Management

API Version:

2023-11-01

A megadott dátumtartományhoz tartozó foglalások részletes jelentését aszinkron módon hozza létre a regisztrációs azonosító alapján. A foglalás használati adatait csak bizonyos vállalati szerepkörök tekinthetik meg. A szerepkörökkel kapcsolatos további részletekért lásd: 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-paraméterek

Name	In	Kötelező	Típus	Description
billingAccountId	path	True	string	Regisztrációs azonosító (örökölt számlázásFiókazonosító)
api-version	query	True	string	A művelethez használandó API-verzió.
endDate	query	True	string	Befejezési dátum
startDate	query	True	string	Kezdés dátuma

Válaszok

Name	Típus	Description
200 OK	OperationStatus	A kérelem feldolgozása befejeződött.
202 Accepted		Elfogadott. A kérés feldolgozása folyamatban van. Az állapot ellenőrzéséhez használja a hely fejlécét. Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	felhasználói fiók megszemélyesítése

Példák

ReservationDetails

Sample Request

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=2023-11-01

Sample Response

Status code:

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

Status code:

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

Definíciók

Name	Description
ErrorDetails	A hiba részletei.
ErrorResponse	A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg. Néhány hibaválasz: 429 TooManyRequests – A kérés szabályozva van. Próbálkozzon újra az "x-ms-ratelimit-microsoft.consumption-retry-after" fejlécben megadott időre való várakozás után. 503 ServiceUnavailable – A szolgáltatás átmenetileg nem érhető el. Várjon a „Retry-After” fejlécben megadott ideig, majd próbálkozzon újra.
OperationStatus	A hosszú ideig futó művelet állapota.
OperationStatusType	A hosszú ideig futó művelet állapota.
ReservationReportSchema	A reportUrl blob hivatkozásból származó CSV-fájl foglalási használati adatokból áll, napi részletességgel az alábbi sémával

ErrorDetails

A hiba részletei.

Name	Típus	Description
code	string	Hibakód.
message	string	Hibaüzenet, amely jelzi, hogy a művelet miért hiúsult meg.

ErrorResponse

A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg.

Néhány hibaválasz:

• 429 TooManyRequests – A kérés szabályozva van. Próbálkozzon újra az "x-ms-ratelimit-microsoft.consumption-retry-after" fejlécben megadott időre való várakozás után.

• 503 ServiceUnavailable – A szolgáltatás átmenetileg nem érhető el. Várjon a „Retry-After” fejlécben megadott ideig, majd próbálkozzon újra.

Name	Típus	Description
error	ErrorDetails	A hiba részletei.

OperationStatus

A hosszú ideig futó művelet állapota.

Name	Típus	Description
properties.reportUrl	ReservationReportSchema	A reportUrl blob hivatkozásból származó CSV-fájl foglalási használati adatokból áll, napi részletességgel az alábbi sémával
properties.validUntil	string	A jelentés URL-címének érvénytelenné válásának időpontja.
status	OperationStatusType	A hosszú ideig futó művelet állapota.

OperationStatusType

A hosszú ideig futó művelet állapota.

Name	Típus	Description
Completed	string
Failed	string
Running	string

ReservationReportSchema

A reportUrl blob hivatkozásból származó CSV-fájl foglalási használati adatokból áll, napi részletességgel az alábbi sémával

Name	Típus	Description
InstanceFlexibilityGroup	string
InstanceFlexibilityRatio	string
InstanceId	string
Kind	string
ReservationId	string
ReservationOrderId	string
ReservedHours	string
SkuName	string
TotalReservedQuantity	string
UsageDate	string
UsedHours	string