API de recomendaciones de compra de instancias reservadas para clientes empresariales

  • Artículo

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 recomendaciones de instancias reservadas examina el uso de las máquinas virtuales del cliente correspondiente a 7, 30 o 60 días y ofrece recomendaciones de compra única y compartida.

Solicitud de recomendaciones de instancias reservadas compartidas

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

Método URI de solicitud
GET https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/SharedReservationRecommendations?lookBackPeriod=7

Respuesta de recomendaciones compartidas

[{
    "lookBackPeriod": "Last7Days",
    "meterId": "2e3c2132-1398-43d2-ad45-1d77f6574933",
    "skuName": "Standard_DS1_v2",
    "term": "P1Y",
    "region": "westus",
    "costWithNoRI": 186.27634908960002,
    "recommendedQuantity": 9,
    "totalCostWithRI": 143.12931642978083,
    "netSavings": 43.147032659819189,
    "firstUsageDate": "2018-02-19T00:00:00"
}
]

Definiciones de propiedad de respuesta

Nombre de propiedad Tipo Descripción
lookBackPeriod string Cadena que representa el número de días de uso pasados. Puede ser last7days, last30days o last60days
meterId string Identificador de medidor del recurso que se debe comprar.
skuName string Se trata de la SKU de Azure Resource Manager que debe adquirirse.
término string P1Y durante 1 año y P3Y durante 3 años
region string Región en la que se debe adquirir la instancia reservada
costWithNoRI string Costo actual total
recommendedQuantity Decimal Cantidad total de instancias reservadas que se deben comprar
totalCostWithRI Decimal Costo total si se compró la cantidad recomendada
netSavings Decimal Ahorro neto en un plazo de 7, 30 o 60 días
firstUsageDate Decimal Primera vez que se ejecutó la máquina virtual recomendada.

Solicitud de recomendaciones de instancias reservadas únicas

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

Método URI de solicitud
GET https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/SingleReservationRecommendations?lookBackPeriod=7

Respuesta de recomendación única

[{
    "subscriptionId": "d143f4db-5a12-46b9-ba15-9bff298b8f45",
    "lookBackPeriod": "Last7Days",
    "meterId": "2e3c2132-1398-43d2-ad45-1d77f6574933",
    "skuName": "Standard_DS1_v2",
    "term": "P1Y",
    "region": "westus",
    "costWithNoRI": 186.27634908960002,
    "recommendedQuantity": 9,
    "totalCostWithRI": 143.12931642978083,
    "netSavings": 43.147032659819189,
    "firstUsageDate": "2018-02-19T00:00:00"
}
]

Definiciones de propiedad de respuesta

Nombre de propiedad Tipo Descripción
subscriptionId string SubscriptionId para el que se debe adquirir la instancia reservada
lookBackPeriod string Cadena que representa el número de días de uso pasados. Puede tener last7days, last30days o last60days
meterId string Identificador de medidor del recurso que se debe comprar.
skuName string Se trata de la SKU de Azure Resource Manager que debe adquirirse.
término string P1Y durante 1 año y P3Y durante 3 años
region string Región en la que se debe adquirir la instancia reservada
costWithNoRI string Costo actual total
recommendedQuantity Decimal Cantidad total de instancias reservadas que se deben comprar
totalCostWithRI Decimal Costo total si se compró la cantidad recomendada
netSavings Decimal Ahorro neto en un plazo de 7, 30 o 60 días
firstUsageDate Decimal Primera vez que se ejecutó la máquina virtual recomendada.

Consulte también