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

Artikel
11/17/2023

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 fråga efter. När din historiska kostnadsdatauppsättning har såtts 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 meddelas du. Därför rekommenderar vi att du uppdaterar dina historiska kostnader högst en gång i månaden.

I den här guiden får du lära 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. I den här självstudien rekommenderar vi att du använder PostMan.

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

Information om hur du hämtar en ägartoken med ett tjänsthuvudnamn 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 ställer in partitionData = true en engångsexport för att dela upp den 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årad historisk datauppsättning bör du köra 12 export-API-begäranden – en för varje månad. När du har skapat din historiska datauppsättning 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 API:et Kör. Nedan visas 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 med kostnadsinformation finns i Förstå datafält för kostnadsinformation.

Dela via