Esercitazione: Eseguire il seeding di un set di dati cronologico dei costi con l'API Esportazioni

Articolo
08/09/2024

Le organizzazioni di grandi dimensioni spesso devono analizzare i costi cronologici che risalgono a un anno prima o più. La creazione del set di dati potrebbe essere necessaria per le richieste occasionali mirate o per configurare dashboard di report per visualizzare le tendenze dei costi nel tempo. In entrambi i casi, è necessario un modo per ottenere i dati in modo affidabile in modo da poterli caricare in un archivio dati su cui è possibile eseguire query. Dopo il seeding del set di dati dei costi cronologici, l'archivio dati può quindi essere aggiornato man mano che arrivano nuovi costi in modo che i report vengano mantenuti aggiornati. I costi cronologici cambiano raramente e, in tal caso, si riceve una notifica. È quindi consigliabile aggiornare i costi cronologici non più di una volta al mese.

In questa esercitazione apprenderai a:

Ottenere un token di connessione per l'entità servizio
Formattare la richiesta
Eseguire le richieste in blocchi di un mese

Prerequisiti

Sono necessarie autorizzazioni appropriate per chiamare correttamente l'API Esportazioni. È consigliabile usare un'entità servizio negli scenari di automazione.

Per altre informazioni, vedere Assegnare autorizzazioni alle API di Gestione dei costi Microsoft.
Per altre informazioni sulle autorizzazioni specifiche necessarie per l'API Esportazioni, vedere Informazioni e utilizzo degli ambiti.

Inoltre, è necessario un modo per eseguire query direttamente sull'API. Ecco alcuni modi comuni per eseguire query sull'API:

Ottenere un token di connessione per l'entità servizio

Per informazioni su come ottenere un token di connessione con un'entità servizio, vedere Acquisire un token di accesso.

Formattare la richiesta

Vedere la richiesta di esempio seguente e creare un'esportazione dei dati monouso. La richiesta di esempio seguente crea un set di dati costo effettivo di un mese nell'account di archiviazione di Azure specificato. È consigliabile richiedere non più di un mese di dati per ogni report. Se si dispone di un set di dati di grandi dimensioni ogni mese, è consigliabile impostare partitionData = true per l'esportazione una tantum per suddividerla in più file. Per altre informazioni, vedere Partizionamento di file per set di dati di grandi dimensioni.

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

Intestazioni della richiesta

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

Corpo della richiesta

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

Creare esportazioni in blocchi di un mese

È consigliabile creare esportazioni di dati monouso in blocchi di un mese. Se si vuole eseguire il seeding di un set di dati cronologico di un anno, è necessario eseguire 12 richieste API Esportazione, una per ogni mese. Dopo aver eseguito il seeding del set di dati cronologico, è quindi possibile creare un'esportazione pianificata per continuare a popolare i dati sui costi in Archiviazione di Azure man mano che gli addebiti si accumulano nel tempo.

Eseguire ogni esportazione

Dopo aver creato l'esportazione per ogni mese, è necessario eseguire manualmente ogni operazione chiamando l'API Esegui. Ecco una richiesta di esempio per l'API.

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

Passaggi successivi

Questa esercitazione ha descritto come:

Ottenere un token di connessione per l'entità servizio
Formattare la richiesta
Eseguire le richieste in blocchi di un mese

Per altre informazioni sui dettagli sui costi, vedere Inserire i dati dei dettagli sui costi.

Per altre informazioni sui dati disponibili nel set di dati dei dettagli sui costi, vedere Informazioni sui campi dati dei dettagli dei costi.

Condividi tramite