Compartir vía

Migración desde la Balance Summary API de EA

  • Artículo

Los clientes de EA que anteriormente usaban la API de consumption.azure.com de Enterprise Reporting para obtener su resumen del saldo deben migrar a una API de Azure Resource Manager de reemplazo. Las instrucciones siguientes le ayudarán a migrar y analizar 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 con el permiso correcto. Use la entidad de servicio para llamar a la API. Para obtener más información, consulte Asignar permisos a las API de Cost Management.

Llame a la Balance Summary API de EA

Use los siguientes URI de solicitud al llamar a la nueva Balance Summary API. Su número de inscripción debe usarse como billingAccountId.

Solicitudes admitidas

Obtención para la inscripción

https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/balances?api-version=2023-05-01

Cambios en el cuerpo de respuesta

Cuerpo de respuesta anterior:

{
  "id": "enrollments/100/billingperiods/201507/balancesummaries",
  "billingPeriodId": 201507,
  "currencyCode": "USD",
  "beginningBalance": 0,
  "endingBalance": 1.1,
  "newPurchases": 1,
  "adjustments": 1.1,
  "utilized": 1.1,
  "serviceOverage": 1,
  "chargesBilledSeparately": 1,
  "totalOverage": 1,
  "totalUsage": 1.1,
  "azureMarketplaceServiceCharges": 1,
  "newPurchasesDetails": [
    {
      "name": "",
      "value": 1
    }
  ],
  "adjustmentDetails": [
    {
      "name": "Promo Credit",
      "value": 1.1
    },
    {
      "name": "SIE Credit",
      "value": 1
    }
  ]
}

Cuerpo de la respuesta nuevo:

Los mismos datos ahora están disponibles en el campo properties de la nueva respuesta de la API. Puede haber cambios secundarios en la ortografía de algunos de los nombres de campo.

{
  "id": "/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/balances/balanceId1",
  "name": "balanceId1",
  "type": "Microsoft.Consumption/balances",
  "properties": {
    "currency": "USD  ",
    "beginningBalance": 3396469.19,
    "endingBalance": 2922371.02,
    "newPurchases": 0,
    "adjustments": 0,
    "utilized": 474098.17,
    "serviceOverage": 0,
    "chargesBilledSeparately": 0,
    "totalOverage": 0,
    "totalUsage": 474098.17,
    "azureMarketplaceServiceCharges": 609.82,
    "billingFrequency": "Month",
    "priceHidden": false,
    "overageRefund": 2012.61,
    "newPurchasesDetails": [
      {
        "name": "Promo Purchase",
        "value": 1
      }
    ],
    "adjustmentDetails": [
      {
        "name": "Promo Credit",
        "value": 1.1
      },
      {
        "name": "SIE Credit",
        "value": 1
      }
    ]
  }
}

Contenido relacionado