Tutorial: Durchführen eines Seedings für ein Dataset mit historischen Kosten mit der Export-API

Artikel
07/31/2024

Große Organisationen müssen oft ihre historischen Kosten analysieren, die ein Jahr oder länger zurückliegen. Die Erstellung des Datasets kann für gezielte, einmalige Abfragen oder zum Einrichten von Berichterstellungsdashboards zur Visualisierung von Kostentrends im Zeitverlauf erforderlich sein. In beiden Fällen benötigen Sie eine Möglichkeit, die Daten verlässlich abzurufen, damit Sie sie in einen Datenspeicher laden können, den Sie abfragen können. Nachdem das Seeding für Ihr Dataset mit historischen Kosten erfolgt ist, kann Ihr Datenspeicher bei Eingang neuer Kosten aktualisiert werden, sodass Ihre Berichterstellung stets auf dem neuesten Stand ist. Historische Kosten ändern sich selten. Falls dies geschieht, werden Sie benachrichtigt. Wir empfehlen daher, dass Sie Ihre historischen Kosten nicht öfter als einmal im Monat aktualisieren.

In diesem Tutorial lernen Sie Folgendes:

Abrufen eines Bearertokens für Ihren Dienstprinzipal
Formatieren der Anforderung
Ausführen der Anforderungen in einmonatigen Blöcken

Voraussetzungen

Sie benötigen ordnungsgemäße Berechtigungen, um die Export-API erfolgreich aufrufen zu können. Es wird empfohlen, in Automatisierungsszenarien einen Dienstprinzipal zu verwenden.

Weitere Informationen finden Sie unter Zuweisen von Berechtigungen zu Kostenverwaltungs-APIs.
Weitere Informationen zu den spezifischen Berechtigungen, die für die Export-API benötigt werden, finden Sie unter Verstehen von und Arbeiten mit Bereichen.

Darüber hinaus benötigen Sie eine Möglichkeit, die API direkt abzufragen. Einige gängige Methoden zum Abfragen der API sind:

Abrufen eines Bearertokens für Ihren Dienstprinzipal

Informationen zum Abrufen eines Bearertokens mit einem Dienstprinzipal finden Sie unter Beziehen eines Zugriffstokens.

Formatieren der Anforderung

Sehen Sie sich die folgende Beispielanforderung an, und erstellen Sie einen eigenen einmaligen Datenexport. Die folgende Beispielanforderung erstellt ein Dataset mit den Ist-Kosten eines Monats im angegebenen Azure-Speicherkonto. Wir empfehlen Ihnen, pro Bericht nicht mehr als die Daten eines Monats anzufordern. Wenn Sie jeden Monat über ein großes Dataset verfügen, empfiehlt es sich, für Ihren einmaligen Export partitionData = true festzulegen, damit es in mehrere Dateien unterteilt wird. Weitere Informationen finden Sie unter Dateipartitionierung für große Datasets.

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

Anforderungsheader

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

Anforderungstext

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

Erstellen von Exporten in einmonatigen Blöcken

Es wird empfohlen, einmalige Datenexporte in Blöcken von je einem Monat zu erstellen. Wenn Sie ein Seeding eines historischen Datasets für ein Jahr durchführen möchten, sollten Sie 12 Export-API-Anforderungen ausführen, eine für jeden Monat. Nachdem Sie das Seeding für Ihr historisches Dataset durchgeführt haben, können Sie einen geplanten Export erstellen, um Ihre Kostendaten weiterhin in Azure Storage zu speichern, während sich über die Zeit Gebühren ansammeln.

Ausführen der einzelnen Exportvorgänge

Nachdem Sie den Export für jeden Monat erstellt haben, müssen Sie ihn jeweils manuell ausführen, indem Sie die Execute-API aufrufen. Es folgt eine Beispielanforderung an die API.

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

Nächste Schritte

In diesem Tutorial haben Sie gelernt, wie die folgenden Aufgaben ausgeführt werden:

Abrufen eines Bearertokens für Ihren Dienstprinzipal
Formatieren der Anforderung
Ausführen der Anforderungen in einmonatigen Blöcken

Weitere Informationen zu Kostendetails finden Sie unter Erfassen von Daten mit Kostendetails.

Weitere Informationen dazu, welche Daten im Dataset mit den Kostendetails verfügbar sind, finden Sie unter Grundlegendes zu Datenfeldern mit Kostendetails.

Freigeben über