Consumo do Azure

As APIs de consumo do Azure lhe oferecem acesso programático a dados de uso e de custo para os recursos do Azure. Atualmente, as APIs dão suporte apenas a Registros Corporativos, assinaturas Web Direct (com algumas exceções) e assinaturas de plano do Azure do CSP. As APIs são continuamente atualizadas para dar suporte a outros tipos de assinaturas do Azure.

As APIs de consumo do Azure fornecem acesso a:

Somente clientes corporativos
- Tabela de preços
- Orçamentos
- Previsões
- Balances
- Etiquetas
- Etiquetas de custo
Clientes corporativos e diretos da Web
- Detalhes da reserva
- Resumos da reserva
- Cobranças do Marketplace
- Detalhes de uso
- Recomendações de reserva

Lista de Tipos de Assinatura sem Suporte

MS-AZR-0145P (CSP)
MS-AZR-0146P (CSP)
MS-AZR-159P (CSP)
MS-AZR-0036P (patrocinado)
MS-AZR-0143P (patrocinado)
MS-AZR-0015P (interno)
MS-AZR-0144P (Faísca dos Sonhos)

Trabalhar com períodos de faturamento e intervalos de datas

Detalhes de uso e Encargos do Marketplace aceitam período de cobrança ou intervalos de datas para definir as datas de início e término dos dados de uso.

Aqui está o comportamento da API com base nos períodos de faturamento e nos intervalos de datas na solicitação.

Período de cobrança presente na solicitação	Data de início presente na solicitação	Data de término presente na solicitação	Comportamento da API
Não	Não	Não	Os dados do período de faturamento atual são retornados em resposta
Não	Sim	Não	Os dados do período de faturamento atual são retornados em resposta
Não	Não	Sim	Os dados do período de faturamento atual são retornados em resposta
Não	Sim	Sim	Os dados para a data de início e término especificada são retornados em resposta
Sim	Não	Não	Os dados do período de faturamento especificado são retornados em resposta
Sim	Sim	Não	Os dados do período de faturamento especificado são retornados em resposta
Sim	Não	Sim	Os dados do período de faturamento especificado são retornados em resposta
Sim	Sim	Sim	Os dados para as datas de início e término especificadas são retornados em resposta, o período de cobrança fornecido é ignorado

O período máximo permitido é de 12 meses em uma solicitação e os dados estão disponíveis a partir de 1º de maio de 2014.

Obtendo lista de períodos de cobrança

Para fornecer um período de faturamento válido na solicitação, o cliente deve primeiro obter uma lista de períodos de faturamento disponíveis por assinatura, usando a seguinte API

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

Usando essa lista, o cliente pode escolher um período de cobrança específico para obter dados de consumo.

Dados de chegada tardia

Para acomodar serviços de terceiros, que têm atrasos no uso do relatório, a data de uso relatada é definida como a hora em que os dados de uso foram enviados, em vez de quando o uso real ocorreu, ou seja, o tempo de consumo.

Como resultado, o uso será classificado e aplicado ao tempo relatado. Para representar o tempo real de consumo, as propriedades. AdditionalProperties agora conterá duas propriedades adicionais. ConsumptionBeginTime e ConsumptionEndTime são os novos campos que correspondem à janela de tempo de consumo real.

Essas alterações resultarão em alguns cenários que precisarão ser resolvidos ao chamar a API de detalhes de uso:

Relatório de fim de mês: para uso que ocorreu durante um mês, mas relatado durante o próximo mês, os clientes precisarão examinar o campo additionalProperties para atribuir o uso ao mês apropriado.
Detalhes de uso da consulta: ao consultar a API de detalhes de uso por um intervalo de datas, a consulta se aplica apenas à data do relatório de uso e não ao tempo de consumo no campo additionalProperties . Para clientes que desejam mapear detalhes de uso para faturas, essa atualização não afeta o processo, pois a fatura processará o uso com base na data do relatório de uso. Para clientes que desejam mapear detalhes de uso para uma data/mês de calendário específico, essa atualização é uma alteração significativa e, para esses cenários, a data do relatório de uso não pode ser usada e a data em que o uso ocorreu, na seção additionalProperties , deve ser usada.

Exemplo de chamada para detalhes adicionais:

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

Exemplo de snippet de resposta:

  "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 também

Para obter mais informações sobre como usar essa API em um dos SDKs específicos da linguagem, visite o seguinte

SDK do Python de Consumo do Azure

CLI de Consumo do Azure

SDK do NodeJS de Consumo do Azure

SDK Ruby de Consumo do Azure

Last updated on 2025-08-12

Compartilhar via