Självstudie: Seed a historical cost dataset with the Exports API (Seed a historical cost dataset with the Exports API)

Artikel
07/30/2024

Stora organisationer behöver ofta analysera sina historiska kostnader som går tillbaka ett år eller mer. Du kan behöva skapa datauppsättningen för riktade engångsförfrågningar eller för att konfigurera rapporteringsinstrumentpaneler för att visualisera kostnadstrender över tid. I båda fallen behöver du ett sätt att hämta data på ett tillförlitligt sätt så att du kan läsa in dem i ett datalager som du kan köra frågor mot. När din historiska kostnadsdatauppsättning har skapats kan datalagret uppdateras när nya kostnader kommer in så att din rapportering hålls uppdaterad. Historiska kostnader ändras sällan och i så fall får du ett meddelande. Därför rekommenderar vi att du uppdaterar dina historiska kostnader högst en gång i månaden.

I den här självstudien lär du dig att:

Hämta en ägartoken för tjänstens huvudnamn
Formatera begäran
Köra begäranden i enmånadssegment

Förutsättningar

Du behöver rätt behörigheter för att anropa export-API:et. Vi rekommenderar att du använder tjänstens huvudnamn i automatiseringsscenarier.

Mer information finns i Tilldela behörigheter till Cost Management-API:er.
Mer information om de specifika behörigheter som krävs för export-API:et finns i Förstå och arbeta med omfång.

Dessutom behöver du ett sätt att fråga API:et direkt. Några populära sätt att köra frågor mot API:et är:

Hämta en ägartoken för tjänstens huvudnamn

Information om hur du hämtar en ägartoken med tjänstens huvudnamn finns i Hämta en åtkomsttoken.

Formatera begäran

Se följande exempelbegäran och skapa din egen engångsdataexport. I följande exempelbegäran skapas en enmånads datauppsättning för faktisk kostnad i det angivna Azure-lagringskontot. Vi rekommenderar att du inte begär mer än en månads data per rapport. Om du har en stor datauppsättning varje månad rekommenderar vi att du anger partitionData = true att din engångsexport ska delas upp i flera filer. Mer information finns i Filpartitionering för stora datamängder.

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

Rubriker för begäran

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

Begärandetext

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

Skapa exporter i enmånadssegment

Vi rekommenderar att du skapar engångsdataexporter i ett månadssegment. Om du vill skapa en ettåringshistorik bör du köra 12 API-begäranden för export – en för varje månad. När du har skapat din historiska datamängd kan du sedan skapa en schemalagd export för att fortsätta fylla i dina kostnadsdata i Azure Storage när dina avgifter ackumuleras över tid.

Kör varje export

Nu när du har skapat Export för varje månad måste du köra var och en manuellt genom att anropa Kör API. Här är en exempelbegäran till API:et.

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

Nästa steg

I den här självstudiekursen lärde du dig att:

Hämta en ägartoken för tjänstens huvudnamn
Formatera begäran
Köra begäranden i enmånadssegment

Mer information om kostnadsinformation finns i mata in information om kostnader.

Mer information om vilka data som är tillgängliga i datauppsättningen för kostnadsinformation finns i Förstå datafält för kostnadsinformation.

Dela via