Compartir a través de


Consumo de Azure

Las API de consumo de Azure ofrecen acceso mediante programación a los datos de costos y uso de los recursos de Azure. Actualmente, las API solo admiten inscripciones empresariales, suscripciones de Web Direct (con algunas excepciones) y suscripciones de planes de Azure de CSP. Las API se actualizan continuamente para admitir otros tipos de suscripciones de Azure.

Las API de consumo de Azure ofrecen acceso a:

  • Solo clientes de Enterprise
    • Hoja de precios
    • Presupuestos
    • Previsiones
    • Saldos
    • Etiquetas
    • Etiquetas de costo
  • Clientes de Enterprise y Web Direct
    • Detalles de la reserva
    • Resúmenes de reservas
    • Cargos de Marketplace
    • Detalles de uso
    • Recomendaciones de reserva

Lista de tipos de suscripciones no admitidos

  • MS-AZR-0145P (CSP)
  • MS-AZR-0146P (CSP)
  • MS-AZR-159P (CSP)
  • MS-AZR-0036P (patrocinada)
  • MS-AZR-0143P (patrocinada)
  • MS-AZR-0015P (interna)
  • MS-AZR-0144P (DreamSpark)

Trabajar con períodos de facturación y intervalos de fechas

Los detalles de uso y los cargos de Marketplace aceptan intervalos de fechas o períodos de facturación para definir las fechas de inicio y finalización de los datos de uso.

Este es el comportamiento de la API en función de los períodos de facturación y los intervalos de fechas en la solicitud.

Período de facturación presente en la solicitud Fecha de inicio presente en la solicitud Fecha de finalización presente en la solicitud Comportamiento de las API
no no no Los datos del período de facturación actual se devuelven en respuesta.
no no Los datos del período de facturación actual se devuelven en respuesta.
no no Los datos del período de facturación actual se devuelven en respuesta.
no Los datos de la fecha de inicio y finalización especificados se devuelven en respuesta.
no no Los datos para el período de facturación especificado se devuelven en respuesta.
no Los datos para el período de facturación especificado se devuelven en respuesta.
no Los datos para el período de facturación especificado se devuelven en respuesta.
Los datos de la fecha de inicio y finalización especificados se devuelven en respuesta, se omite el período de facturación proporcionado.

El intervalo de fechas máximo permitido es de 12 meses en una solicitud y los datos están disponibles desde el 1 de mayo de 2014 o posterior.

Obtención de la lista de períodos de facturación

Para proporcionar un período de facturación válido en la solicitud, el cliente debe obtener primero una lista de los períodos de facturación disponibles por suscripción, mediante la SIGUIENTE API.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods?api-version=2017-04-24-preview

Con esta lista, el cliente puede elegir un período de facturación específico para obtener datos de consumo.

Datos de llegada tardía

Para dar cabida a los servicios de terceros, que tienen retrasos en el uso de informes, la fecha de uso notificada se establece en el momento en que se enviaron los datos de uso, en lugar de cuando se produjo el uso real, es decir, el tiempo de consumo.

Como resultado, el uso se clasificará y se aplicará a la hora notificada. Para representar el tiempo de consumo real, las propiedades. El campo AdditionalProperties ahora contendrá dos propiedades adicionales. ConsumptionBeginTime y ConsumptionEndTime son los nuevos campos que corresponden al período de tiempo de consumo real.

Estos cambios darán lugar a algunos escenarios que deberán abordarse al llamar a la API de detalles de uso:

  1. Informes de finalización del mes: para el uso que se produjo durante un mes, pero notificado durante el mes siguiente, los clientes tendrán que examinar el campo additionalProperties para asignar el uso al mes adecuado.

  2. Detalles de uso de consultas: al consultar la API de detalles de uso por un intervalo de fechas, la consulta solo se aplica a la fecha del informe de uso y no al tiempo de consumo en el campo additionalProperties . Para los clientes que buscan asignar los detalles de uso a las facturas, esta actualización no afecta al proceso, ya que la factura procesará el uso en función de la fecha del informe de uso. Para los clientes, buscando asignar detalles de uso a una fecha o mes de calendario específico, esta actualización es un cambio importante y, para estos escenarios, no se puede usar la fecha del informe de uso y la fecha en que se produjo el uso, en la sección additionalProperties debe usarse.

Llamada de ejemplo para obtener detalles adicionales:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-03-31&$expand=properties/additionalProperties

Fragmento de código de respuesta de ejemplo:

  "properties": {
    "billingPeriodId":"/subscriptions/{subscriptionid}/providers/Microsoft.Billing/billingPeriods/20180501",
    "usageStart":"2018-05-01T00:00:00.0000000Z",
    "usageEnd":"2018-05-01T23:59:59.0000000Z",
    "instanceId":"/subscriptions/{subscriptionid}/resourceGroups/{resourcegroup}/providers/Microsoft.Cdn/profiles/{profile}",
    "instanceName":"{id}",
    "instanceLocation":"SouthCentralUS",
    "meterId":"6b88ada0-cbc0-4874-be0e-23004f8b4de7",
    "usageQuantity":0.002065,
    "pretaxCost":0,
    "currency":"USD",
    "additionalProperties": {
      "Provider": "1",
      "ConsumptionBeginTime": "2018-05-01T19:00:00",
      "ConsumptionEndTime": "2018-05-01T20:00:00"
    }
  }

Consulte también

Para obtener más información sobre el uso de esta API en uno de los SDK específicos del lenguaje, visite lo siguiente:

Consumo de Azure con el SDK de Python

Consumo de Azure con la CLI

Consumo de Azure con el SDK de NodeJS

Consumo de Azure con el SDK de Ruby