APIs de recomendação de compra de instância reservada para clientes corporativos

  • Artigo

Observação

Em 1º de maio de 2024, as APIs do Azure Enterprise Reporting serão desativadas. Todas as APIs de Relatórios Empresariais restantes deixarão de responder às solicitações. Os clientes precisam fazer a transição para o uso de APIs de Gerenciamento de Custos da Microsoft antes disso. Para saber mais, confira Migrar do Azure Enterprise Reporting para a visão geral das APIs de Gerenciamento de Custos da Microsoft.

A API de Recomendações de Instância Reservada analisa os 7, 30 ou 60 dias de uso de máquina virtual do Cliente e oferece recomendações de Compra Única e Compartilhada.

Solicitação para recomendações de instância reservada compartilhada

Consulte o artigo Visão geral das APIs de Relatório para clientes Enterprise para saber mais sobre as propriedades comuns de cabeçalho necessárias.

Método URI da solicitação
GET https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/SharedReservationRecommendations?lookBackPeriod=7

Resposta de recomendações compartilhadas

[{
    "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"
}
]

Definições da propriedade de resposta

Nome da propriedade Tipo Descrição
lookBackPeriod string Cadeia de caracteres que representa o número de dias de uso passados. Pode durar 7 dias, últimos 30 dias ou últimos 60 dias
meterId string A ID do medidor do recurso que deve ser comprado
skuName string Esse é o SKU do Azure Resource Manager que precisa ser comprado
Termo string P1Y por 1 ano e P3Y por 3 anos
region string Região em que a instância reservada deve ser adquirida
costWithNoRI string Custo atual total
recommendedQuantity decimal Quantidade total de instância reservada que deve ser adquirida
totalCostWithRI decimal Custo Total se a Quantidade Recomendada foi comprada
netSavings decimal Economia líquida dentro de 7, 30 ou 60 dias
firstUsageDate decimal Primeira vez que a VM recomendada foi executada.

Solicitação para recomendações de instância reservada única

Consulte o artigo Visão geral das APIs de Relatório para clientes Enterprise para saber mais sobre as propriedades comuns de cabeçalho necessárias.

Método URI da solicitação
GET https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/SingleReservationRecommendations?lookBackPeriod=7

Resposta de recomendação ú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"
}
]

Definições da propriedade de resposta

Nome da propriedade Tipo Descrição
subscriptionId string SubscriptionId para a qual a Instância Reservada deve ser adquirida
lookBackPeriod string Cadeia de caracteres que representa o número de dias de uso passados. Pode ter last7days, last30days ou last60days
meterId string A ID do medidor do recurso que deve ser comprado
skuName string Esse é o SKU do Azure Resource Manager que precisa ser comprado
Termo string P1Y por 1 ano e P3Y por 3 anos
region string Região em que a instância reservada deve ser adquirida
costWithNoRI string Custo atual total
recommendedQuantity decimal Quantidade total de instância reservada que deve ser adquirida
totalCostWithRI decimal Custo Total se a Quantidade Recomendada foi comprada
netSavings decimal Economia líquida dentro de 7, 30 ou 60 dias
firstUsageDate decimal Primeira vez que a VM recomendada foi executada.

Confira também