Share via

Migración desde la API de detalles de uso de consumo

  • Artículo

En este artículo se describe la migración fuera de la API de detalles de uso de consumo. La API de detalles de uso de consumo está en desuso. La fecha en que se desactivará la API todavía se está determinando. Le recomendamos que migre de la API lo antes posible.

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 cumple 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 muy 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 de cliente de Microsoft y con Contrato Enterprise que usan la API de exportaciones o de detalles de costos pueden 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.

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. A continuación, se muestra un registro de los detalles de uso heredado. Todos los clientes del contrato Enterprise tienen registros de este tipo debido al sistema de facturación subyacente que se usa para ellos.

{  

  "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. A continuación, se muestra un registro de los detalles de uso moderno. 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.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "modern",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

}

Se muestra un registro completo 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