Generate Reservation Details Report - By Billing Account Id

Service:

Cost Management

Version de l’API:

2025-03-01

Génère le rapport des détails des réservations pour la plage de dates fournie de manière asynchrone en fonction de l’ID d’inscription. Les détails de l’utilisation de la réservation ne peuvent être consultés que par certains rôles d’entreprise. Pour plus d’informations sur les rôles, consultez : 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?api-version=2025-03-01&startDate={startDate}&endDate={endDate}

Paramètres d’URI

Nom	Dans	Obligatoire	Type	Description
billingAccountId	path	True	string	FacturationID de compte
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.
endDate	query	True	string	Date de fin
startDate	query	True	string	Date de début

Réponses

Nom	Type	Description
200 OK	OperationStatus	L’opération Azure s’est terminée avec succès.
202 Accepted		Opération de ressource acceptée. En-têtes Location: string
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Couler: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

ReservationDetails

Demande d’échantillon

HTTP

POST https://management.azure.com/providers/microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/generateReservationDetailsReport?api-version=2025-03-01&startDate=2020-01-01&endDate=2020-01-30

Exemple de réponse

Code d’état:

200

{
  "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"
  },
  "status": "Completed"
}

Code d’état:

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

Définitions

Nom	Description
ErrorDetails	Détails de l’erreur.
ErrorResponse	La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur. \n\nQuelques réponses à l’erreur : \n\n * 429 TooMuchRequests - La requête est réduite. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « x-ms-ratelimit-microsoft.consumption-retry-after ». \n\n * 503 ServiceIndisponible - Le service est temporairement indisponible. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « Retry-After ».
OperationStatus	État de l’opération de longue durée.
OperationStatusType	Enum représentant le statut d’une opération asynchrone.
ReservationReportSchema	Le fichier CSV à partir du lien blob reportUrl se compose de données d’utilisation de réservation avec le schéma suivant à la granularité quotidienne

ErrorDetails

Objet

Détails de l’erreur.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur indiquant pourquoi l’opération a échoué.

ErrorResponse

Objet

La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur. \n\nQuelques réponses à l’erreur : \n\n * 429 TooMuchRequests - La requête est réduite. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « x-ms-ratelimit-microsoft.consumption-retry-after ». \n\n * 503 ServiceIndisponible - Le service est temporairement indisponible. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « Retry-After ».

Nom	Type	Description
error	ErrorDetails	Détails de l’erreur.

OperationStatus

Objet

État de l’opération de longue durée.

Nom	Type	Description
properties.reportUrl	ReservationReportSchema	Le fichier CSV à partir du lien blob reportUrl se compose de données d’utilisation de réservation avec le schéma suivant à la granularité quotidienne
properties.validUntil	string (date-time)	Heure à laquelle l’URL du rapport devient non valide.
status	OperationStatusType	État de l’opération de longue durée.

OperationStatusType

Énumération

Enum représentant le statut d’une opération asynchrone.

Valeur	Description
Running
Completed
Failed

ReservationReportSchema

Énumération

Le fichier CSV à partir du lien blob reportUrl se compose de données d’utilisation de réservation avec le schéma suivant à la granularité quotidienne

Valeur	Description
InstanceFlexibilityGroup
InstanceFlexibilityRatio
InstanceId
Kind
ReservationId
ReservationOrderId
ReservedHours
SkuName
TotalReservedQuantity
UsageDate
UsedHours