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 directas web (con algunas excepciones) y suscripciones al plan 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 para clientes empresariales
- Hoja de precios
- Presupuestos
- Previsiones
- Balances
- Etiquetas
- Etiquetas de costo
Clientes empresariales y web directos
- 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 e intervalos de fechas

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

Este es el comportamiento de la API basado en los períodos de facturación y los intervalos de fechas de 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	Sí	no	Los datos del período de facturación actual se devuelven en respuesta
no	no	Sí	Los datos del período de facturación actual se devuelven en respuesta
no	Sí	Sí	Los datos de la fecha de inicio y finalización especificada se devuelven en respuesta
Sí	no	no	Los datos del período de facturación especificado se devuelven en respuesta
Sí	Sí	no	Los datos del período de facturación especificado se devuelven en respuesta
Sí	no	Sí	Los datos del período de facturación especificado se devuelven en respuesta
Sí	Sí	Sí	Los datos de la fecha de inicio y finalización especificada se devuelven en respuesta, se ignora 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 a partir del 1 de mayo de 2014.

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 primero debe obtener una lista de los períodos de facturación disponibles por suscripción, utilizando 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 la notificación del uso, la fecha de uso notificada se establece en la hora en que se enviaron los datos de uso, en lugar de cuando tuvo lugar el uso real, es decir, el tiempo de consumo.

Como resultado, el uso se calificará y se aplicará al tiempo informado. 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 a la ventana 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:

Informes de fin de mes: para el uso que se produjo durante un mes, pero que se notificó durante el mes siguiente, los clientes deberán consultar el campo additionalProperties para asignar el uso al mes correspondiente.
Detalles de uso de la consulta: 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 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 que buscan asignar detalles de uso a una fecha o mes de calendario específicos, esta actualización es un cambio importante y, para estos escenarios, no se puede usar la fecha del informe de uso y se debe usar la fecha en que se produjo el uso, en la sección additionalProperties .

Ejemplo de llamada 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 respuesta de muestra:

  "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

SDK de Python de consumo de Azure

CLI de consumo de Azure

SDK de NodeJS de consumo de Azure

SDK de Ruby de consumo de Azure

Last updated on 2025-08-12

Compartir a través de