Generate Reservation Details Report - By Billing Account Id

  • Referens
Tjänst:
Cost Management
API-version:
2024-08-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=2024-08-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

Accepterad. Begäran bearbetas. Använd platsrubriken för att kontrollera statusen.

Sidhuvuden

  • 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.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

ReservationDetails

Exempelbegäran

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

Exempelsvar

Statuskod:
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
Statuskod:
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. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".
OperationStatus

Status för den tidskrävande åtgärden.
OperationStatusType

Status för den tidskrävande å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. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".

Name Typ Description
error

ErrorDetails

Information om felet.

OperationStatus

Status för den tidskrävande å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 tidskrävande åtgärden.

OperationStatusType

Status för den tidskrävande å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