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

Artigo
07/30/2024

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. Os custos históricos raramente mudam e, se mudarem, 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.

Para saber mais, confira Atribuir permissões às APIs de Gerenciamento de Custos.
Para saber mais sobre as permissões específicas necessárias para a API de Exportações, confira Entender e trabalhar com escopos.

Além disso, você precisa de uma maneira de consultar a API diretamente. Algumas formas populares de consultar a API são:

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 seu conjunto de dados históricos, você pode criar uma exportação agendada para continuar a preencher seus dados de custo no armazenamento do Azure à medida que suas 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 delas chamando a API Execute. Aqui está um exemplo de solicitação da 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.

Compartilhar via