Obtención del uso de instancias reservadas para clientes empresariales

Artículo
03/05/2024

Nota

El 1 de mayo de 2024, se retirarán las API de Azure Enterprise Reporting. Las API de enterprise Reporting restantes dejarán de responder a las solicitudes. Los clientes deben realizar la transición al uso de las API de Microsoft Cost Management antes de entonces. Para más información, consulte Introducción a la migración de Azure Enterprise Reporting a las API de Microsoft Cost Management.

La API de uso de instancias reservadas devuelve el uso de las compras de instancias reservadas dentro de una inscripción. Si hay más de una instancia reservada en una inscripción, puede obtener el uso de todas las compras de instancias reservadas con esta API.

Solicitud de los detalles de uso de las instancias reservadas

Consulte el artículo Introducción a las API de informes para clientes de Enterprise para obtener información sobre las propiedades de encabezado comunes necesarias.

Método	URI de solicitud
GET	`https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/reservationdetails?startDate={yyyy-mm-dd}&endDate={yyyy-mm-dd}`

Respuesta de detalles de uso

[{
    "reservationOrderId": "00000000-0000-0000-0000-000000000000",
    "reservationId": "00000000-0000-0000-0000-000000000000",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resourvegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

Definiciones de propiedad de respuesta

Nombre de propiedad	Tipo	Descripción
reservationOrderId	string	El identificador del pedido de reserva es el identificador de una compra de reserva. Cada identificador de pedido de reserva representa una única transacción de compra. Un pedido de reserva contiene reservas. El pedido de reserva especifica el tamaño y la región de la máquina virtual para las reservas.
reservationId	string	El identificador de reserva es el identificador de una reserva dentro de un pedido de reserva. Cada reserva es la agrupación para aplicar el ámbito de la ventaja y también especifica el número de instancias a las que se puede aplicar la ventaja de reserva.
usageDate	string	Fecha en la que se produjo el consumo.
skuName	string	Este es el nombre de la SKU de Azure Resource Manager. Se puede usar para combinar con el campo servicetype en additionalInfo en los registros de uso.
instanceId	string	Este identificador es el nombre del recurso o el identificador de recurso completo.
totalReservedQuantity	string	Este es el recuento total de instancias reservadas para el identificador de reserva.
reservedHours	Decimal	Este es el total de horas reservadas para el día. Por ejemplo, si la reserva para 1 instancia se realizó a las 1 p. m., las horas reservadas serán de 11 horas para el primer día y las 24 horas para los días posteriores.
usedHours	Decimal	Este es el total de horas usadas por la instancia de .

Resumen de uso de la solicitud de instancia reservada

Consulte el artículo Introducción a las API de informes para clientes de Enterprise para obtener información sobre las propiedades de encabezado comunes necesarias. La API admite el uso de reservas para el grano diario y mensual. Los parámetros Startdate y EndDate no son necesarios para los datos mensuales.

Método	URI de solicitud
GET	`https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/reservationsummaries?grain=daily&startdate={yyyy-mm-dd}&enddate={yyyy-mm-dd}`

Respuesta de resumen de uso

[
     {
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "skuName": "Standard_F1s",
        "reservedHours": 24,
        "usageDate": "2018-05-01T00:00:00",
        "usedHours": 23,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 95.83,
        "maxUtilizationPercentage": 100
    }
]