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 Empresariais, assinaturas do 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 Enterprise
  • Tabela de preços
  • Orçamentos
  • Previsões
  • Saldos
  • Marcações
  • Marcas de custo
• Clientes Enterprise e Web Direct
  • 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 (DreamSpark)

Trabalhando com períodos de cobrança e intervalos de datas

Os Detalhes de Uso e os 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 em períodos de cobrança e intervalos de datas na solicitação.

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

Obtendo lista de períodos de cobrança

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

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 de relatórios, 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 para e aplicado à hora relatada. Para representar o tempo de consumo real, as propriedades. O campo 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:

1. 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 adicionalPropriedades para atribuir o uso ao mês apropriado.

2. Detalhes de uso da consulta: ao consultar a API de detalhes de uso por um intervalo de datas, a consulta só se aplica à data do relatório de uso e não à hora de consumo no campo adicionalPropriedades . Para clientes que procuram 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 os clientes, procurando mapear detalhes de uso para uma data/mês de calendário específica, essa atualização é uma alteração interruptiva 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.

Chamada de exemplo para detalhes adicionais:

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

Snippet de resposta de exemplo:

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

Confira também

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

SDK do Python do Azure Consumption

CLI do Azure Consumption

SDK NodeJS do Azure Consumption

SDK Ruby do Azure Consumption