Samouczek: rozmieszczanie historycznego zestawu danych kosztów za pomocą interfejsu API eksportów

Artykuł
11/17/2023

Duże organizacje często muszą analizować swoje historyczne koszty co najmniej rok. Tworzenie zestawu danych może być konieczne w przypadku ukierunkowanych jednorazowych zapytań lub skonfigurowania pulpitów nawigacyjnych raportowania w celu wizualizacji trendów kosztów w czasie. W obu przypadkach potrzebny jest sposób niezawodnego pobierania danych, aby można było załadować je do magazynu danych, który można wykonywać zapytania. Po wprowadzeniu historycznego zestawu danych kosztów magazyn danych może zostać zaktualizowany w miarę, jak pojawiają się nowe koszty, dzięki czemu raportowanie jest aktualne. Koszty historyczne rzadko się zmieniają, a jeśli tak, otrzymasz powiadomienie. Dlatego zalecamy odświeżenie historycznych kosztów nie więcej niż raz w miesiącu.

Ten samouczek zawiera informacje na temat wykonywania następujących czynności:

Uzyskiwanie tokenu elementu nośnego dla jednostki usługi
Formatowanie żądania
Wykonywanie żądań we fragmentach w ciągu jednego miesiąca

Wymagania wstępne

Do pomyślnego wywołania interfejsu API eksportów potrzebne są odpowiednie uprawnienia. Zalecamy używanie jednostki usługi w scenariuszach automatyzacji.

Aby dowiedzieć się więcej, zobacz Przypisywanie uprawnień do interfejsów API usługi Cost Management.
Aby dowiedzieć się więcej o określonych uprawnieniach wymaganych dla interfejsu API eksportów, zobacz Omówienie zakresów i praca z tym zakresami.

Ponadto potrzebny jest sposób bezpośredniego wykonywania zapytań względem interfejsu API. W tym samouczku zalecamy używanie narzędzia PostMan.

Uzyskiwanie tokenu elementu nośnego dla jednostki usługi

Aby dowiedzieć się, jak uzyskać token elementu nośnego za pomocą jednostki usługi, zobacz Uzyskiwanie tokenu dostępu.

Formatowanie żądania

Zapoznaj się z poniższym przykładowym żądaniem i utwórz własne jednorazowe eksportowanie danych. Następujące przykładowe żądanie tworzy miesięczny zestaw danych kosztu rzeczywistego na określonym koncie usługi Azure Storage. Zalecamy zażądanie nie więcej niż jednego miesiąca danych na raport. Jeśli co miesiąc masz duży zestaw danych, zalecamy ustawienie partitionData = true jednorazowego eksportu, aby podzielić go na wiele plików. Aby uzyskać więcej informacji, zobacz Partycjonowanie plików dla dużych zestawów danych.

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

Nagłówki żądań

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

Treść żądania

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

Tworzenie eksportów w miesięcznych fragmentach

Zalecamy tworzenie jednorazowych eksportów danych w ciągu jednego miesiąca. Jeśli chcesz zainicjować roczny zestaw danych historycznych, należy wykonać 12 żądań interfejsu API eksportów — po jednym dla każdego miesiąca. Po zainicjowaniu historycznego zestawu danych możesz utworzyć zaplanowany eksport, aby kontynuować wypełnianie danych kosztów w usłudze Azure Storage w miarę naliczania opłat w miarę upływu czasu.

Uruchamianie każdego eksportu

Po utworzeniu eksportu dla każdego miesiąca należy ręcznie uruchomić każdy z nich przez wywołanie interfejsu API wykonywania. Poniżej znajduje się przykładowe żądanie do interfejsu API.

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

Następne kroki

W niniejszym samouczku zawarto informacje na temat wykonywania następujących czynności:

Uzyskiwanie tokenu elementu nośnego dla jednostki usługi
Formatowanie żądania
Wykonywanie żądań we fragmentach w ciągu jednego miesiąca

Aby dowiedzieć się więcej o szczegółach kosztów, zobacz pozyskiwanie danych dotyczących kosztów.

Aby dowiedzieć się więcej o tym, jakie dane są dostępne w zestawie danych szczegółów kosztów, zobacz Omówienie pól danych szczegółów kosztów.

Share via