Oktatóanyag: Előzményköltség-adathalmaz bevetése az Export API-val

Cikk
11/17/2023

A nagy szervezeteknek gyakran kell elemezniük egy vagy több évre visszatekintő előzményköltségeiket. Előfordulhat, hogy az adatkészlet létrehozása szükséges a célzott egyszeri lekérdezésekhez, vagy jelentéskészítési irányítópultok beállításához a költségtrendek időbeli megjelenítéséhez. Mindkét esetben szüksége van egy olyan módszerre, amellyel megbízhatóan lekérheti az adatokat, hogy betölthesse őket egy lekérdezhető adattárba. Az előzményköltség-adathalmaz bevetése után az adattár frissíthető, mivel új költségek érkeznek, hogy a jelentéskészítés naprakész legyen. A korábbi költségek ritkán változnak, és ha igen, értesítést kap. Ezért javasoljuk, hogy havonta legfeljebb egyszer frissítse az előzményköltségeket.

Eben az oktatóanyagban az alábbiakkal fog megismerkedni:

Tulajdonosi jogkivonat lekérése a szolgáltatásnévhez
A kérelem formázása
A kérések végrehajtása egy hónapos adattömbökben

Előfeltételek

Az Export API sikeres meghívásához megfelelő engedélyekre van szüksége. Javasoljuk, hogy az automatizálási forgatókönyvekben használjon szolgáltatásnevet.

További információ: Engedélyek hozzárendelése Cost Management API-khoz.
Az Export API-hoz szükséges konkrét engedélyekről további információt a Hatókörök ismertetése és használata című témakörben talál.

Emellett az API-t közvetlenül le kell kérdeznie. Ebben az oktatóanyagban a PostMan használatát javasoljuk.

Tulajdonosi jogkivonat lekérése a szolgáltatásnévhez

A tulajdonosi jogkivonat szolgáltatásnévvel való beszerzéséről a Hozzáférési jogkivonat beszerzése című témakörben olvashat.

A kérelem formázása

Tekintse meg az alábbi példakérést, és hozzon létre egy saját egyszeri adatexportálást. Az alábbi példakérés egy egy hónapos tényleges költség adatkészletet hoz létre a megadott Azure Storage-fiókban. Javasoljuk, hogy jelentésenként legfeljebb egy hónapnyi adatot kérjen. Ha havonta nagy adatkészletet használ, javasoljuk, hogy az partitionData = true egyszeri exportálást több fájlra bontsa. További információ: Fájlparticionálás nagyméretű adathalmazokhoz.

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

Kérelemfejlécek

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

Kérelem törzse

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

Exportálások létrehozása egy hónapos adattömbökben

Javasoljuk, hogy egyszeri adatexportálásokat hozzon létre egy hónapos adattömbökben. Ha egy egyéves előzményadatkészletet szeretne magolni, akkor 12 Export API-kérést kell végrehajtania – minden hónapban egyet. Miután beszúrta az előzményadatkészletet, létrehozhat egy ütemezett exportálást, amellyel továbbra is feltöltheti a költségadatokat az Azure Storage-ban, ahogy a díjak idővel felmerülnek.

Az egyes exportálások futtatása

Most, hogy létrehozta az exportálást minden hónapra, manuálisan kell futtatnia őket az Execute API meghívásával. Alább talál egy példakérést az API-ra.

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

További lépések

Ez az oktatóanyag bemutatta, hogyan végezheti el az alábbi műveleteket:

Tulajdonosi jogkivonat lekérése a szolgáltatásnévhez
A kérelem formázása
A kérések végrehajtása egy hónapos adattömbökben

A költségek részleteiről további információt a Költségadatok adatainak betöltése című témakörben talál.

Ha többet szeretne megtudni arról, hogy milyen adatok érhetők el a költségadatok adathalmazában, olvassa el a Költség részletei adatmezők ismertetése című témakört.