Generate Reservation Details Report - By Billing Account Id

Servicio:

Cost Management

Versión de la API:

2024-08-01

Genera el informe de detalles de reservas para el intervalo de fechas proporcionado de forma asincrónica en función del identificador de inscripción. Los detalles de uso de la reserva solo se pueden ver mediante determinados roles empresariales. Para obtener más información sobre los roles, consulte 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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
billingAccountId	path	True	string	Id. de inscripción (Id. de cuenta de facturación heredado)
api-version	query	True	string	Versión de la API que se va a usar para esta operación.
endDate	query	True	string	Fecha final
startDate	query	True	string	Fecha de inicio

Respuestas

Nombre	Tipo	Description
200 OK	OperationStatus	Se completó el procesamiento de solicitudes.
202 Accepted		Aceptado. Se procesará la solicitud. Use el encabezado de ubicación para comprobar el estado. Encabezados Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

ReservationDetails

Solicitud de ejemplo

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=2024-08-01

Respuesta de muestra

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

Definiciones

Nombre	Description
ErrorDetails	Detalles del error.
ErrorResponse	La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error. Algunas respuestas de error: 429 TooManyRequests: la solicitud está limitada. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable: el servicio no está disponible temporalmente. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "Retry-After".
OperationStatus	Estado de la operación de larga duración.
OperationStatusType	Estado de la operación de larga duración.
ReservationReportSchema	El archivo CSV del vínculo de blob reportUrl consta de datos de uso de reserva con el esquema siguiente en granularidad diaria.

ErrorDetails

Detalles del error.

Nombre	Tipo	Description
code	string	Código de error.
message	string	Mensaje de error que indica por qué se produjo un error en la operación.

ErrorResponse

La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.

Algunas respuestas de error:

• 429 TooManyRequests: la solicitud está limitada. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiceUnavailable: el servicio no está disponible temporalmente. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "Retry-After".

Nombre	Tipo	Description
error	ErrorDetails	Detalles del error.

OperationStatus

Estado de la operación de larga duración.

Nombre	Tipo	Description
properties.reportUrl	ReservationReportSchema	El archivo CSV del vínculo de blob reportUrl consta de datos de uso de reserva con el esquema siguiente en granularidad diaria.
properties.validUntil	string	La hora en la que la dirección URL del informe deja de ser válida.
status	OperationStatusType	Estado de la operación de larga duración.

OperationStatusType

Estado de la operación de larga duración.

Nombre	Tipo	Description
Completed	string
Failed	string
Running	string

ReservationReportSchema

El archivo CSV del vínculo de blob reportUrl consta de datos de uso de reserva con el esquema siguiente en granularidad diaria.

Nombre	Tipo	Description
InstanceFlexibilityGroup	string
InstanceFlexibilityRatio	string
InstanceId	string
Kind	string
ReservationId	string
ReservationOrderId	string
ReservedHours	string
SkuName	string
TotalReservedQuantity	string
UsageDate	string
UsedHours	string