Compartir a través de

Migración desde las API de hoja de precios de EA

  • Artículo

Los clientes de EA que anteriormente usaban la Api de consumption.azure.com de Enterprise Reporting para obtener su hoja de precios deben migrar a una API de Azure Resource Manager de reemplazo. Las instrucciones siguientes le ayudarán a migrar y describir las diferencias de contrato entre la API antigua y la nueva API.

Nota:

Todas las API de Azure Enterprise Reporting se retiran. Debe migrar a las API de Microsoft Cost Management lo antes posible.

Asignación de permisos a una entidad de servicio para llamar a la API

Antes de llamar a la API, debe configurar una entidad de servicio (SPN) con el permiso correcto. Use la entidad de servicio para llamar a la API. Para más información, consulte Asignación de permisos a las API de Cost Management.

API de llamada a la hoja de precios

Price Sheet API genera la hoja de precios de forma asincrónica y genera un archivo que descargue.

Cuando llame a la nueva Price Sheet API use los siguientes identificadores URI de solicitud:

Solicitudes admitidas

Puede llamar a la API con el siguiente ámbito:

Inscripción: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Descargar por cuenta de facturación para el período de facturación especificado

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

La solicitud POST devuelve una ubicación para sondear el estado de generación de informes como se describe en la siguiente respuesta:

Respuesta de muestra

Código de estado: 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01
Retry-After: 60

Código de estado: 200

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

Solicitud de ejemplo para sondear el estado de generación de informes

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01

Cambios en el cuerpo de respuesta

[
        {
              "id": "enrollments/57354989/billingperiods/201601/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"
        },
        {
              "id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
              "billingPeriodId": "201404",
            "meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
              "meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
              "unitOfMeasure": "100 GB",
              "includedQuantity": 0,
              "partNumber": "N9H-00402",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        ...
]

Cambios de respuesta

Las propiedades de la hoja de precios son las siguientes:

Nombre Tipo Descripción
basePrice string El precio unitario en el momento en que el cliente inicia sesión o el precio unitario en el momento del lanzamiento de disponibilidad general del medidor de servicio si es después del inicio de sesión.

Se aplica a los usuarios del Contrato Enterprise
currencyCode string Moneda en la que se firmó el Contrato Enterprise
effectiveEndDate string Fecha de finalización efectiva del período de facturación de la hoja de precios
effectiveStartDate string Fecha de inicio efectiva del período de facturación de la hoja de precios
enrollmentNumber string Identificador único de la cuenta de facturación.
includedQuantity string Cantidades de un servicio específico que un cliente tiene derecho a consumir sin cargos incrementales.
marketPrice string Precio de lista actual de un producto o servicio determinado. Este precio no está negociando y se basa en el tipo de contrato de Microsoft.

Para el consumo de PriceType, el precio del mercado se refleja como el precio de pago por uso.

Para PriceType Savings Plan, el precio del mercado refleja el beneficio del plan de ahorros sobre el precio de pago por uso para el período de compromiso correspondiente.

Para PriceType ReservedInstance, el precio del mercado refleja el precio total del compromiso uno o tres años.

Nota: Para los clientes de EA sin negociaciones, el precio del mercado puede aparecer redondeado a una precisión decimal diferente que el precio unitario.
meterCategory string El nombre de la categoría de clasificación del medidor. Por ejemplo, servicios en la nube o redes.
meterId string Identificador único del evento
meterName string Nombre del medidor. El medidor representa el recurso de un servicio de Azure que se pueden implementar.
meterRegion string Nombre de la región de Azure donde está disponible el medidor para el servicio.
meterSubCategory string El nombre de la categoría de subclasificación del medidor.
meterType string Nombre del tipo de medidor
partNumber string El número de pieza asociado al medidor
priceType string Tipo de precio para un producto. Por ejemplo, un recurso Azure con una tarifa de pago por uso con priceType como Consumo. Otros tipos de precios incluyen ReservedInstance y Plan de ahorro.
producto string Nombre del producto que acumula los cargos.
productId string Identificador único del producto cuyo medidor se consume.
serviceFamily number Tipo de servicio de Azure. Por ejemplo, proceso, análisis y seguridad.
skuId string Identificador único de la SKU
Término de string Duración del período para el plan de ahorro de Azure o el período de reserva: un año o tres años (P1Y o P3Y)
unitOfMeasure string Cómo se mide el uso para el servicio
unitPrice string El precio por unidad en el momento de la facturación de un producto o servicio determinado, incluido cualquier descuento negociado sobre el precio del mercado.

Para PriceType ReservedInstance, el precio unitario refleja el costo total del compromiso de uno o tres años, incluidos los descuentos.

Nota: el precio unitario no es lo mismo que el precio efectivo en las descargas de detalles de uso cuando los servicios tienen precios diferentes entre niveles.

Si los servicios tienen precios de varios niveles, el precio efectivo es una tarifa mixta en todos los niveles y no muestra un precio unitario específico por nivel. El precio combinado o precio efectivo es el precio neto de la cantidad consumida que se extiende a lo largo de los distintos niveles (donde cada nivel tiene un precio unitario específico).

Contenido relacionado