Migración desde las API de hoja de precios de EA
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.
Oharra
Todas las API de Azure Enterprise Reporting se retiran. Debe migrar a las API de Microsoft Cost Management lo antes posible.
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.
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:
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:
Código de estado: 202
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?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"
}
}
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01
[
{
"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"
},
...
]
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). |
- Lea el artículo de información general Migración de informes de EA a las API de ARM.