Usar APIs de Cobrança do Azure para obter informações programaticamente sobre o uso do AzureUse Azure Billing APIs to programmatically get insight into your Azure usage

Use APIs de cobrança do Azure para efetuar pull de dados de uso e de recurso em suas ferramentas de análise de dados preferidas.Use Azure Billing APIs to pull usage and resource data into your preferred data analysis tools. As APIs RateCard e de Uso de Recursos do Azure e podem ajudá-lo a prever e gerenciar seus custos com precisão.The Azure Resource Usage and RateCard APIs can help you accurately predict and manage your costs. As APIs são implementadas como um Provedor de Recursos e como parte da família de APIs expostas pelo Azure Resource Manager.The APIs are implemented as a Resource Provider and part of the family of APIs exposed by the Azure Resource Manager.

API de Download de fatura do Azure (Visualização)Azure Invoice Download API (Preview)

Após a conclusão da aceitação, baixe as faturas usando a versão de visualização da API de Fatura.Once the opt-in has been complete, download invoices using the preview version of Invoice API. Os recursos incluem:The features include:

  • Azure RBAC (controle de acesso baseado em função) – configure suas políticas de acesso no Portal do Azure ou por meio dos cmdlets do Azure PowerShell para especificar quais usuários ou aplicativos podem ter acesso aos dados de uso da assinatura.Azure role-based access control (Azure RBAC) - Configure access policies on the Azure portal or through Azure PowerShell cmdlets to specify which users or applications can get access to the subscription’s usage data. Os chamadores devem usar tokens padrão do Azure Active Directory para autenticação.Callers must use standard Azure Active Directory tokens for authentication. Adicione o chamador à função Leitor de Fatura, Leitor, Proprietário ou Colaborador para obter acesso aos dados de uso para uma assinatura específica do Azure.Add the caller to either the Billing Reader, Reader, Owner, or Contributor role to get access to the usage data for a specific Azure subscription.
  • Filtragem de Data - Use o parâmetro $filter para obter todas as faturas em ordem cronológica inversa por data de término do período da fatura.Date Filtering - Use the $filter parameter to get all the invoices in reverse chronological order by the invoice period end date.

Observação

Esse recurso está na primeira versão de visualização e pode estar sujeito a alterações incompatíveis com versões anteriores.This feature is in first version of preview and may be subject to backward-incompatible changes. Atualmente, ele não está disponível para determinadas ofertas de assinatura (não há suporte para EA, CSP, AIO) e para o Azure na Alemanha.Currently, it's not available for certain subscription offers (EA, CSP, AIO not supported) and Azure Germany.

API de uso de recursos do Azure (visualização)Azure Resource Usage API (Preview)

Use as API de Uso de Recursos do Azure para obter seus dados de consumo estimado do Azure.Use the Azure Resource Usage API to get your estimated Azure consumption data. A API inclui:The API includes:

  • Azure RBAC (controle de acesso baseado em função) – configure suas políticas de acesso no Portal do Azure ou por meio dos cmdlets do Azure PowerShell para especificar quais usuários ou aplicativos podem ter acesso aos dados de uso da assinatura.Azure role-based access control (Azure RBAC) - Configure access policies on the Azure portal or through Azure PowerShell cmdlets to specify which users or applications can get access to the subscription’s usage data. Os chamadores devem usar tokens padrão do Azure Active Directory para autenticação.Callers must use standard Azure Active Directory tokens for authentication. Adicione o chamador à função Leitor de Fatura, Leitor, Proprietário ou Colaborador para obter acesso aos dados de uso para uma assinatura específica do Azure.Add the caller to either the Billing Reader, Reader, Owner, or Contributor role to get access to the usage data for a specific Azure subscription.
  • Agregações diárias ou por hora - os chamadores podem especificar se eles desejam seus dados de uso do Azure em buckets por hora ou buckets diários.Hourly or Daily Aggregations - Callers can specify whether they want their Azure usage data in hourly buckets or daily buckets. O padrão é diário.The default is daily.
  • Metadados da instância (inclui as marcas do recurso) – obtenha detalhes no nível da instância, como o URI de recurso totalmente qualificado (/subscriptions/{subscription-id}/..), as informações do grupo de recursos e marcas do recurso.Instance metadata (includes resource tags) – Get instance-level detail like the fully qualified resource uri (/subscriptions/{subscription-id}/..), the resource group information, and resource tags. Esses metadados ajudam você a alocar de forma determinista e programática o uso por marcas, para casos de uso como cobrança cruzada.This metadata helps you deterministically and programmatically allocate usage by the tags, for use-cases like cross-charging.
  • Metadados de recurso – detalhes de recurso como nome do medidor, categoria do medidor, subcategoria do medidor, unidade e região proporcionam ao chamador um melhor entendimento do que foi consumido.Resource metadata - Resource details such as the meter name, meter category, meter sub category, unit, and region give the caller a better understanding of what was consumed. Também estamos trabalhando para alinhar a terminologia de metadados de recursos entre o portal do Azure, o CSV de uso do Azure, o CSV de cobrança EA e outras experiências públicas, para permitir que você correlacione dados entre as experiências.We're also working to align resource metadata terminology across the Azure portal, Azure usage CSV, EA billing CSV, and other public-facing experiences, to let you correlate data across experiences.
  • Uso para diferentes tipos de oferta – os dados de uso estão disponíveis para os tipos de oferta, assim como pré-pago, MSDN, investimento e crédito monetário e EA, exceto CSP.Usage for different offer types – Usage data is available for offer types like Pay-as-you-go, MSDN, Monetary commitment, Monetary credit, and EA, except CSP.

