Compartir vía

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 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.

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=2023-05-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=2023-05-01

Cambios en el cuerpo de respuesta

Respuesta anterior:

[
     {
        "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "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": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "skuName": "Standard_B1s",
        "reservedHours": 720,
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0
      }
    }
  ]
}

Contenido relacionado