Tutorial: propagar um conjunto de dados do histórico de custos com a API de Exportações

  • Artigo

As grandes organizações geralmente precisam analisar o histórico de custos que remontam a um ano ou mais. A criação do conjunto de dados pode ser necessária para consultas pontuais direcionadas ou para configurar painéis de relatórios para visualizar as tendências de custo ao longo do tempo. Em ambos os casos, você precisa de uma maneira de obter os dados de forma confiável, para que possa carregá-los em um armazenamento de dados que possa consultar. Depois que o conjunto de dados do histórico de custos for propagado, o armazenamento de dados poderá ser atualizado, à medida que novos custos chegarem, de modo que os relatórios sejam mantidos atualizados. O histórico de custos raramente muda e, nesse caso, você será notificado. Portanto, recomendamos que você atualize o histórico de custos, no máximo, uma vez ao mês.

Neste tutorial, você aprenderá a:

  • Obter um token de portador para a entidade de serviço
  • Formatar a solicitação
  • Executar as solicitações em partes de um mês

Pré-requisitos

Você precisa de permissões adequadas para chamar com êxito a API de Exportações. É recomendável usar uma Entidade de Serviço em cenários de automação.

Além disso, você precisará de uma maneira de consultar a API diretamente. Para este tutorial, recomendamos usar o PostMan.

Obter um token de portador para a entidade de serviço

Para saber como obter um token de portador com uma entidade de serviço, confira Adquirir um token de acesso.

Formatar a solicitação

Confira a solicitação de exemplo a seguir e crie sua própria exportação de dados avulsos. A solicitação de exemplo a seguir cria um conjunto de dados de Custo Real de um mês na conta de armazenamento especificada do Azure. Recomendamos que você solicite, no máximo, um mês de dados por relatório. Se você tiver um grande conjunto de dados todo mês, é recomendável configurar o partitionData = true para a exportação avulsa, para dividi-lo em vários arquivos. Para obter mais informações, consulte particionamento de arquivos para grandes conjuntos de dados.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{enrollmentId}/providers/Microsoft.CostManagement/exports/{ExportName}?api-version=2021-10-01

Cabeçalhos da solicitação

Authorization: <YOUR BEARER TOKEN>
Accept: /*/
Content-Type: application/json

Corpo da solicitação

{
  "properties": {
    "definition": {
      "dataset": {
        "granularity": "Daily",
        "grouping": []
      },
      "timePeriod": {
        "from": "2021-09-01T00:00:00.000Z",
        "to": "2021-09-30T00:00:00.000Z"
      },
      "timeframe": "Custom",
      "type": "ActualCost"
    },
    "deliveryInfo": {
      "destination": {
        "container": "{containerName}",
        "rootFolderPath": "{folderName}",
        "resourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}"
      }
    },
    "format": "Csv",
    "partitionData": false
  }
}

Criar exportações em partes de um mês

É recomendável criar exportações de dados one-time em partes de um mês. Se você quiser propagar um conjunto de dados do histórico de um ano, deverá executar 12 solicitações à API de Exportações – uma para cada mês. Depois de propagar o conjunto de dados do histórico, você pode criar uma exportação agendada para continuar preenchendo os dados de custo no armazenamento do Azure, à medida que as cobranças se acumulam ao longo do tempo.

Executar cada Exportação

Agora que você criou a Exportação para cada mês, é necessário executar manualmente cada uma, chamando a API Execute. Veja abaixo uma solicitação de exemplo para a API.

POST https://management.azure.com/{scope}/providers/Microsoft.CostManagement/exports/{exportName}/run?api-version=2021-10-01

Próximas etapas

Neste tutorial, você aprendeu a:

  • Obter um token de portador para a entidade de serviço
  • Formatar a solicitação
  • Executar as solicitações em partes de um mês

Para saber mais sobre os detalhes do custo, confira Ingerir dados de detalhes do custo.

Para saber mais sobre quais dados estão disponíveis no conjunto de dados de detalhes de custo, confira Entender os campos de dados de detalhes de custo.