Tutorial: Propagar um conjunto de dados de custos históricos com a API de Exportações

  • Artigo

Muitas vezes, as grandes organizações precisam de analisar os seus custos históricos há um ano ou mais. A criação do conjunto de dados pode ser necessária para consultas únicas direcionadas ou para configurar dashboards de relatórios para visualizar tendências de custos ao longo do tempo. Em qualquer um dos casos, precisa de uma forma de obter os dados de forma fiável para que possa carregá-lo para um arquivo de dados que possa consultar. Depois de o conjunto de dados de custos históricos ser propagado, o seu arquivo de dados pode ser atualizado à medida que forem apresentados novos custos para que os relatórios sejam mantidos atualizados. Os custos históricos raramente mudam e, em caso afirmativo, será notificado. Por isso, recomendamos que atualize os custos históricos uma vez por mês.

Neste tutorial, ficará a saber como:

  • Obter um token de portador para o principal de serviço
  • Formatar o pedido
  • Executar os pedidos em segmentos de um mês

Pré-requisitos

Precisa de permissões adequadas para chamar com êxito a API de Exportações. Recomendamos a utilização de um Principal de Serviço em cenários de automatização.

Além disso, precisará de uma forma de consultar a API diretamente. Para este tutorial, recomendamos a utilização do PostMan.

Obter um token de portador para o principal de serviço

Para saber como obter um token de portador com um principal de serviço, veja Adquirir um token de Acesso.

Formatar o pedido

Veja o seguinte pedido de exemplo e crie os seus próprios dados únicos Exportar. O pedido de exemplo seguinte cria um conjunto de dados custo real de um mês na conta de armazenamento do Azure especificada. Recomendamos que não solicite mais do que um mês de dados por relatório. Se tiver um conjunto de dados grande todos os meses, recomendamos que defina partitionData = true a sua exportação única para dividi-lo em múltiplos ficheiros. Para obter mais informações, veja Criação de partições de ficheiros para conjuntos de dados grandes.

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

Corpo 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 segmentos de um mês

Recomendamos que crie exportações de dados únicas em segmentos de um mês. Se quiser propagar um conjunto de dados histórico de um ano, deve executar 12 pedidos de API de Exportações , um para cada mês. Depois de propagar o conjunto de dados histórico, pode criar uma exportação agendada para continuar a preencher os dados de custos no armazenamento do Azure à medida que os custos se acumulam ao longo do tempo.

Executar cada Exportação

Agora que criou a Exportação para cada mês, tem de executar manualmente cada um ao chamar a API Executar. Segue-se um pedido de exemplo para a API.

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

Passos seguintes

Neste tutorial, ficou a saber como:

  • Obter um token de portador para o principal de serviço
  • Formatar o pedido
  • Executar os pedidos em segmentos de um mês

Para saber mais sobre os detalhes de custos, veja dados de detalhes de custos de ingestão.

Para saber mais sobre que dados estão disponíveis no conjunto de dados de detalhes de custos, veja Compreender os campos de dados de detalhes de custos.