Compartir vía

Migración desde la API de detalles de Uso de instancias reservadas 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 detalles 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 más información, consulte Asignación de permisos a las API de Cost Management.

Llamada a la API de detalles de Uso de instancias reservadas

Microsoft no va a actualizar las API de detalles de reserva basadas en sincrónicas anteriores. Es aconsejable que pase al patrón de llamada API asincrónica compatible con SPN más reciente como parte de la migración. Las solicitudes asincrónicas controlan mejor cantidades grandes de datos y reducen los errores de tiempo de espera.

Solicitudes admitidas

Use los siguientes identificadores URI de solicitud al llamar a la nueva API de detalles de reserva asincrónica. El número de inscripción debe usarse como billingAccountId. Puede llamar a la API con el siguiente ámbito:

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

Generación de informe por identificador de cuenta de facturación

Solicitud de ejemplo para generar un informe de detalles de reserva

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&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/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2023-11-01
Retry-After: 60

Código de estado 200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

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

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/reservationDetailsOperationResults/{operationId}?api-version=2023-11-01

Respuesta de sondeo de ejemplo

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Cambios en el cuerpo de respuesta

La siguiente información es un ejemplo de la respuesta de la anterior API de detalles de reserva basada la sincronización.

Respuesta anterior:

{
    "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/resourcegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

Nueva respuesta:

La nueva API crea automáticamente un archivo .csv. Vea los siguientes campos de archivo.

Propiedad antigua Propiedad nueva Notas
InstanceFlexibilityGroup La nueva propiedad de flexibilidad de tamaño de instancia.
InstanceFlexibilityGroup La nueva propiedad de flexibilidad de tamaño de instancia.
instanceId InstanceName
Kind Es una propiedad nueva. El valor es None, Reservation o IncludedQuantity.
reservationId ReservationId
reservationOrderId ReservationOrderId
reservedHours ReservedHours
skuName SkuName
totalReservedQuantity TotalReservedQuantity
usageDate UsageDate
usedHours UsedHours

Contenido relacionado