Compartir a través de

Generate Reservation Details Report - By Billing Profile Id

  • Referencia
Service:
Cost Management
API Version:
2023-11-01

Genera el informe de detalles de reservas para el intervalo de fechas proporcionado de forma asincrónica mediante el perfil de facturación. Los detalles de uso de la reserva solo se pueden ver mediante determinados roles de empresa de forma predeterminada. Para obtener más información sobre los roles, consulte: 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=2023-11-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
billingAccountId
 path True

string

Identificador de la cuenta de facturación
billingProfileId
 path True

string

Id. de perfil de facturación.
api-version
 query True

string

Versión de API que se usará para la operación.
endDate
 query True

string

Fecha de finalización
startDate
 query True

string

Fecha de inicio

Respuestas

Nombre Tipo Description
200 OK

OperationStatus

Se completó el procesamiento de solicitudes.
202 Accepted

Accepted. Se procesará la solicitud. Use el encabezado Location para comprobar el estado.

Headers

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

ErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

ReservationDetails

Sample Request

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=2023-11-01

Sample Response

Status code:
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
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 "Vuelva a intentarlo después de".
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 siguiente esquema 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 "Vuelva a intentarlo después de".

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 siguiente esquema 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 siguiente esquema 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