Introducción a la migración de Azure Enterprise Reporting a las API de Microsoft Cost Management

  • Artículo

En este artículo se informa a los desarrolladores de que han creado soluciones personalizadas mediante las API de Azure Enterprise Reporting sobre los cambios importantes. Las nuevas API de Microsoft Cost Management ahora ofrecen funcionalidades mejoradas y compatibilidad con entidades de servicio, lo que las convierte en una opción más sólida para los proyectos.

Puntos clave:

  • Migración recomendada: se recomienda encarecidamente que considere la posibilidad de migrar las soluciones personalizadas a las API de Microsoft Cost Management. Se desarrollan de forma activa y ofrecen una funcionalidad mejorada.
  • Fecha de retirada: se retiraron todas las API de Azure Enterprise Reporting.

En este artículo se ofrece lo siguiente:

  • Información general sobre las diferencias entre las API de Azure Enterprise Reporting y las API de Cost Management.
  • Instrucciones sobre qué esperar al migrar a las API de Cost Management.
  • Conclusiones sobre las nuevas funcionalidades disponibles con las API de Cost Management.

Llamada a la acción:

  • Para garantizar una transición fluida, le recomendamos que empiece a planear la migración a las API de Cost Management antes de la fecha de retirada.

Diferencias entre las API

La siguiente información describe las diferencias entre las antiguas API de Azure Enterprise Reporting y las nuevas API de Cost Management.

Uso API de Azure Enterprise Reporting API de Microsoft Cost Management
Autenticación Clave de API aprovisionada en Azure Portal Autenticación de Microsoft Entra mediante tokens de usuario o entidades de servicio. Las entidades de servicio sustituyen a las claves de API.
Permisos y ámbitos Todas las solicitudes se encuentran en el ámbito de inscripción. Las asignaciones de permisos de la clave de API determinarán si se devuelven los datos de toda la inscripción, de un departamento o de una cuenta concreta. Sin autenticación de usuario. A los usuarios o entidades de servicio se les asigna acceso a los ámbitos de inscripción, departamento o cuenta.
Punto de conexión de identificador URI https://consumption.azure.com https://management.azure.com
Estado de desarrollo En modo de mantenimiento. Camino del desuso. En desarrollo activo
API disponibles Limitado a lo que está disponible actualmente Hay API equivalentes disponibles para reemplazar todas Ias de Contrato Enterprise. También tiene a su disposición otras API de administración de costos, entre las que se incluyen:
- Presupuestos
- Alertas
- Exportaciones

Lista de comprobación para la migración

  • Familiarícese con las API REST de Azure Resource Manager.
  • Determine a qué API de Enterprise Reporting usa y vea a qué API de Cost Management se va a migrar de Azure Enterprise Reporting a las API de Microsoft Cost Management.
  • Configurar la autorización y la autenticación del servicio para las API de Cost Management. Para obtener más información, consulte Asignación de permisos a las API de ACM.
  • Pruebe las API y, a continuación, actualice cualquier código de programación para sustituir las llamadas API de Enterprise Reporting por las de la API de Cost Management.
  • Actualice el control de errores para usar códigos de errores nuevos. Estas son algunas de las consideraciones a tener en cuenta:
    • Las API de Cost Management tienen un periodo de espera de 60 segundos.
    • Las API de Cost Management tienen limitaciones de velocidad vigentes. Esto da 429 throttling error como resultado si se supera la velocidad. Compile sus soluciones de forma que no realice demasiadas llamadas API en poco tiempo.
  • Examine las otras API de Cost Management disponibles a través de Azure Resource Manager y evalúelas para usarlas más adelante. Para más información, consulte Migración de Azure Enterprise Reporting a las API de Microsoft Cost Management.

Asignación de API de Enterprise Reporting a las nuevas API de Cost Management

Use la siguiente información para identificar las API de Enterprise Reporting que usa actualmente y la API de Cost Management que debe usar en su lugar.

Escenario API de Enterprise Reporting API de Cost Management
Migración desde las API de detalles de uso de EA /usagedetails/download
/usagedetails/submit
/usagedetails
/usagedetailsbycustomdate		 Use Microsoft.CostManagement/Exports para todas las cargas de trabajo de ingesta de datos periódicas.
Use el informe Detalles de costos para conjuntos de datos pequeños a petición.
Migración desde las API de resumen de EA Balance /balancesummary Microsoft.Consumption/balances
Migración desde las API de hoja de precios de EA /pricesheet Para negociar precios, use Microsoft.Consumption/pricesheets/default
Para precios minoristas, use Retail Prices API
Migración desde Reserved Instance Usage Details API de EA /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
Migración desde Reserved Instance Usage Summary API de EA /reservationsummaries Microsoft.Consumption/reservationSummaries
Migración desde la API de recomendaciones de instancias reservadas de EA /SharedReservationRecommendations
/SingleReservationRecommendations		 Microsoft.Consumption/reservationRecommendations
Migración desde las API de cargos de instancias reservadas de EA /reservationcharges Microsoft.Consumption/reservationTransactions

Uso de API adicionales de Cost Management

Después de migrar a las API de Cost Management en escenarios de informes existentes, también puede usar muchas otras API. Las API también están disponibles a través de Azure Resource Manager y se pueden automatizar mediante la autenticación basada en la entidad de servicio. A continuación se muestra un resumen rápido de las nuevas funcionalidades que puede usar.

  • Presupuestos: se usa para establecer umbrales para supervisar de forma proactiva los costos, alertar a las partes interesadas pertinentes y automatizar acciones en respuesta a las infracciones del umbral.
  • Alertas: se usa para ver información de alertas, entre las que se incluyen las alertas de presupuesto, las alertas de factura, las alertas de crédito y las alertas de cuota.
  • Exports: se usa para programar la exportación de datos recurrente de sus cargos a la cuenta de Azure Storage que prefiera. Es la solución recomendada para clientes con una gran presencia de Azure que quieren analizar sus datos y usarlos en sus propios sistemas internos.

Pasos siguientes