APIs de recomendação de compra de instâncias reservadas para clientes Enterprise

  • Artigo

Nota

A 1 de maio de 2024, as APIs de Relatórios empresariais do Azure serão descontinuadas. Quaisquer APIs de Relatórios Empresariais restantes deixarão de responder aos pedidos. Os clientes têm de transitar para a utilização das APIs do Microsoft Cost Management antes disso. Para saber mais, veja Descrição geral sobre como migrar das APIs de Relatórios Enterprise do Azure para as APIs do Microsoft Cost Management.

A API de recomendações de Instâncias Reservadas analisa a utilização da máquina virtual durante 7, 30 ou 60 dias por parte do Cliente e disponibiliza recomendações de Compra Únicas e Partilhadas.

Pedido de recomendações de instâncias reservadas partilhadas

Veja o artigo Descrição geral das APIs de Relatórios para clientes Enterprise para saber mais sobre as propriedades comuns necessárias do cabeçalho.

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

Resposta de recomendações partilhadas

[{
    "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 de propriedades de resposta

Nome da Propriedade Tipo Description
lookBackPeriod string Cadeia que representa o número de dias de utilização anteriores. Pode durar 7 dias, últimos 30 dias ou últimos60 dias
meterId string O ID do Medidor do recurso que deve ser comprado
skuName string Este é o SKU do Azure Resource Manager que precisa de ser comprado
termo string P1Y para 1 ano e P3Y por 3 anos
region string Região onde a Instância reservada deve ser comprada
costWithNoRI string Custo atual total
recommendedQuantity decimal Quantidade Total de Instâncias Reservadas que deve ser comprada
totalCostWithRI decimal Custo Total se a Quantidade Recomendada tiver sido comprada
netSavings decimal Poupança Líquida dentro de 7, 30 ou 60 dias
firstUsageDate decimal Primeira vez que a VM Recomendada foi executada.

Pedido de recomendações de instâncias reservadas únicas

Veja o artigo Descrição geral das APIs de Relatórios para clientes Enterprise para saber mais sobre as propriedades comuns necessárias do cabeçalho.

Método URI do pedido
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 de propriedades de resposta

Nome da Propriedade Tipo Description
subscriptionId string SubscriptionId para o qual a Instância Reservada deve ser comprada
lookBackPeriod string Cadeia que representa o número de dias de utilização anteriores. Pode ter últimos 7 dias, últimos 30 dias ou últimos60 dias
meterId string O ID do Medidor do recurso que deve ser comprado
skuName string Este é o SKU do Azure Resource Manager que precisa de ser comprado
termo string P1Y para 1 ano e P3Y por 3 anos
region string Região onde a Instância reservada deve ser comprada
costWithNoRI string Custo atual total
recommendedQuantity decimal Quantidade Total de Instâncias Reservadas que deve ser comprada
totalCostWithRI decimal Custo Total se a Quantidade Recomendada tiver sido comprada
netSavings decimal Poupança Líquida dentro de 7, 30 ou 60 dias
firstUsageDate decimal Primeira vez que a VM Recomendada foi executada.

Ver também