Visão geral da Migração das APIs de Relatórios Empresariais do Azure para APIs de Gerenciamento de Custos da Microsoft

  • Artigo

Este artigo informa aos desenvolvedores que criaram soluções personalizadas usando as APIs do Azure Enterprise Reporting sobre alterações importantes. As APIs mais recentes do Gerenciamento de Custos da Microsoft agora oferecem recursos melhorados e suporte para entidades de serviço, tornando-as uma opção mais robusta para seus projetos.

Pontos principais:

  • Migração recomendada: é altamente recomendável migrar suas soluções personalizadas às APIs de Gerenciamento de Custos da Microsoft. Elas estão sendo desenvolvidas continuamente e oferecem funcionalidade melhorada.
  • Data de desativação – as APIs do Azure Enterprise Reporting serão desativadas em 1º de maio de 2024. Após essa data, as APIs deixarão de responder às solicitações.

Esse artigo fornece:

  • Uma visão geral das diferenças entre as APIs do Azure Enterprise Reporting e as APIs de Gerenciamento de Custos.
  • Diretrizes sobre o que esperar ao migrar para as APIs de Gerenciamento de Custos.
  • Insights sobre os novos recursos disponíveis com as APIs de Gerenciamento de Custos.

Plano de ação:

  • Para garantir uma transição tranquila, recomendamos que você comece a planejar sua migração para as APIs de Gerenciamento de Custos bem antes da data de desativação.

Diferenças de API

As informações a seguir descrevem as diferenças entre as APIs de Relatórios Empresariais do Azure mais antigas e as APIs do Gerenciamento de Custos mais recentes.

Use APIs de Relatórios do Azure Enterprise APIs do Gerenciamento de Custos da Microsoft
Autenticação Chave de API provisionada no portal do Azure Autenticação do Microsoft Entra usando tokens de usuário ou entidades de serviço. As entidades de serviço assumem o lugar das chaves de API.
Permissões e escopos Todas as solicitações estão no escopo do registro. As atribuições de permissão da Chave de API determinarão se os dados de todo o registro, um departamento ou uma conta específica serão retornados. Nenhuma autenticação do usuário. Os usuários ou as entidades de serviço recebem acesso ao escopo de registro, departamento ou conta.
Ponto de extremidade do URI https://consumption.azure.com https://management.azure.com
Status de desenvolvimento No modo de manutenção. No caminho para a substituição. Em desenvolvimento ativo
APIs disponíveis Limitado ao que está disponível no momento APIs equivalentes estão disponíveis para substituir cada API do EA. As APIs do Gerenciamento de Custos também estão disponíveis, incluindo:
- Orçamentos
- Alertas
- Exportações

Lista de verificação de migração

  • Familiarizar-se com as APIs REST do Azure Resource Manager.
  • Determine quais APIs de Relatórios Empresariais você usa e veja para quais APIs do Gerenciamento de Custos migrar em Migrar dos Relatórios Empresariais do Azure para as APIs do Gerenciamento de Custos da Microsoft.
  • Configure a autorização e a autenticação do serviço para as APIs do Gerenciamento de Custos. Para obter mais informações, confira Atribuir permissão às APIs do ACM.
  • Teste as APIs e atualize qualquer código de programação para substituir chamadas à API de Relatórios Empresariais por chamadas à API do Gerenciamento de Custos.
  • Atualize o tratamento de erro para usar novos códigos de erro. Outras considerações incluem:
    • As APIs do Gerenciamento de Custos têm um tempo limite de 60 segundos.
    • As APIs de Gerenciamento de Custos têm limite de taxa em vigor. Isso resulta em um 429 throttling error se as taxas forem excedidas. Crie as soluções para que você não faça muitas chamadas à API em um curto período de tempo.
  • Examine as outras APIs de Gerenciamento de Custos disponíveis por meio do Azure Resource Manager e avalie o uso posteriormente. Para obter mais informações, confira Migrar do Azure Enterprise Reporting para APIs de Gerenciamento de Custos da Microsoft.

Mapeamento da API de Relatórios Empresariais para as novas APIs de Gerenciamento de Custos

Use as informações a seguir para identificar as APIs de Relatórios Empresariais que você usa atualmente e a API de Gerenciamento de Custos substituta a ser usada.

Cenário APIs de Relatórios Empresariais APIs de Gerenciamento de Custos
Migrar das APIs de Detalhes de Uso do EA /usagedetails/download
/usagedetails/submit
/usagedetails
/usagedetailsbycustomdate		 Use Microsoft.CostManagement/Exports para todas as cargas de trabalho de ingestão de dados recorrentes.
Use o relatório Detalhes de Custo para pequenos conjuntos de dados sob demanda.
Migrar da API de Resumo de Saldo do EA /balancesummary Microsoft.Consumption/balances
Migrar da API da Tabela de Preços do EA /pricesheet Para preços negociados, use Microsoft.Consumption/pricesheets/default
Para preços de varejo, use a API de Preços de Varejo
Migrar da API de Detalhes de Uso da Instância Reservada do EA /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
Migrar das APIs de Resumo de Uso da Instância Reservada do EA /reservationsummaries Microsoft.Consumption/reservationSummaries
Migrar das APIs de Recomendações de Instância Reservada do EA /SharedReservationRecommendations
/SingleReservationRecommendations		 Microsoft.Consumption/reservationRecommendations
Migrar das APIs de encargos de instância reservada do EA /reservationcharges Microsoft.Consumption/reservationTransactions

Usar APIs de Gerenciamento de Custos adicionais

Depois de migrar para as APIs do Gerenciamento de Custos em seus cenários de relatório existentes, você também poderá usar muitas outras APIs. As APIs também estão disponíveis por meio do Azure Resource Manager e podem ser automatizadas usando a autenticação baseada em entidade de serviço. Este é um breve resumo das novas funcionalidades que você pode usar.

  • Orçamentos – use para definir limites a fim de monitorar proativamente seus custos, alertar os stakeholders relevantes e automatizar ações em resposta a violações de limite.
  • Alertas – use para ver informações de alerta, incluindo, entre outros, alertas de orçamento, alertas de fatura, alertas de crédito e alertas de cota.
  • Exportações – use para agendar a exportação de dados recorrentes de seus encargos para uma conta do Armazenamento do Azure de sua escolha. É a solução recomendada para clientes com uma grande presença do Azure que desejam analisar os dados e usá-los nos próprios sistemas internos.

Próximas etapas