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, estas API solo admiten Enterprise y suscripciones de Web Direct (con algunas excepciones). 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 suscripción 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)

Grupos de operaciones REST

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 en función de los períodos de facturación y los intervalos de fechas de la solicitud.

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 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 períodos de facturación disponibles por suscripción, mediante la API siguiente

   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 servicios de terceros que tienen retrasos en el uso de informes, la fecha de uso notificada se establece en la hora a la 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 evaluará y se aplicará al tiempo notificado. 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 deben abordarse al llamar a la API de detalles de uso:

1. Informes de fin de mes: para el uso que se produjo durante un mes, pero que se notifica durante el mes siguiente, los clientes tendrán que ver 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 detalles de uso a 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 los 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 la fecha en que se produjo el uso, en la sección additionalProperties.

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\"
            }",

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

Consumo de Azure con el SDK de NodeJS

Consumo de Azure con el SDK de Ruby