API RateCard de Recursos do Azure (visualização)Azure Resource RateCard API (Preview)

Use a API RateCard de Recursos do Azure para obter a lista de recursos do Azure disponíveis, juntamente com as informações estimadas de preço para cada um deles.Use the Azure Resource RateCard API to get the list of available Azure resources and estimated pricing information for each. A API inclui:The API includes:

  • Azure RBAC (controle de acesso baseado em função) – configure suas políticas de acesso no portal do Azure ou por meio dos cmdlets do Azure PowerShell para especificar quais usuários ou aplicativos podem ter acesso aos dados do RateCard.Azure role-based access control (Azure RBAC) - Configure your access policies on the Azure portal or through Azure PowerShell cmdlets to specify which users or applications can get access to the RateCard data. Os chamadores devem usar tokens padrão do Azure Active Directory para autenticação.Callers must use standard Azure Active Directory tokens for authentication. Adicione o chamador à função Leitor, Proprietário ou Colaborador para obter acesso aos dados de uso para uma assinatura particular do Azure.Add the caller to either the Reader, Owner, or Contributor role to get access to the usage data for a particular Azure subscription.
  • Suporte para pré-pago, MSDN, ofertas de investimento e crédito monetário (EA e CSP não têm suporte) – Esta API fornece informações de taxa no nível da oferta do Azure.Support for Pay-as-you-go, MSDN, Monetary commitment, and Monetary credit offers (EA and CSP not supported) - This API provides Azure offer-level rate information. O chamador dessa API deve passar as informações de oferta para obter taxas e detalhes do recurso.The caller of this API must pass in the offer information to get resource details and rates. Já que as ofertas de EA têm taxas personalizadas por registro, não seremos capazes de fornecer as taxas de EA neste momento.We're currently unable to provide EA rates because EA offers have customized rates per enrollment.

CenáriosScenarios

Aqui estão alguns dos cenários possíveis com a combinação das APIs de Uso e RateCard:Here are some of the scenarios that are made possible with the combination of the Usage and the RateCard APIs:

  • Gasto do Azure durante o mês – use a combinação das APIs RateCard e de uso para obter melhores informações sobre o seu gasto com nuvem durante o mês.Azure spend during the month - Use the combination of the Usage and RateCard APIs to get better insights into your cloud spend during the month. Você pode analisar os buckets horários e diários de uso e as estimativas de custo.You can analyze the hourly and daily buckets of usage and charge estimates.

  • Configurar alertas – use as APIs RateCard e de uso para obter o consumo de nuvem e encargos estimados e configurar alertas com base em recursos ou em valores financeiros.Set up alerts – Use the Usage and the RateCard APIs to get estimated cloud consumption and charges, and set up resource-based or monetary-based alerts.

  • Previsão de fatura – obtenha seu consumo estimado e gasto de nuvem e aplicar algoritmos de aprendizado de máquina para prever qual seria sua fatura no final do ciclo de cobrança.Predict bill – Get your estimated consumption and cloud spend, and apply machine learning algorithms to predict what the bill would be at the end of the billing cycle.

  • Análise de custo de pré-consumo – usar a API RateCard para prever quanto sua fatura seria para seu uso esperado ao mover suas cargas de trabalho para o Azure.Pre-consumption cost analysis – Use the RateCard API to predict how much your bill would be for your expected usage when you move your workloads to Azure. Se você tem cargas de trabalho existentes em outras nuvens ou nuvens privadas, você também pode mapear seu uso com as taxas do Azure para obter uma melhor estimativa do seu gasto com o Azure.If you have existing workloads in other clouds or private clouds, you can also map your usage with the Azure rates to get a better estimate of Azure spend. Essa estimativa fornece a capacidade de dinamizar a oferta e comparar e contrastar os tipos diferentes de oferta além de pré-pago, tais como o compromisso monetário e o crédito monetário.This estimate gives you the ability to pivot on offer, and compare and contrast between the different offer types beyond Pay-As-You-Go, like Monetary commitment and Monetary credit. A API também oferece a capacidade de ver as diferenças de custo por região e permite que você faça uma análise hipotética do custo para lhe ajudar a tomar decisões de implantação.The API also gives you the ability to see cost differences by region and allows you to do a what-if cost analysis to help you make deployment decisions.

  • Hipóteses -What-if analysis -

    • Você pode determinar se é mais econômico executar suas cargas de trabalho em outra região ou em outra configuração do recurso do Azure.You can determine whether it is more cost-effective to run workloads in another region, or on another configuration of the Azure resource. Os custos de recursos do Azure podem mudar com base na região do Azure que você está usando.Azure resource costs may differ based on the Azure region you're using.
    • Você também pode determinar se outro tipo de oferta do Azure oferece uma melhor taxa em um recurso do Azure.You can also determine if another Azure offer type gives a better rate on an Azure resource.

Próximas etapasNext steps