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.
Integración y API 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.
- Acceder a una API combinada con el uso del servicio de Azure, el uso de Marketplace de terceros y las compras de Marketplace.
- Ver los costos de perfiles de facturación (lo mismo que las inscripciones) con 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 de 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.
Nota:
Todas las API de Azure Enterprise Reporting se retiran. Debe migrar a las API de Microsoft Cost Management lo antes posible.
| Fin | API de EA | API de MCA |
|---|---|---|
| Saldo y créditos | /balancesummary | Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae |
| Uso (JSON) | /usagedetails /usagedetailsbycustomdate |
Elección de una solución de detalles sobre los costos |
| Uso (CSV) | /usagedetails/download /usagedetails/submit |
Elección de una solución de detalles sobre los costos |
| Uso de Marketplace (CSV) | /marketplacecharges /marketplacechargesbycustomdate |
Elección de una solución de detalles sobre los costos |
| Períodos de facturación | /billingperiods | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Hoja de precios | /pricesheet | Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json o csv Microsoft.Billing/billingAccounts/…/billingProfiles/…/invoices/… /pricesheet/default/download format=json o csv Microsoft.Billing/billingAccounts/../billingProfiles/../providers/Microsoft.Consumption/pricesheets/download |
| Compras de la reserva | /reservationcharges | Microsoft.Billing/billingAccounts/billingProfiles/transactions |
| Recomendaciones de reserva | /SharedReservationRecommendations /SingleReservationRecommendations |
Microsoft.Consumption/reservationRecommendations |
| Uso de las reservas | /reservationdetails /reservationsummaries |
Microsoft.Consumption/reservationDetails Microsoft.Consumption/reservationSummaries |
¹ El uso de Marketplace de terceros y el servicio de Azure están disponibles con la API de detalles de utilización.
Las API siguientes están compatibles para las cuentas de facturación de MCA:
| Propósito | API de contrato de cliente de Microsoft (MCA) |
|---|---|
| Cuentas de facturación² | Microsoft.Billing/billingAccounts |
| Perfiles de facturación² | Microsoft.Billing/billingAccounts/billingProfiles |
| Secciones de la factura² | Microsoft.Billing/billingAccounts/invoiceSections |
| Facturas | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Suscripciones de facturación | {ámbito}/billingSubscriptions |
² 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:
| Propósito | Oferta anterior | Nueva oferta |
|---|---|---|
| Power BI | Conector y paquete de contenido de Microsoft Consumption Insights | Conector de Azure Consumption Insights |
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:
| Método | URI de solicitud |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview |
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 API independientes para el uso de Marketplace de terceros y los servicios de Azure. 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 Cost Details 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.
| Tipo | Formato de identificador |
|---|---|
| Cuenta de facturación | /Microsoft.Billing/billingAccounts/{billingAccountId} |
| Perfil de facturación | /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} |
| Subscription | /subscriptions/{subscriptionId} |
| Resource group | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName} |
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.
| Propiedad antigua | Propiedad nueva | Notas |
|---|---|---|
| AccountId | N/D | No se hace un seguimiento del creador de la suscripción. Use invoiceSectionId (igual que departmentId). |
| AccountNameAccountOwnerId y AccountOwnerEmail | N/D | No se hace un seguimiento del creador de la suscripción. Use invoiceSectionName (igual que departmentName). |
| AdditionalInfo | additionalInfo | |
| ChargesBilledSeparately | isAzureCreditEligible | Las propiedades son opuestas. Si isAzureCreditEnabled es true, ChargesBilledSeparately será false. |
| ConsumedQuantity | quantity | |
| ConsumedService | consumedService | Los valores de cadena exactos pueden diferir. |
| ConsumedServiceId | None | |
| CostCenter | costCenter | |
| Date y usageStartDate | date | |
| Día | None | Analiza el día de la fecha. |
| DepartmentId | invoiceSectionId | Los valores exactos difieren. |
| DepartmentName | invoiceSectionName | Los valores de cadena exactos pueden diferir. Si es necesario, configure las secciones de factura para que coincidan con los departamentos. |
| ExtendedCost y Cost | costInBillingCurrency | |
| InstanceId | resourceId | |
| Is Recurring Charge | Ninguno | |
| Ubicación | ubicación | |
| MeterCategory | meterCategory | Los valores de cadena exactos pueden diferir. |
| MeterId | meterId | Los valores de cadena exactos difieren. |
| MeterName | meterName | Los valores de cadena exactos pueden diferir. |
| MeterRegion | meterRegion | Los valores de cadena exactos pueden diferir. |
| MeterSubCategory | meterSubCategory | Los valores de cadena exactos pueden diferir. |
| Mes | None | Analiza el mes de la fecha. |
| Nombre de la oferta | None | Use publisherName y productOrderName. |
| OfferID | None | |
| Order Number | None | |
| PartNumber | None | Use meterId y productOrderName para identificar los precios de manera única. |
| Plan Name | productOrderName | |
| Producto | Producto | |
| ProductId | productId | Los valores de cadena exactos difieren. |
| Nombre de publicador | publisherName | |
| ResourceGroup | resourceGroupName | |
| ResourceGuid | meterId | Los valores de cadena exactos difieren. |
| ResourceLocation | resourceLocation | |
| ResourceLocationId | None | |
| nombreDelRecurso | None | |
| ResourceRate | effectivePrice | |
| ServiceAdministratorId | N/D | |
| ServiceInfo1 | serviceInfo1 | |
| ServiceInfo2 | serviceInfo2 | |
| ServiceName | meterCategory | Los valores de cadena exactos pueden diferir. |
| ServiceTier | meterSubCategory | Los valores de cadena exactos pueden diferir. |
| StoreServiceIdentifier | N/D | |
| SubscriptionGuid | subscriptionId | |
| SubscriptionId | subscriptionId | |
| SubscriptionName | subscriptionName | |
| Etiquetas | etiquetas | La propiedad tags se aplica a un objeto raíz y no a la propiedad de propiedades anidadas. |
| UnitOfMeasure | unitOfMeasure | Los valores de cadena exactos difieren. |
| usageEndDate | date | |
| Year | None | Analiza el año de la fecha. |
| (nueva) | billingCurrency | La moneda que se usa para el cargo. |
| (nueva) | billingProfileId | El identificador único del perfil de facturación (igual que la inscripción). |
| (nueva) | billingProfileName | El nombre del perfil de facturación (igual que la inscripción). |
| (nueva) | chargeType | Úsela para diferenciar el uso del servicio de Azure, el uso de Marketplace y las compras. |
| (nueva) | invoiceId | El identificador único de la factura. Propiedad vacía para el mes abierto actual. |
| (nueva) | publisherType | El tipo de anunciante para las compras. Propiedad vacía para el uso. |
| (nueva) | serviceFamily | El tipo de compra. Propiedad vacía para el uso. |
| (nueva) | servicePeriodEndDate | La fecha de finalización del servicio comprado. |
| (nueva) | servicePeriodStartDate | La fecha de inicio del servicio comprado. |
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:
| Método | URI de solicitud |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview |
Price Sheet API
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.
API Billing Enterprise
Usaba las API 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:
| Método | URI de solicitud |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet |
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet |
Price Sheet API para los contratos de cliente de Microsoft
Use Price Sheet API para los contratos de cliente de Microsoft para ver los precios de todos los servicios de consumo de Marketplace y de consumo de Azure. 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:
| Método | URI de solicitud |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=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:
| Método | URI de solicitud |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=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:
| Método | URI de solicitud |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Para ver la información de factura con Price Sheet API en formato JSON:
| Método | URI de solicitud |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=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:
| Método | URI de solicitud |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Para ver los precios estimados de los servicios de consumo con Price Sheet API en formato JSON:
| Método | URI de solicitud |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=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://managment.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:
| Propiedad antigua | Propiedad nueva | Notas |
|---|---|---|
| billingPeriodId | No aplicable | No es aplicable. En el caso de los contratos de cliente de Microsoft, la factura y la hoja de precios asociada reemplazaron el concepto de billingPeriodId. |
| meterId | meterId | |
| unitOfMeasure | unitOfMeasure | Los valores de cadena exactos pueden diferir. |
| includedQuantity | includedQuantity | No es aplicable para los servicios en los contratos de cliente de Microsoft. |
| partNumber | No aplicable | En su lugar, use una combinación de productOrderName (igual que offerID) y meterID. |
| unitPrice | unitPrice | El precio unitario se aplica a los servicios consumidos en los contratos de cliente de Microsoft. |
| currencyCode | pricingCurrency | Los contratos de cliente de Microsoft representan los precios en la moneda de precios y la moneda de facturación. currencyCode corresponde a pricingCurrency en los contratos de cliente de Microsoft. |
| offerID | productOrderName | En lugar de OfferID, puede usar productOrderName, pero no es lo mismo que OfferID. Sin embargo, productOrderName y meter determinan los precios en los contratos de cliente de Microsoft relacionados con meterId y OfferID en las inscripciones heredadas. |
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:
| Método | URI de solicitud |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Para obtener la información de la hoja de precios por período de facturación con Price Sheet API:
| Método | URI de solicitud |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
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:
| Método | URI de solicitud |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
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:
| Método | URI de solicitud |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
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.
| Anterior propiedad de Price Sheet API de Azure Resource Manager | Nueva propiedad de Price Sheet API de contrato de cliente de Microsoft | Description |
|---|---|---|
| Meter ID | meterId | Identificador único del medidor. Igual que meterID. |
| Nombre del medidor | meterName | Nombre del medidor. El medidor representa el recurso de un servicio de Azure que se puede implementar. |
| Meter category | service | El nombre de la categoría de clasificación del medidor. Igual que el servicio en la hoja de precios de contrato de cliente de Microsoft. Los valores de cadena exactos difieren. |
| Subcategoría del medidor | meterSubCategory | El nombre de la categoría de subclasificación del medidor. Basado en la clasificación de la diferenciación del conjunto de características de alto nivel del servicio. Por ejemplo, base de datos SQL básica frente a base de datos SQL estándar. |
| Región del medidor | meterRegion | |
| Unidad | No aplicable | Se puede analizar a partir de unitOfMeasure. |
| Unidad de medida | unitOfMeasure | |
| Número de pieza | No aplicable | En lugar del número de pieza, use productOrderName y MeterID para identificar de manera única el precio para un perfil de facturación. Los campos se enumeran en la factura de MCA en lugar del número de pieza en las facturas de MCA. |
| Precio unitario | unitPrice | El precio unitario en los contratos de cliente de Microsoft. |
| Código de moneda | pricingCurrency | Los contratos de cliente de Microsoft representan los precios en la moneda de precios y la moneda de facturación. El código de divisa es igual que pricingCurrency en los contratos de cliente de Microsoft. |
| Cantidad incluida | includedQuantity | No es aplicable a los servicios en los contratos de cliente de Microsoft. Se muestra con valores de cero. |
| Id. de oferta | productOrderName | En lugar de OfferID, use productOrderName. No es lo mismo que OfferID, pero productOrderName y meter determinan los precios de los contratos de cliente de Microsoft. Relacionado con meterId y OfferiD en las inscripciones heredadas. |
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.
| Campo retirados | Description |
|---|---|
| billingPeriodId | No aplicable. Corresponde a InvoiceId para MCA. |
| offerID | No es aplicable. Corresponde a productOrderName en MCA. |
| meterCategory | No es aplicable. Corresponde a Service en MCA. |
| unit | No es aplicable. Se puede analizar a partir de unitOfMeasure. |
| currencyCode | Igual que pricingCurrency en MCA. |
| meterLocation | Igual que meterRegion en MCA. |
| partNumber | No se aplica, porque el número de pieza no aparece en las facturas de MCA. En lugar del número de pieza, use la combinación de meterId y productOrderName para identificar los precios de manera única. |
| totalIncludedQuantity | No es aplicable. |
| pretaxStandardRate | No es aplicable. |
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 Transactions API:
| Método | URI de solicitud |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview |
Recommendations API 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:
- Shared Reserved Instance Recommendation API
- Single Reserved Instance Recommendations API
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:
| Método | URI de solicitud |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01 |
Reservation Usage API 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 inscripción, también puede obtener el uso de todas las compras de instancias reservadas con esta API.
Entre ellas, las siguientes:
- Detalles de uso de instancias reservadas
- Resumen de 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:
| Método | URI de solicitud |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01 |
Para obtener resúmenes de reservas con Reservation Summaries API:
| Método | URI de solicitud |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01 |
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. En la actualidad, 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.