APIs de Relatórios para clientes Enterprise – Saldo e Resumo
Nota
A 1 de maio de 2024, as APIs de Relatórios empresariais do Azure serão descontinuadas. Quaisquer APIs de Relatórios Empresariais restantes deixarão de responder aos pedidos. Os clientes têm de transitar para a utilização das APIs do Microsoft Cost Management antes disso. Para saber mais, veja Descrição geral sobre como migrar das APIs de Relatórios Enterprise do Azure para as APIs do Microsoft Cost Management.
A API de Saldo e Resumo oferece um resumo mensal de informações sobre saldos, novas compras, custos de serviço do Azure Marketplace, ajustes e custos de utilização excedida.
Pedir
As propriedades comuns do cabeçalho que precisam de ser adicionadas estão especificadas no artigo Descrição geral das APIs de Relatórios para clientes Enterprise. Se não for especificado um período de faturação, são devolvidos os dados do período de faturação atual.
Método | URI do pedido |
---|---|
GET | https://consumption.azure.com/v3/enrollments/{enrollmentNumber}/balancesummary |
GET | https://consumption.azure.com/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/balancesummary |
Nota
Para utilizar a versão anterior da API, substitua v3 por v2 nos URLs acima. Alguns campos não estão disponíveis se utilizar v2.
Resposta
{
"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
}
]
}
Definições de propriedades de resposta
Nome da Propriedade | Tipo | Descrição |
---|---|---|
ID | string | O ID exclusivo para um período de faturação e inscrição específicos |
billingPeriodId | string | O ID do período de faturação |
currencyCode | string | O código de moeda |
beginningBalance | decimal | O saldo inicial do período de faturação |
endBalance | decimal | O saldo final do período de faturação (para períodos abertos, este será atualizado diariamente) |
newPurchases | decimal | Montante total da nova compra |
ajustes | decimal | Montante total de ajuste |
utilizado | decimal | Utilização total da Alocação |
serviceOverage | decimal | Utilização excedida para serviços do Azure |
chargesBilledSeparately | decimal | Custos Faturados separadamente |
totalOverage | decimal | serviceOverage + chargesBilledSeparately |
totalUsage | decimal | Alocação do serviço do Azure + Utilização Excedida total |
azureMarketplaceServiceCharges | decimal | Total de custos de Azure Marketplace |
newPurchasesDetails | Matriz de cadeia JSON de pares Valor do Nome | Lista de novas compras |
adjustmentDetails | Matriz de cadeia JSON de pares Valor do Nome | Lista de Ajustes (Crédito promocional, crédito SIE, etc.) |