Visão geral da migração do Azure Enterprise Reporting para as APIs do Microsoft Cost Management

  • Artigo

Este artigo informa os desenvolvedores que criaram soluções personalizadas usando as APIs do Azure Enterprise Reporting sobre alterações importantes. As APIs mais recentes do Microsoft Cost Management agora oferecem recursos aprimorados e suporte para entidades de serviço, tornando-as uma escolha mais robusta para seus projetos.

Pontos principais:

  • Migração recomendada - É altamente recomendável que você considere migrar suas soluções personalizadas para as APIs do Microsoft Cost Management. Eles estão sendo ativamente desenvolvidos e oferecem funcionalidades aprimoradas.
  • Data de desativação - Todas as APIs do Azure Enterprise Reporting são desativadas.

Este artigo fornece:

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

Apelo à ação:

  • Para garantir uma transição suave, recomendamos que você comece a planejar sua migração para as APIs de gerenciamento de custos bem antes da data de aposentadoria.

Diferenças entre as APIs

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

Utilizar APIs de Relatórios Empresariais do Azure APIs de 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 substituem as chaves de API.
Escopos e permissões Todas as solicitações estão no escopo de inscrição. As atribuições de permissão de chave de API determinarão se os dados de toda a inscrição, de um departamento ou de uma conta específica serão retornados. Sem autenticação do utilizador. Os usuários ou entidades de serviço recebem acesso ao escopo de inscrição, departamento ou conta.
Ponto final de URI https://consumption.azure.com https://management.azure.com
Estado de desenvolvimento Em modo de manutenção. A caminho da descontinuação. Em desenvolvimento ativo
APIs disponíveis Limitado ao que está atualmente disponível Estão disponíveis APIs equivalentes para substituir cada API do EA. APIs adicionais de gerenciamento de custos também estão disponíveis, incluindo:
- Orçamentos
- Alertas
- Exportações

Lista de verificação da migração

  • Familiarizar-se com as APIs REST do Azure Resource Manager.
  • Determine quais APIs de Relatório Empresarial você usa e veja para quais APIs de Gerenciamento de Custos mover em Migrar do Azure Enterprise Reporting para APIs de Gerenciamento de Custos da Microsoft.
  • Configure a autorização e autenticação de serviço para as APIs de Gerenciamento de Custos. Para obter mais informações, consulte Atribuir permissão a APIs do ACM.
  • Teste as APIs e, em seguida, atualize qualquer código de programação para substituir chamadas de API de Relatório Empresarial por chamadas de API de Gerenciamento de Custos.
  • Atualize o processamento de erros para utilizar os novos códigos de erro. Algumas considerações incluem:
    • As APIs de gerenciamento de custos têm um período de 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 são excedidas. Crie suas soluções para que você não faça muitas chamadas de API em um curto período de tempo.
  • Reveja as outras APIs do Cost Management que estão disponíveis através do Azure Resource Manager e avalie-as para utilização mais tarde. Para obter mais informações, consulte Migrar do Azure Enterprise Reporting para APIs do Microsoft Cost Management.

Mapeamento da API de relatórios corporativos para novas APIs de gerenciamento de custos

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

Cenário APIs de relatórios corporativos APIs do Cost Management
Migrar a partir de APIs de Detalhes de Uso da EA /usagedetails/download
/usagedetails/enviar
/usagedetails
/usagedetailsbycustomdate		 Use Microsoft.CostManagement/Exports para todas as cargas de trabalho recorrentes de ingestão de dados.
Use o relatório Detalhes de custo para pequenos conjuntos de dados sob demanda.
Migrar de APIs do EA Balance Summary /balancesummary Microsoft.Consumption/balances
Migrar a partir de APIs de Folha 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 da EA /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
Migrar de APIs de resumo de uso de instância reservada do EA /reservationsummaries Microsoft.Consumption/reservationSummaries
Migrar de APIs de recomendações de instância reservada da EA /SharedReservationRecommendations
/SingleReservationRecommendations		 Microsoft.Consumption/reservationRecommendations
Migrar de APIs de Encargos de Instância Reservada da EA /reservationcharges Microsoft.Consumption/reservationTransactions

Utilizar as APIs adicionais do Cost Management

Depois de migrar para as APIs de gerenciamento de custos para seus cenários de relatórios 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 na entidade de serviço. Eis um resumo rápido das novas capacidades que pode utilizar.

  • Orçamentos – utilizar para definir limiares para monitorizar proativamente os seus custos, alertar intervenientes relevantes e automatizar ações em resposta a violações aos limiares.
  • Alertas – utilizar para ver informações de alertas, incluindo, entre outros, alertas de orçamentos, alertas de faturas, alertas de crédito e alertas de quota.
  • Exportações – utilizar para agendar a exportação recorrente dos seus custos para uma conta do Armazenamento do Azure à sua escolha. É a solução recomendada para os clientes com uma grande presença no Azure e que pretendam analisar os respetivos dados e utilizá-los nos seus próprios sistemas internos.

Próximos passos