Migración desde la API de Contrato Enterprise a la API de contrato de cliente de Microsoft

Este artículo lo ayudará a entender la estructura de datos, la API y otras diferencias de integración de sistemas entre las cuentas de Contrato Enterprise (EA) y de contrato de cliente de Microsoft (MCA). Cost Management es compatible con las API de ambos tipos de cuenta. Revise el artículo Configurar la cuenta de facturación para un contrato de cliente de Microsoft antes de continuar.

Las organizaciones con una cuenta existente de EA deben revisar este artículo al configurar una cuenta de MCA. Anteriormente, la renovación de una cuenta de EA requería cierto esfuerzo mínimo para migrar desde una inscripción anterior a una nueva. Pero la migración a una cuenta de MCA requiere un esfuerzo adicional. Este esfuerzo resulta necesario debido a los cambios en el subsistema de facturación subyacente, que afecta a todas las API relacionadas con los costos y a las ofertas de servicio.

APIs e integración de MCA

La nueva integración y las API de MCA le permiten:

• Tener una disponibilidad completa de las API a través de las API nativas de Azure.
• Configurar varias facturas en una sola cuenta de facturación.
• Accede a una API combinada que incluye el uso de servicios de Azure, el uso del Marketplace de terceros y las compras en el Marketplace.
• Consulte los costos en todos los perfiles de facturación (equivalente a las matrículas) utilizando Cost Management.
• Acceder a API nuevas para mostrar los costos, recibir notificaciones cuando los costos superen los umbrales predefinidos y exportar automáticamente los datos sin procesar.

Lista de comprobación para la migración

Los elementos siguientes lo ayudarán a hacer la transición a las API de MCA.

• Familiarícese con la nueva cuenta de facturación del Contrato de Cliente de Microsoft.
• Determine cuáles son las API que usa y vea cuáles se reemplazan en la sección siguiente.
• Familiarícese con las API REST de Azure Resource Manager.
• Si todavía no usa las API de Azure Resource Manager, registre su aplicación cliente con Microsoft Entra ID.
• Conceda a la aplicación que se creó durante el registro la aplicación de Microsoft Entra acceso de lectura a la cuenta de facturación mediante Control de acceso (IAM).
• Actualice cualquier código de programación para usar la autenticación de Microsoft Entra.
• Actualice cualquier código de programación para reemplazar las llamadas API de EA por las llamadas API de MCA.
• Actualice el control de errores para usar códigos de errores nuevos.
• Revise otras ofertas de integración, como Power BI, para otras acciones necesarias.

API de EA reemplazadas por API de MCA

Las API de EA usan una clave de API para la autenticación y la autorización. Las API de MCA usan la autenticación de Microsoft Entra.

¹ El uso del servicio de Azure y del Marketplace de terceros está disponible con la API de Detalles de Uso.

Las API siguientes están compatibles para las cuentas de facturación de MCA:

² Las API devuelven listas de objetos, que son ámbitos, donde operan las experiencias de Cost Management en Azure Portal y las API. Para más información sobre los ámbitos de Cost Management, consulte Descripción y uso de ámbitos.

Si usa cualquiera de las API de EA existentes, deberá actualizarlas para que admitan las cuentas de facturación de MCA. En la tabla siguiente se muestran otros cambios en la integración:

API para obtener el saldo y los créditos

La obtención de resumen de saldo se ha usado para proporcionarle un resumen mensual de lo siguiente:

• Saldos
• Nuevas compras
• Cargos por servicios de Azure Marketplace
• Ajustes
• Cargos de uso del servicio por encima del límite

Todas las API de consumo se reemplazan por las API nativas de Azure que usan Microsoft Entra ID para la autenticación y autorización. Para más información sobre cómo llamar a las API REST de Azure, consulte la introducción a REST.

La API Get Balance Summary se reemplaza por la API Microsoft.Billing/billingAccounts/billingProfiles/availableBalance.

Para obtener los saldos disponibles con la API Available Balance:

API para obtener el costo y el uso

