Kurz: Počáteční datová sada historických nákladů pomocí rozhraní API pro exporty

Článek
01/07/2025

Velké organizace často potřebují analyzovat své historické náklady, které se vrací za rok nebo déle. Vytvoření datové sady může být potřeba pro cílené jednorázové dotazy nebo nastavení řídicích panelů pro vytváření sestav pro vizualizaci trendů nákladů v průběhu času. V obou případech potřebujete způsob, jak spolehlivě získat data, abyste je mohli načíst do úložiště dat, na které se můžete dotazovat. Jakmile se datová sada historických nákladů zasadí, úložiště dat se pak dá aktualizovat tak, jak přicházejí nové náklady, aby se sestavy udržovaly v aktualizovaném stavu. Historické náklady se zřídka mění a pokud ano, dostanete upozornění. Proto doporučujeme aktualizovat historické náklady maximálně jednou za měsíc.

V tomto kurzu se naučíte:

Získání nosný token pro instanční objekt
Formátování požadavku
Provádění požadavků v blocích na jeden měsíc

Požadavky

K úspěšnému volání rozhraní API pro exporty potřebujete správná oprávnění. Ve scénářích automatizace doporučujeme použít instanční objekt.

Další informace najdete v tématu Přiřazení oprávnění k rozhraním API služby Cost Management.
Další informace o konkrétních oprávněních potřebných pro rozhraní API pro exporty najdete v tématu Vysvětlení a práce s obory.

Kromě toho potřebujete způsob, jak dotazovat rozhraní API přímo. Mezi oblíbené způsoby dotazování rozhraní API patří:

Visual Studio
Nespavost
Bruno
Invoke-RestMethod v PowerShellu
Kudrna

Získání nosný token pro instanční objekt

Informace o získání nosný token s instančním objektem najdete v tématu Získání přístupového tokenu.

Formátování požadavku

Podívejte se na následující příklad požadavku a vytvořte vlastní jednorázový export dat. Následující příklad požadavku vytvoří datovou sadu skutečných nákladů na měsíc v zadaném účtu úložiště Azure. Doporučujeme požadovat maximálně jeden měsíc dat na sestavu. Pokud máte každou měsíc velkou datovou sadu, doporučujeme nastavit partitionData = true , aby se jednorázový export rozdělil na několik souborů. Další informace najdete v tématu Dělení souborů pro velké datové sady.

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

Hlavičky požadavku

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

Text požadavku

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

Vytváření exportů v blocích na jeden měsíc

Doporučujeme vytvářet jednorázové exporty dat v blocích o měsících. Pokud chcete sesednout datovou sadu historických o jeden rok, měli byste pro každý měsíc spustit 12 požadavků rozhraní API pro export – jednu. Po počátečním vytvoření historické datové sady pak můžete vytvořit naplánovaný export, který bude pokračovat v naplnění nákladových dat v úložišti Azure, protože poplatky nabíhají v průběhu času.

Spuštění každého exportu

Teď, když jste vytvořili export pro každý měsíc, musíte je ručně spustit voláním rozhraní API pro spuštění . Tady je příklad požadavku na rozhraní API.

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

Další kroky

V tomto kurzu jste se naučili, jak:

Získání nosný token pro instanční objekt
Formátování požadavku
Provádění požadavků v blocích na jeden měsíc

Další informace opodrobnostch

Další informace o datech dostupných v datové sadě podrobností o nákladech najdete v tématu Vysvětlení datových polí podrobností o nákladech.

Sdílet prostřednictvím