Migrar da API de recomendações de instância reservada da EA
Os clientes EA que anteriormente usavam a API do Enterprise Reporting consumption.azure.com para obter recomendações de instância reservada precisam migrar para uma API paritária do Azure Resource Manager. As instruções a seguir ajudam você a migrar e descrever quaisquer diferenças contratuais entre a API antiga e a nova API.
Nota
Todas as APIs do Azure Enterprise Reporting são desativadas. Você deve migrar para as APIs do Microsoft Cost Management o mais rápido possível.
Atribuir permissões a um princípio de serviço para chamar a API
Antes de chamar a API, você precisa configurar uma entidade de serviço com a permissão correta. Use a entidade de serviço para chamar a API. Para obter mais informações, consulte Atribuir permissões a APIs de gerenciamento de custos.
Chamar a API de recomendações de instância reservada
Utilize os seguintes URIs de pedido para chamar a nova API de Recomendações de Reserva.
Pedidos suportados
Chame a API com os seguintes âmbitos:
- Inscrição:
providers/Microsoft.Billing/billingAccounts/{billingAccountId}
- Subscrição:
subscriptions/{subscriptionId}
- Grupos de recursos:
subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}
Estão disponíveis através desta API as recomendações de âmbitos partilhados e únicos. Também pode filtrar pelo âmbito, como parâmetro opcional da API.
https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/reservationRecommendations?api-version=2023-05-01
Alterações ao corpo da resposta
Na nova API, as recomendações para escopos Compartilhado e Único são combinadas em uma API.
Resposta antiga para escopo compartilhado:
{
"lookBackPeriod": "Last60Days",
"meterId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"skuName": "Standard_B1s",
"term": "P3Y",
"region": "eastus",
"costWithNoRI": 39.773316464000011,
"recommendedQuantity": 2,
"totalCostWithRI": 22.502541385887369,
"netSavings": 17.270775078112642,
"firstUsageDate": "2024-02-23T00:00:00",
"resourceType": "virtualmachines",
"instanceFlexibilityRatio": 2.0,
"instanceFlexibilityGroup": "BS Series",
"normalizedSize": "Standard_B1ls",
"recommendedQuantityNormalized": 4.0,
"skuProperties": [
{
"name": "Cores",
"value": "1"
},
{
"name": "Ram",
"value": "1"
}
]
},
Resposta antiga para escopo único:
{
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"lookBackPeriod": "Last60Days",
"meterId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"skuName": "Standard_B1s",
"term": "P3Y",
"region": "eastus",
"costWithNoRI": 19.892601567999996,
"recommendedQuantity": 1,
"totalCostWithRI": 11.252968788943683,
"netSavings": 8.6396327790563134,
"firstUsageDate": "2024-02-23T00:00:00",
"resourceType": "virtualmachines",
"instanceFlexibilityRatio": 2.0,
"instanceFlexibilityGroup": "BS Series",
"normalizedSize": "Standard_B1ls",
"recommendedQuantityNormalized": 2.0,
"skuProperties": [
{
"name": "Cores",
"value": "1"
},
{
"name": "Ram",
"value": "1"
}
]
}
Resposta nova:
{
"value": [
{
"id": "billingAccount/123456/providers/Microsoft.Consumption/reservationRecommendations/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"name": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"type": "Microsoft.Consumption/reservationRecommendations",
"location": "westus",
"sku": "Standard_DS1_v2",
"kind": "legacy",
"properties": {
"meterId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"term": "P1Y",
"costWithNoReservedInstances": 12.0785105,
"recommendedQuantity": 1,
"totalCostWithReservedInstances": 11.4899644807748,
"netSavings": 0.588546019225182,
"firstUsageDate": "2019-07-07T00:00:00-07:00",
"scope": "Shared",
"lookBackPeriod": "Last7Days",
"instanceFlexibilityRatio": 1,
"instanceFlexibilityGroup": "DSv2 Series",
"normalizedSize": "Standard_DS1_v2",
"recommendedQuantityNormalized": 1,
"skuProperties": [
{
"name": "Cores",
"value": "1"
},
{
"name": "Ram",
"value": "1"
}
]
}
},
]
}
Conteúdos relacionados
- Leia o artigo de visão geral da migração de relatórios EA para APIs ARM.