Obtenga un desglose diario de los costos derivados del uso del servicio de Azure, del uso de Marketplace de terceros y de otras compras de Marketplace con las API siguientes. Se combinaron las siguientes APIs independientes para los servicios de Azure y el uso del Marketplace de terceros. Las API antiguas se reemplazan por Exports o Cost Details API. Para elegir la solución adecuada, vea Elección de una solución de detalles de costos. Ambas soluciones proporcionan el mismo archivo de Detalles de Costos y tienen compras de marketplace en los datos, que anteriormente solo se mostraban en el resumen de saldo hasta la fecha.

Exports y Cost Details API, al igual que con todas las API de Cost Management, están disponibles en varios ámbitos. En el caso de los costos facturados, como los recibiría tradicionalmente en un nivel de inscripción, use el ámbito del perfil de facturación. Para más información sobre los ámbitos de Cost Management, consulte Descripción y uso de ámbitos.

Algunos nombres de propiedad han cambiado en el nuevo conjunto de datos detalles de Cost Details Mediante Exports y Cost Details API. En la tabla siguiente se muestran las propiedades correspondientes.

Billing Periods API reemplazada por Invoices API

Las cuentas de facturación de MCA no usan los períodos de facturación. En su lugar, usan las facturas para centrar los costos en los períodos de facturación específicos. La API Billing Periods es reemplazada por la API Invoices. Todas las API de consumo se reemplazan por las API nativas de Azure que usan Microsoft Entra ID para la autenticación y autorización. Para más información sobre cómo llamar a las API REST de Azure, consulte la introducción a REST.

Para obtener facturas con la API Invoices:

APIs de la hoja de precios

En esta sección se analizan las Price Sheet API y se proporcionan recomendaciones para migrar a la Price Sheet API de los contratos de cliente de Microsoft. También se describe la Price Sheet API de los contratos de cliente de Microsoft y se explican los campos de las hojas de precios. Las API Enterprise Get price sheet y Enterprise Get billing periods se reemplazan por Price Sheet API para los contratos de cliente de Microsoft (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). La API nueva admite los formatos JSON y CSV, en formatos asincrónicos de REST. Todas las API de consumo se reemplazan por las API nativas de Azure que usan Microsoft Entra ID para la autenticación y autorización. Para más información sobre cómo llamar a las API REST de Azure, consulte la introducción a REST.

APIs de facturación empresarial

Utilizaste las APIs Billing Enterprise con las inscripciones de Enterprise para obtener información sobre los precios y el período de facturación. La autenticación y la autorización usaban tokens web de Microsoft Entra.

Para obtener los precios aplicables para la inscripción de Enterprise especificada con las API Price Sheet y Billing Period:

Price Sheet API para los contratos de cliente de Microsoft

Utilice la API de la hoja de precios para los acuerdos de cliente de Microsoft para ver los precios de todos los servicios de consumo de Azure y de Marketplace. Los precios que se muestran para el perfil de facturación se aplican a todas las suscripciones que pertenecen al perfil de facturación.

Use Price Sheet API para ver todos los datos de la hoja de precios de los servicios de consumo de Azure en formato CSV:

Use Price Sheet API para ver todos los datos de la hoja de precios de los servicios de consumo de Azure en formato JSON:

Al usar la API, se devuelve la hoja de precios de toda la cuenta. Sin embargo, también puede obtener una versión resumida de la hoja de precios en formato PDF. El resumen incluye los servicios de consumo de Marketplace y de Azure que se facturan para una factura específica. La factura se identifica con el {invoiceId}, que es igual que el número de factura que se muestra en los archivos PDF de resumen de una factura. Este es un ejemplo.

Para ver la información de factura con Price Sheet API en formato CSV:

Para ver la información de factura con Price Sheet API en formato JSON:

También puede ver los precios estimados correspondientes a cualquier servicio de consumo de Marketplace o de Azure en el período de servicio o en el ciclo de facturación abierto actual.

Para ver los precios estimados de los servicios de consumo con Price Sheet API en formato CSV:

