API de informes para clientes de Enterprise: saldos y resumen

  • Artículo

Nota

El 1 de mayo de 2024, se retirarán las API de Azure Enterprise Reporting. Las API de Enterprise Reporting restantes dejarán de responder a las solicitudes. Los clientes deben realizar la transición al uso de las API de Microsoft Cost Management antes de entonces. Para más información, consulte Introducción a la migración de Azure Enterprise Reporting a las API de Microsoft Cost Management.

La API de saldos y resumen ofrece un resumen mensual de información sobre saldos, nuevas compras, gastos de servicios en Azure Marketplace, ajustes y gastos por de uso por encima del límite.

Solicitud

Las propiedades de encabezado comunes que deben agregarse se especifican en el artículo Información general de las API de informes para clientes de Enterprise. Si no se especifica un período de facturación, se devuelven los datos del período de facturación actual.

Método URI de solicitud
GET https://consumption.azure.com/v3/enrollments/{enrollmentNumber}/balancesummary
GET https://consumption.azure.com/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/balancesummary

Nota

Para usar la versión anterior de la API, reemplace v3 por v2 en las direcciones URL anteriores. Algunos campos no están disponibles si usa v2.

Response

        {
            "id": "enrollments/100/billingperiods/201507/balancesummaries",
              "billingPeriodId": 201507,
              "currencyCode": "USD",
              "beginningBalance": 0,
              "endingBalance": 1.1,
              "newPurchases": 1,
              "adjustments": 1.1,
              "utilized": 1.1,
              "serviceOverage": 1,
              "chargesBilledSeparately": 1,
              "totalOverage": 1,
              "totalUsage": 1.1,
              "azureMarketplaceServiceCharges": 1,
              "newPurchasesDetails": [
                {
                  "name": "",
                  "value": 1
                }
              ],
              "adjustmentDetails": [
                {
                  "name": "Promo Credit",
                  "value": 1.1
                },
                {
                  "name": "SIE Credit",
                  "value": 1.0
                }
              ]
        }

Definiciones de propiedad de respuesta

Nombre de propiedad Tipo Descripción
id string Identificador único para una inscripción y un período de facturación específicos
billingPeriodId string Identificador de período de facturación
currencyCode string Código de divisa
beginningBalance Decimal Saldo inicial del período de facturación
endingBalance Decimal Saldo final del período de facturación (para períodos abiertos, se actualizará a diario)
newPurchases Decimal Cantidad total de nuevas compras
adjustments Decimal Importe total de ajuste
utilized Decimal Uso total de compromiso
serviceOverage Decimal Uso por encima del límite de servicios de Azure
chargesBilledSeparately Decimal Gastos facturados por separado
totalOverage Decimal serviceOverage + chargesBilledSeparately
totalUsage Decimal Compromiso de servicio de Azure + uso por encima del límite total
azureMarketplaceServiceCharges Decimal Gastos totales de Azure Marketplace
newPurchasesDetails Matriz de cadenas JSON de pares de nombre y valor Lista de nuevas compras
adjustmentDetails Matriz de cadenas JSON de pares de nombre y valor Lista de ajustes (crédito promocional, crédito SIE, etc.)

Consulte también