Migración desde las API de detalles de uso de EA
Los clientes de EA que anteriormente usaban las API de Enterprise Reporting detrás del punto de conexión de consumption.azure.com para obtener los detalles de uso y los cargos de Marketplace deben migrar a soluciones nuevas y mejoradas. Las instrucciones se describen a continuación junto con las diferencias de contrato entre la API antigua y las nuevas soluciones.
El conjunto de datos se conoce como detalles de costos en lugar de detalles de uso.
Nota:
Todas las API de Azure Enterprise Reporting se retiran. Debe migrar a las API de Microsoft Cost Management lo antes posible.
Nuevas soluciones disponibles con carácter general
En la tabla que se muestra a continuación se proporciona un resumen de los destinos de migración que están disponibles junto con un resumen de lo que se debe tener en cuenta al elegir qué solución es mejor para usted.
| Solución | Descripción | Consideraciones | Información de incorporación |
|---|---|---|---|
| Exports | Volcados de datos periódicos en el almacenamiento según una programación | - La solución más escalable para sus cargas de trabajo. - Se puede configurar para usar la creación de particiones de archivos para conjuntos de datos más grandes. - Excelente para establecer y aumentar un conjunto de datos de costos que se puede integrar con sus propios almacenes de datos consultables. - Requiere acceso a una cuenta de almacenamiento que pueda contener los datos. |
- Configuración en Azure portal Automatización de la creación de exportación con la API - Referencia de la API de exportación |
| API de detalles del costo | Descarga a petición | - Útil para conjuntos de datos de costos pequeños. - Resulta útil para escenarios en los que las exportaciones a Azure Storage no son factibles debido a problemas de seguridad o administración. |
- Obtención de pequeños datos de costo por encargo - API de detalles del costo |
Por lo general, se recomienda usar Exportaciones si tiene necesidades de ingesta de datos en curso y/o un conjunto de datos de detalles de costos mensuales de gran tamaño. Para más información, consulte Ingesta de datos de detalles de costos. Si necesita información adicional para ayudarle a tomar una decisión para la carga de trabajo, consulte Elección de una solución de detalles de costos.
Asignación de permisos a un SPN para llamar a las API
Si desea llamar a las API de exportaciones o detalles de costos mediante programación, debe configurar una entidad de servicio con el permiso correcto. Para obtener más información, consulte Asignación de permisos a las API de ACM.
Evitar la API de detalles de uso del consumo de Microsoft
La API de detalles de uso de consumo es otro punto de conexión que actualmente admite clientes de EA. No migre a esta API. Migre a API de detalle de costos o de exportaciones, como se describió anteriormente en este documento. La API de detalles de uso de consumo quedará en desuso en el futuro y se encuentra detrás del punto de conexión siguiente.
GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01
Esta API es un punto de conexión sincrónico y no podrá escalar a medida que el gasto y el tamaño del conjunto de datos de costos mensual a lo largo del mes aumente. Si actualmente usa la API de detalles de uso de consumo, se recomienda migrar fuera de ella a la API de detalle de costos o de exportaciones lo antes posible. Un anuncio formal de desuso se realizará en una fecha futura. Para obtener más información sobre la migración fuera de los detalles de uso del consumo, consulte Migración desde la API de detalles de uso de consumo.
Ventajas de la migración
Nuestras nuevas soluciones proporcionan muchas ventajas sobre las API de detalles de uso de informes de EA. A continuación, se muestra un resumen:
- Seguridad y estabilidad: las nuevas soluciones requieren tokens de usuario y/o de entidad de servicio para acceder a los datos. Son más seguros que las claves de API que se usan para autenticarse en las API de informes de EA. Las claves de estas API heredadas son válidas durante seis meses y pueden exponer datos financieros confidenciales si se filtran. Además, si las claves no se renuevan e integran en cargas de trabajo antes de que se revoque el acceso a datos de expiración de seis meses. se interrumpirán las cargas de trabajo del cliente.
- Escalabilidad: las API de informes de EA no se compilan para escalar, así como aumenta el uso de Azure. El conjunto de datos de detalles de uso puede ser muy grande a medida que implementa más recursos en la nube. Las nuevas soluciones son asincrónicas y tienen amplias mejoras de infraestructura detrás de ellas para garantizar descargas correctas para conjuntos de datos de cualquier tamaño.
- Conjunto de datos único para todos los detalles de uso: los detalles de uso de Azure y Azure Marketplace se han combinado en un conjunto de datos en las nuevas soluciones. El conjunto de datos único reduce el número de API a las que necesita llamar para ver todos los cargos.
- Amortización de compras: los clientes que compran reservas pueden consultar una vista amortizada de sus costos mediante las nuevas soluciones.
- Coherencia del esquema: cada solución disponible proporciona archivos con campos coincidentes. Le permite moverse fácilmente entre soluciones en función de su situación.
- Integración de asignación de costos: los clientes con Contrato de cliente de Microsoft y con Contrato Enterprise pueden usar la nueva solución para ver los cargos en relación con las reglas de asignación de costos que han configurado. Para obtener más información sobre la asignación, consulte Asignación de costos.
- Mejoras en el futuro: las nuevas soluciones se están desarrollando activamente de cara al futuro. Las soluciones recibirán todas las características nuevas a medida que se publiquen.
API de uso de empresa para migrarlas
En la tabla siguiente se resumen las distintas API que puede usar hoy para ingerir datos de detalles de costos. Si usa una de las siguientes API, debe migrar a una de las nuevas soluciones descritas anteriormente. Todas las API están detrás del punto de conexión https://consumption.azure.com.
| Punto de conexión | Comentarios de API |
|---|---|
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} |
- Método API: GET - Sincrónico (sin sondear) - Formato de datos: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 |
- Método API: GET - Sincrónico (sin sondear) - Formato de datos: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails |
- Método API: GET - Sincrónico (sin sondear) - Formato de datos: JSON |
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails |
- Método API: GET - Sincrónico (sin sondear) - Formato de datos: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 |
- Método API: GET - Sincrónico (sin sondear) - Formato de datos: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} |
- Método API: POST - Asincrónico (basado en sondeo) - Formato de datos: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 |
- Método API: POST - Asincrónico (basado en sondeo) - Formato de datos: CSV |
Asignación de campos de datos
En la tabla que aparece a continuación se proporciona un resumen de los campos antiguos disponibles en las soluciones que usa actualmente junto con el campo que se va a usar en las nuevas soluciones.
| Campo antiguo | Nuevo campo | Comentarios |
|---|---|---|
| accountId | ||
| accountName | AccountName | |
| accountOwnerEmail | AccountOwnerId | |
| additionalInfo | AdditionalInfo | |
| chargesBilledSeparately | isAzureCreditEligible | Las propiedades son opuestas. Si isAzureCreditEnabled es true, ChargesBilledSeparately será false. |
| consumedQuantity | Cantidad | |
| consumedService | ConsumedService | |
| consumedServiceId | ConsumedService | consumedServiceId solo proporciona un valor numérico.ConsumedService proporciona el nombre del servicio. |
| cost | CostInBillingCurrency | |
| costCenter | CostCenter | |
| fecha | Date | El formato en el campo anterior era aaaa-mm-dd, mientras que el nuevo campo tiene el formato mm/dd/aaaa. |
| departmentId | InvoiceSectionId | |
| departmentName | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | ResourceId | |
| isRecurringCharge | Cuando proceda, use Frequency y Term fields de ahora en adelante. |
|
| ubicación | ResourceLocationNormalized | |
| meterCategory | MeterCategory | |
| meterId | Id. del medidor | |
| meterName | MeterName | |
| meterRegion | MeterRegion | |
| meterSubCategory | MeterSubCategory | |
| offerId | OfferId | |
| orderNumber | No disponible. | |
| partNumber | PartNumber | |
| planName | PlanName | |
| producto | ProductName | |
| publisherName | PublisherName | |
| resourceGroup | ResourceGroup | |
| resourceGuid | Id. del medidor | Los valores varían. resourceGuid es un valor GUID. meterId es un número largo. |
| resourceLocation | ResourceLocation | |
| resourceLocationId | No disponible. | |
| resourceRate | EffectivePrice | |
| serviceInfo1 | ServiceInfo1 | |
| serviceInfo2 | ServiceInfo2 | |
| serviceName | MeterCategory | |
| serviceTier | MeterSubCategory | |
| storeServiceIdentifier | No disponible. | |
| subscriptionGuid | SubscriptionId | |
| subscriptionId | SubscriptionId | |
| subscriptionName | SubscriptionName | |
| etiquetas | Etiquetas | El nuevo campo no tiene la inclusión {} alrededor de los pares clave-valor. |
| unitOfMeasure | UnitOfMeasure |
Contenido relacionado
- Consulte el artículo general Migración de los informes de EA a las API de Azure Resource Manager.