Para ver los precios estimados de los servicios de consumo con Price Sheet API en formato JSON:

Las Price Sheet API de contrato de cliente de Microsoft son API REST asincrónicas. Las respuestas para las API cambiaron desde las API sincrónicas anteriores. También se modificó el cuerpo de la respuesta de API.

Cuerpo de la respuesta anterior

Este es un ejemplo de la respuesta de API REST sincrónica:

[
        {
            "id": "enrollments/573549891/billingperiods/2016011/products/343/pricesheets",
            "billingPeriodId": "201704",
            "meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
            "meterName": "A1 VM",
            "unitOfMeasure": "100 Hours",
            "includedQuantity": 0,
            "partNumber": "N7H-00015",
            "unitPrice": 0.00,
            "currencyCode": "USD"
        },
        {
    ]

Cuerpo de la respuesta nuevo

Las API admiten el formato asincrónico de REST de Azure. Llame a la API mediante GET y recibirá la respuesta siguiente:

No Response Body

HTTP Status 202 Accepted

Estos encabezados se envían con la ubicación de la salida:

Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Azure-AsyncOperation:https://management.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Retry-After: 10

OData-EntityId: {operationId}

Realice otra llamada GET a la ubicación. La respuesta a la llamada GET es la misma hasta que la operación se completa o presenta un error. Cuando se completa, la respuesta a la ubicación de llamada GET devuelve la dirección URL de descarga como si la operación se ejecutara al mismo tiempo. Este es un ejemplo:

HTTP Status 200

{
  "id": "providers/Microsoft.Consumption/operationresults/{operationId}",
  "name": {operationId},
  "type": “Microsoft.Consumption/operationResults",
  "properties" : {
    "downloadUrl": {urltoblob},
    "validTill": "Date"
  }
}

El cliente también realiza una llamada GET para Azure-AsyncOperation. El punto de conexión devuelve el estado de la operación.

En la tabla siguiente se muestran los campos de la API Enterprise Get price sheet anterior. Incluye los campos correspondientes en la hoja de precios nueva para los contratos de cliente de Microsoft:

Operaciones de Consumption Price Sheet API

En el caso de los Contratos Enterprise, usaba las operaciones Get y Get By Billing Period de Consumption Price Sheet API para un ámbito por subscriptionId o un período de facturación. La API usa la autenticación de la administración de recursos de Azure.

Para obtener la información de la hoja de precios para un ámbito con Price Sheet API:

Para obtener la información de la hoja de precios por período de facturación con Price Sheet API:

En lugar de los anteriores puntos de conexión de la API, use los siguientes para los contratos de cliente de Microsoft:

Price Sheet API para contratos de cliente de Microsoft (API REST asincrónica)

Esta API es para los Contratos de cliente de Microsoft y proporciona atributos adicionales.

Hoja de precios para un ámbito de perfil de facturación en una cuenta de facturación

Esta API es la API existente. Se actualizó para proporcionar la hoja de precios para un perfil de facturación de una cuenta de facturación.

Hoja de precios para un ámbito por cuenta de facturación

La autenticación de Azure Resource Manager se usa cuando obtiene la hoja de precios en el ámbito de la inscripción en una cuenta de facturación.

Para obtener la hoja de precios en la cuenta de inscripción de una cuenta de facturación:

Para un contrato de cliente de Microsoft, use la información que aparece en la sección siguiente. Proporciona las propiedades de campo que se usan para los contratos de cliente de Microsoft.

Hoja de precios para un ámbito del perfil de facturación en una cuenta de facturación

La API Price Sheet by billing account actualizada obtiene la hoja de precios en formato CSV. Para obtener la hoja de precios en el ámbito del perfil de facturación para un MCA:

En el ámbito de la inscripción de EA, la respuesta de la API y las propiedades son idénticas. Las propiedades corresponden a las mismas propiedades del MCA.

Las propiedades anteriores para las Price Sheet API de Azure Resource Manager y las mismas propiedades nuevas están en la tabla siguiente.

El precio para los contratos de cliente de Microsoft se define de manera distinta a como se hace en los Contratos Enterprise. El precio de los servicios en la inscripción Enterprise es único para el producto, el número de pieza, el medidor y la oferta. El número de pieza no se usa en los contratos de cliente de Microsoft.

El precio del servicio de consumo de Azure que forma parte de un contrato de cliente de Microsoft es único para productOrderName y meterID. Representan el medidor del servicio y el plan del producto.

Para conciliar la hoja de precios y el uso en Usage Details API, puede usar productOrderName y meterID.

Los usuarios que tienen derechos de propietario del perfil de facturación, colaborador, lector y administrador de facturación pueden descargar la hoja de precios.

La hoja de precios incluye los precios de los servicios cuyos precios se basan en el uso. Los servicios incluyen el consumo de Marketplace y el de Azure. El último precio al final de cada período de servicio se bloquea y se aplica al uso en un período de servicio único. En el caso de los servicios de consumo de Azure, el período de servicio suele ser un mes natural.

Campos retirados de Price Sheet API

Los siguientes campos no están disponibles en las Price Sheet API de contrato de cliente de Microsoft o tienen los mismos campos.

Reservation Instance Charge API reemplazada

Puede obtener las transacciones de facturación de compras de reservas con Reserved Instance Charge API. La API nueva incluye todas las compras, incluidas ofertas de Marketplace de terceros. Todas las API de consumo se reemplazan por las API nativas de Azure que usan Microsoft Entra ID para la autenticación y autorización. Para más información sobre cómo llamar a las API REST de Azure, consulte la introducción a REST. Reserved Instance Charge API es reemplazada por Transactions API.

Para obtener las transacciones de compras de reservas con la API de Transacciones:

Las APIs de recomendaciones reemplazadas

Las Reserved Instance Purchase Recommendations API ofrecen el uso de una máquina virtual durante los últimos 7, 30 o 60 días. Las API también ofrecen recomendaciones de compras de reservas. Entre ellas, las siguientes:

• API de recomendación de instancia reservada compartida
• API de recomendaciones de instancia reservada única

Todas las API de consumo se reemplazan por las API nativas de Azure que usan Microsoft Entra ID para la autenticación y autorización. Para más información sobre cómo llamar a las API REST de Azure, consulte la introducción a REST. Las API de recomendaciones de reservas nombradas anteriormente se reemplazan por la API Microsoft.Consumption/reservationRecommendations.

Para obtener recomendaciones de reservas con Reservation Recommendations API:

APIs de Uso de Reservas reemplazadas

Puede obtener el uso de reservas de una inscripción con Reserved Instance Usage API. Si hay más de una instancia reservada en una suscripción, también puede obtener el uso de todas las instancias reservadas adquiridas con esta API.

Entre ellas, las siguientes:

• Detalles sobre el uso de instancias reservadas
• Resumen del uso de instancias reservadas

Todas las API de consumo se reemplazan por las API nativas de Azure que usan Microsoft Entra ID para la autenticación y autorización. Para más información sobre cómo llamar a las API REST de Azure, consulte la introducción a REST. Las API de recomendaciones de reservas nombradas anteriormente se reemplazan por la API Microsoft.Consumption/reservationDetails y la API Microsoft.Consumption/reservationSummaries.

Para obtener detalles de reservas con Reservation Details API:

Para obtener resúmenes de reservas con Reservation Summaries API:

Integración con Power BI

También puede usar Power BI para la generación de informes de costos. El conector de Cost Management para Power BI Desktop se puede usar para crear informes eficaces y personalizados que ayuden a comprender mejor su gasto con Azure. Actualmente, el conector de Cost Management admite clientes con un Contrato de Cliente de Microsoft o un Contrato Enterprise (EA).

Contenido relacionado

• Lea la documentación de Cost Management para información sobre cómo supervisar y controlar los gastos de Azure. O bien si quiere optimizar el uso de los recursos con Cost Management.