Migrar das APIs de Resumo de Uso da Instância Reservada do EA

  • Artigo

Os clientes de EA que anteriormente usavam a API dos Relatórios do Enterprise consumption.azure.com para obter resumos de uso de instância reservada precisam migrar para uma API de paridade do Azure Resource Manager. As instruções para fazer isso são descritas abaixo, juntamente com diferenças contratuais entre a API antiga e a nova.

Observação

Em 1º de maio de 2024, as APIs dos Relatórios Corporativos do Azure serão desativadas. Migre para as APIs de Gerenciamento de Custos da Microsoft antes disso.

Atribuir permissões a um SPN 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, confira Atribuir permissões às APIs do ACM.

Chamar a API de resumo de Uso da Instância Reservada

Use os URIs de solicitação a seguir para chamar a nova API de Resumos de Reserva.

Solicitações com suporte

Chame a API com os seguintes escopos:

  • Registro: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Obter Resumo de Reserva Diariamente

https://management.azure.com/{scope}/Microsoft.Consumption/reservationSummaries?grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20&api-version=2019-10-01

Obter Resumo de Reserva Mensalmente

https://management.azure.com/{scope}/Microsoft.Consumption/reservationSummaries?grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20&api-version=2019-10-01

Alterações do corpo da resposta

Resposta antiga:

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

Resposta nova:

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.Consumption/reservationSummaries/reservationSummaries_Id1",
      "name": "reservationSummaries_Id1",
      "type": "Microsoft.Consumption/reservationSummaries",
      "tags": null,
      "properties": {
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "skuName": "Standard_B1s",
        "reservedHours": 720,
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0
      }
    }
  ]
}

Próximas etapas