Tutorial: Semear um conjunto de dados de custo histórico com a API de Exportações

Artigo
07/30/2024

Grandes organizações geralmente precisam analisar seus custos históricos de um ano ou mais. A criação do conjunto de dados pode ser necessária para consultas únicas direcionadas ou para configurar painéis de relatórios para visualizar tendências de custos 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 de custo histórico for semeado, seu armazenamento de dados poderá ser atualizado à medida que novos custos forem chegando, para que seus relatórios sejam mantidos atualizados. Os custos históricos raramente mudam e, em caso afirmativo, você é notificado. Por isso, recomendamos que atualize os seus custos históricos no máximo uma vez por mês.

Neste tutorial, irá aprender a:

Obtenha um token de portador para a sua entidade de serviço
Formatar o pedido
Execute 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. Recomendamos o uso de uma entidade de serviço em cenários de automação.

Para saber mais, consulte Atribuir permissões a APIs de gerenciamento de custos.
Para saber mais sobre as permissões específicas necessárias para a API de Exportações, consulte Compreender e trabalhar com escopos.

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

Obtenha um token de portador para a sua entidade de serviço

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

Formatar o pedido

Veja a solicitação de exemplo a seguir e crie sua própria exportação de dados única. A solicitação de exemplo a seguir cria um conjunto de dados de Custo Real de um mês na conta de armazenamento do Azure especificada. Recomendamos que você solicite no máximo um mês de dados por relatório. Se você tiver um grande conjunto de dados todos os meses, recomendamos a configuração partitionData = true para sua exportação única 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 dos Pedidos

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

Órgão do Pedido

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

Recomendamos a criação de exportações de dados únicas em blocos de um mês. Se você quiser semear um conjunto de dados histórico de um ano, execute 12 solicitações de API de exportação - uma para cada mês. Depois de semear seu conjunto de dados histórico, você pode criar uma exportação agendada para continuar preenchendo 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, você precisa executar manualmente cada uma chamando a API de execução . Aqui está um exemplo de solicitação para a API.

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

Próximos passos

Neste tutorial, ficou a saber como:

Obtenha um token de portador para a sua entidade de serviço
Formatar o pedido
Execute as solicitações em partes de um mês

Para saber mais sobre detalhes de custo, consulte dados de detalhes de custo de ingestão.

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

Partilhar via