Migración desde Reserved Instance Usage Summary API de EA

  • Artículo

Los clientes de EA que anteriormente usaban la API de consumo de informes para Enterprise de azure.com para obtener los resúmenes de uso de instancias reservadas deben migrar a la API de Azure Resource Manager de paridad. Las instrucciones se describen a continuación junto con las diferencias de contrato entre la API antigua y la nueva.

Nota:

El 1 de mayo de 2024, se retirarán las API de Azure Enterprise Reporting. Migre a las API de Microsoft Cost Management antes de esta fecha.

Asignación de permisos a un SPN para llamar a las 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 Asignación de permisos a las API de ACM.

Llamada a Reserved Instance Usage Summary API

Use los siguientes identificadores URI de solicitud para llamar a la nueva Reservation Summaries API.

Solicitudes admitidas

Llame a la API con los siguientes ámbitos:

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

Obtener resumen de reservas diariamente

https://management.azure.com/{scope}/Microsoft.Consumption/reservationSummaries?grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20&api-version=2019-10-01

Obtener resumen de reservas mensualmente

https://management.azure.com/{scope}/Microsoft.Consumption/reservationSummaries?grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20&api-version=2019-10-01

Cambios en el cuerpo de respuesta

Respuesta anterior:

[
     {
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "skuName": "Standard_F1s",
        "reservedHours": 24,
        "usageDate": "2018-05-01T00:00:00",
        "usedHours": 23,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 95.83,
        "maxUtilizationPercentage": 100
    }
]

Nueva respuesta:

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.Consumption/reservationSummaries/reservationSummaries_Id1",
      "name": "reservationSummaries_Id1",
      "type": "Microsoft.Consumption/reservationSummaries",
      "tags": null,
      "properties": {
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "skuName": "Standard_B1s",
        "reservedHours": 720,
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0
      }
    }
  ]
}

Pasos siguientes