Generate Reservation Details Report - By Billing Account Id

Service:

Cost Management

API Version:

2023-11-01

Genererar reservationsinformationsrapporten för angivet datumintervall asynkront baserat på registrerings-ID. Information om reservationsanvändning kan endast visas av vissa företagsroller. Mer information om rollerna finns i 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-parametrar

Name	I	Obligatorisk	Typ	Description
billingAccountId	path	True	string	Registrerings-ID (äldre FaktureringKonto-ID)
api-version	query	True	string	Den API-version som ska användas för den här åtgärden.
endDate	query	True	string	Slutdatum
startDate	query	True	string	Startdatum

Svar

Name	Typ	Description
200 OK	OperationStatus	Bearbetningen av begäran har slutförts.
202 Accepted		Accepterade. Begäran kommer att bearbetas. Använd platsrubriken för att kontrollera statusen. Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

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	personifiera ditt användarkonto

Exempel

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

Definitioner

Name	Description
ErrorDetails	Information om felet.
ErrorResponse	Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet. Några felsvar: 429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Vänta så lång tid som anges i rubriken ”Retry-After” och försök igen.
OperationStatus	Status för den långvariga åtgärden.
OperationStatusType	Status för den långvariga åtgärden.
ReservationReportSchema	CSV-filen från bloblänken reportUrl består av reservationsanvändningsdata med följande schema vid daglig kornighet

ErrorDetails

Information om felet.

Name	Typ	Description
code	string	Felkod.
message	string	Felmeddelande som anger varför åtgärden misslyckades.

ErrorResponse

Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.

Några felsvar:

• 429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Vänta så lång tid som anges i rubriken ”Retry-After” och försök igen.

Name	Typ	Description
error	ErrorDetails	Information om felet.

OperationStatus

Status för den långvariga åtgärden.

Name	Typ	Description
properties.reportUrl	ReservationReportSchema	CSV-filen från bloblänken reportUrl består av reservationsanvändningsdata med följande schema vid daglig kornighet
properties.validUntil	string	Tidpunkten då rapport-URL:en blir ogiltig.
status	OperationStatusType	Status för den långvariga åtgärden.

OperationStatusType

Status för den långvariga åtgärden.

Name	Typ	Description
Completed	string
Failed	string
Running	string

ReservationReportSchema

CSV-filen från bloblänken reportUrl består av reservationsanvändningsdata med följande schema vid daglig kornighet

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