Partilhar via

Migrar da API de Resumo de Uso de Instância Reservada da EA

  • Artigo

Os clientes EA que usavam anteriormente a API do Enterprise Reporting 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 a seguir ajudam você a migrar e discutir 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 uma entidade 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 resumo de uso da instância reservada

Utilize os seguintes URIs de pedido para chamar a nova API de Resumos de Reserva.

Pedidos suportados

Chame a API com os seguintes âmbitos:

  • Inscrição: 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=2023-05-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=2023-05-01

Alterações ao corpo da resposta

Resposta antiga:

[
     {
        "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "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": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "skuName": "Standard_B1s",
        "reservedHours": 720,
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0
      }
    }
  ]
}

Conteúdos relacionados