Partilhar via

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

  • Artigo

Os clientes EA que usavam anteriormente a API do Enterprise Reporting consumption.azure.com para obter detalhes 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 detalhes de uso da instância reservada

A Microsoft não está atualizando as APIs de Detalhes de Reserva baseadas em síncronos mais antigas. Como parte da migração, recomendamos que mude para o novo padrão da chamada à API assíncrona suportada por SPN. As solicitações assíncronas lidam melhor com grandes quantidades de dados e reduzem os erros de tempo limite.

Pedidos suportados

Ao chamar a nova API de Detalhes de Reserva Assíncrona, utilize os seguintes URIs de pedido. O seu número de inscrição deverá ser utilizado como billingAccountId. Você pode chamar a API com o seguinte escopo:

Inscrição: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Gerar relatório por ID de conta de cobrança

Exemplo de pedido para gerar um relatório de detalhes de reserva

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2023-11-01

A solicitação POST retorna um local para pesquisar o status de geração de relatório, conforme descrito na seguinte resposta:

Resposta da amostra

Código de status 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2023-11-01
Retry-After: 60

Código de status 200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Exemplo de pedido para sondar o estado da geração do relatório

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/reservationDetailsOperationResults/{operationId}?api-version=2023-11-01

Exemplo de resposta da sondagem

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Alterações ao corpo da resposta

As informações a seguir são um exemplo da resposta da API de Detalhes de Reserva baseada em síncrono mais antiga.

Resposta antiga:

{
    "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/resourcegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

Resposta nova:

A API nova cria um ficheiro CSV por si. Veja os campos seguintes do ficheiro.

Propriedade antiga Nova propriedade Notas
InstanceFlexibilityGroup A nova propriedade de flexibilidade de tamanho de instância.
InstanceFlexibilityRatio A nova propriedade de flexibilidade de tamanho de instância.
instanceId InstanceName
Variante É uma propriedade nova. O valor é None, Reservation ou IncludedQuantity.
reservationId ReservationId
reservationOrderId ReservationOrderId
reservedHours ReservedHours
skuName SkuName
totalReservedQuantity TotalReservedQuantity
usageDate UsageDate
usedHours UsedHours

Conteúdos relacionados