Condividi tramite

Generate Reservation Details Report - By Billing Profile Id

  • Riferimento
Servizio:
Cost Management
Versione API:
2024-08-01

Genera il report dei dettagli delle prenotazioni per l'intervallo di date specificato in modo asincrono in base al profilo di fatturazione. I dettagli sull'utilizzo della prenotazione possono essere visualizzati solo da determinati ruoli aziendali per impostazione predefinita. Per altri dettagli sui ruoli, vedere https://docs.microsoft.com/en-us/azure/cost-management-billing/reservations/reservation-utilization#view-utilization-in-the-azure-portal-with-azure-rbac-access

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2024-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
billingAccountId
 path True

string

ID account di fatturazione
billingProfileId
 path True

string

ID profilo di fatturazione.
api-version
 query True

string

Versione dell'API da usare per questa operazione.
endDate
 query True

string

Data di fine
startDate
 query True

string

Data di inizio

Risposte

Nome Tipo Descrizione
200 OK

OperationStatus

Elaborazione della richiesta completata.
202 Accepted

Accettato. La richiesta verrà elaborata. Usare l'intestazione Location per controllare lo stato.

Intestazioni

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

ReservationDetails

Esempio di richiesta

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000/billingProfiles/CZSFR-SDFXC-DSDF/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate=2020-01-01&endDate=2020-01-30&api-version=2024-08-01

Risposta di esempio

Codice di stato:
202 
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000/billingProfiles/CZSFR-SDFXC-DSDF/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2019-11-01
Retry-After: 60
Codice di stato:
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"
  }
}

Definizioni

Nome Descrizione
ErrorDetails

Dettagli dell'errore.
ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Alcune risposte di errore:

  • 429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".
OperationStatus

Stato dell'operazione a esecuzione prolungata.
OperationStatusType

Stato dell'operazione a esecuzione prolungata.
ReservationReportSchema

Il file CSV del collegamento BLOB reportUrl è costituito dai dati di utilizzo della prenotazione con lo schema seguente a granularità giornaliera

ErrorDetails

Dettagli dell'errore.

Nome Tipo Descrizione
code

string

Codice di errore.
message

string

Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Alcune risposte di errore:

  • 429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".

Nome Tipo Descrizione
error

ErrorDetails

Dettagli dell'errore.

OperationStatus

Stato dell'operazione a esecuzione prolungata.

Nome Tipo Descrizione
properties.reportUrl

ReservationReportSchema

Il file CSV del collegamento BLOB reportUrl è costituito dai dati di utilizzo della prenotazione con lo schema seguente a granularità giornaliera
properties.validUntil

string

Ora in cui l'URL del report non è valido.
status

OperationStatusType

Stato dell'operazione a esecuzione prolungata.

OperationStatusType

Stato dell'operazione a esecuzione prolungata.

Nome Tipo Descrizione
Completed

string

Failed

string

Running

string

ReservationReportSchema

Il file CSV del collegamento BLOB reportUrl è costituito dai dati di utilizzo della prenotazione con lo schema seguente a granularità giornaliera

Nome Tipo Descrizione
InstanceFlexibilityGroup

string

InstanceFlexibilityRatio

string

InstanceId

string

Kind

string

ReservationId

string

ReservationOrderId

string

ReservedHours

string

SkuName

string

TotalReservedQuantity

string

UsageDate

string

UsedHours

string