Migración desde la API de detalles de uso de consumo
En este artículo se describe la migración fuera de la API de detalles de uso de consumo, que está previsto que quede en desuso. La fecha exacta de desuso aún está por determinar. Se recomienda no compilar las canalizaciones de informes mediante esta API y migrarlas lo antes posible.
Se retiran las API de informes del Contrato Enterprise (EA), que usan una clave de API para la autenticación y a las que se accede a través del punto de conexión de URI de consumption.azure.com. Los clientes del EA que usan estas API deben migrar a la API de Detalles de costos de Cost Management. Estas API de informes del EA anteriores solo están disponibles para los clientes con un Contrato Enterprise.
Si usa la API de detalles de uso de consumo, se recomienda, pero no es necesario, migrar a la API de detalles de costos de Cost Management.
Las API de Consumo y Cost Management están disponibles para los clientes con EA y con Contrato de cliente de Microsoft (MCA). Por lo tanto, los clientes de Azure Government que permanecen bajo un Contrato Enterprise no se ven afectados negativamente.
Al migrar de EA a MCA, le recomendamos que pase de la API de detalles de uso de informes de EA a la API de detalles de costos de Cost Management y que use Exportaciones.
Destinos de migración
Lea el artículo Elegir una solución de detalles de costos antes de elegir la solución adecuada para la carga de trabajo. 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 Detalles de uso de ingesta de datos.
Si tiene un conjunto de datos de detalles de uso más pequeño o un escenario que no se cumple con las Exportaciones, considere la posibilidad de usar el informe Detalles del costo. Para más información, consulte Obtención de conjuntos de datos de costos pequeños a petición.
Nota
El informe Detalles de costos solo está disponible para los clientes con un Contrato Enterprise o Contrato de cliente de Microsoft. Si tiene una suscripción de MSDN, pago por uso o Visual Studio, puede migrar a Exportaciones o seguir usando la API de detalles de uso de consumo.
Ventajas de la migración
Las nuevas soluciones proporcionan muchas ventajas sobre la API de detalles de uso de consumo. A continuación, se muestra un resumen:
- 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. Esto reduce el número de API a las que necesita llamar para ver todos sus cargos.
- Escalabilidad: la API de Marketplaces está en desuso porque promueve un patrón de llamada que no puede escalar a medida que aumenta el uso de Azure. El conjunto de datos de detalles de uso puede ser grande a medida que implementa más recursos en la nube. La API de Marketplaces es una API sincrónica paginada, por lo que no está optimizada para transferir eficazmente grandes volúmenes de datos a través de una red con alta eficiencia y fiabilidad. Las exportaciones y la API Detalles de costos son asincrónicos. Proporcionan un archivo CSV que se puede descargar directamente a través de la red.
- Mejoras en la API: las exportaciones y la API de detalles de costos son las soluciones que Azure admite de aquí en adelante. Todas las nuevas características se están integrando en ellas.
- Coherencia del esquema: el informe de detalles de costos y exportaciones proporciona archivos con campos coincidentes que puede mover de una solución a la otra, en función de su escenario.
- Integración de asignación de costos: los clientes con Contrato Enterprise y Contrato de cliente de Microsoft que usan Exportaciones o la API de detalles de costos pueden ver los cargos en relación con las reglas de asignación de costos configuradas. Para obtener más información sobre la asignación, consulte Asignación de costos.
Diferencias de campo
En la tabla siguiente se resumen las diferencias de campo entre la API de detalles de uso de consumo y la API de detalles de costos y exportaciones. Las APO de exportaciones y de detalles de costos proporcionan una descarga de archivos CSV en lugar de la respuesta JSON paginada proporcionada por la API de consumo.
Asignación de campos del Contrato Enterprise
Los clientes del contrato Enterprise que usan la API de detalles de uso de consumo tienen registros de detalles de uso del tipo legacy. Todos los clientes del contrato Enterprise tienen registros de este tipo debido al sistema de facturación subyacente que se usa para ellos. Este es un ejemplo de registro de detalles de uso heredado:
{
"value": [
{
"id": "{id}",
"name": "{name}",
"type": "Microsoft.Consumption/usageDetails",
"kind": "legacy",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
…...
}
}
Se muestra un registro de detalles de uso heredado de ejemplo en Detalles de uso: lista: API REST (consumo de Azure)
En la tabla siguiente se proporciona una asignación entre los campos antiguos y nuevos. Las nuevas propiedades están disponibles en los archivos CSV generados por la API Exportaciones y Detalles de costos. Para más información sobre los campos, consulteDescripción de los campos de detalles de uso.
Los nombres de las propiedades en negrita no se modifican.
| Propiedad anterior | Propiedad nueva |
|---|---|
| accountName | AccountName |
| AccountOwnerId | AccountOwnerId |
| additionalInfo | AdditionalInfo |
| AvailabilityZone | AvailabilityZone |
| billingAccountId | BillingAccountId |
| billingAccountName | BillingAccountName |
| billingCurrency | BillingCurrencyCode |
| billingPeriodEndDate | BillingPeriodEndDate |
| billingPeriodStartDate | BillingPeriodStartDate |
| billingProfileId | BillingProfileId |
| billingProfileName | BillingProfileName |
| chargeType | ChargeType |
| consumedService | ConsumedService |
| cost | CostInBillingCurrency |
| costCenter | CostCenter |
| fecha | Fecha |
| effectivePrice | EffectivePrice |
| frequency | Frecuencia |
| invoiceSection | InvoiceSectionName |
| InvoiceSectionId | InvoiceSectionId |
| isAzureCreditEligible | IsAzureCreditEligible |
| meterCategory | MeterCategory |
| meterId | Id. del medidor |
| meterName | MeterName |
| MeterRegion | MeterRegion |
| meterSubCategory | MeterSubCategory |
| offerId | OfferId |
| partNumber | PartNumber |
| PayGPrice | PayGPrice |
| PlanName | PlanName |
| PricingModel | PricingModel |
| product | ProductName |
| ProductOrderId | ProductOrderId |
| ProductOrderName | ProductOrderName |
| PublisherName | PublisherName |
| PublisherType | PublisherType |
| quantity | Quantity |
| ReservationId | ReservationId |
| ReservationName | ReservationName |
| resourceGroup | ResourceGroup |
| resourceId | ResourceId |
| resourceLocation | ResourceLocation |
| resourceName | nombreDelRecurso |
| serviceFamily | ServiceFamily |
| ServiceInfo1 | ServiceInfo1 |
| ServiceInfo2 | ServiceInfo2 |
| subscriptionId | SubscriptionId |
| subscriptionName | SubscriptionName |
| Etiquetas | Etiquetas |
| Término | Término |
| unitOfMeasure | UnitOfMeasure |
| unitPrice | UnitPrice |
| CostAllocationRuleName | CostAllocationRuleName |
Asignación de campos del Contrato de cliente de Microsoft
Los clientes del Contrato de cliente de Microsoft que usan la API de detalles de uso de consumo tienen registros de detalles de uso del tipo modern. Todos los clientes del Contrato de cliente de Microsoft tienen registros de este tipo debido al sistema de facturación subyacente que se usa para ellos. Este es un ejemplo de registro de detalles de uso de MCA:
{
"value": [
{
"id": "{id}",
"name": "{name}",
"type": "Microsoft.Consumption/usageDetails",
"kind": "modern",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
…...
}
}
Se muestra un registro de detalles de uso heredado de ejemplo en Detalles de uso: lista: API REST (consumo de Azure)
En la tabla siguiente se proporciona una asignación entre los campos antiguos y nuevos. Las nuevas propiedades están disponibles en los archivos CSV generados por la API Exportaciones y Detalles de costos. Los campos que necesitan una asignación debido a las diferencias entre las soluciones se muestran en negrita.
Para obtener más información, consulte Descripción de los campos de detalles de uso.
| Propiedad antigua | Propiedad nueva |
|---|---|
| invoiceId | invoiceId |
| previousInvoiceId | previousInvoiceId |
| billingAccountId | billingAccountId |
| billingAccountName | billingAccountName |
| billingProfileId | billingProfileId |
| billingProfileName | billingProfileName |
| invoiceSectionId | invoiceSectionId |
| invoiceSectionName | invoiceSectionName |
| partnerTenantId | partnerTenantId |
| partnerName | partnerName |
| resellerName | resellerName |
| resellerMpnId | resellerMpnId |
| customerTenantId | customerTenantId |
| customerName | customerName |
| costCenter | costCenter |
| billingPeriodEndDate | billingPeriodEndDate |
| billingPeriodStartDate | billingPeriodStartDate |
| servicePeriodEndDate | servicePeriodEndDate |
| servicePeriodStartDate | servicePeriodStartDate |
| date | date |
| serviceFamily | serviceFamily |
| productOrderId | productOrderId |
| productOrderName | productOrderName |
| consumedService | consumedService |
| meterId | meterId |
| meterName | meterName |
| meterCategory | meterCategory |
| meterSubCategory | meterSubCategory |
| meterRegion | meterRegion |
| productIdentifier | ProductId |
| product | ProductName |
| subscriptionGuid | SubscriptionId |
| subscriptionName | subscriptionName |
| publisherType | publisherType |
| publisherId | publisherId |
| publisherName | publisherName |
| resourceGroup | resourceGroupName |
| NOMBREINSTANCIA | ResourceId |
| resourceLocationNormalized | ubicación |
| resourceLocation | ubicación |
| effectivePrice | effectivePrice |
| quantity | quantity |
| unitOfMeasure | unitOfMeasure |
| chargeType | chargeType |
| billingCurrencyCode | billingCurrency |
| pricingCurrencyCode | pricingCurrency |
| costInBillingCurrency | costInBillingCurrency |
| costinPricingCurrency | costinPricingCurrency |
| costinUSD | costinUSD |
| paygCostInBillingCurrency | paygCostInBillingCurrency |
| paygCostInUSD | paygCostInUsd |
| exchangeRatePricingToBilling | exchangeRatePricingToBilling |
| exchangeRateDate | exchangeRateDate |
| isAzureCreditEligible | isAzureCreditEligible |
| serviceInfo1 | serviceInfo1 |
| serviceInfo2 | serviceInfo2 |
| additionalInfo | additionalInfo |
| etiquetas | etiquetas |
| partnerEarnedCreditRate | partnerEarnedCreditRate |
| partnerEarnedCreditApplied | partnerEarnedCreditApplied |
| marketPrice | PayGPrice |
| frequency | frequency |
| término | término |
| reservationId | reservationId |
| reservationName | reservationName |
| pricingModel | pricingModel |
| unitPrice | unitPrice |
| exchangeRatePricingToBilling | exchangeRatePricingToBilling |
Contenido relacionado
- Obtenga más información sobre la automatización de Cost Management y Billing en Información general sobre la automatización de Cost Management.