Udostępnij za pośrednictwem

Poradnik: Inicjowanie historycznego zestawu danych kosztów za pomocą API eksportu

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 potrzebujesz sposobu na niezawodne pozyskiwanie danych, aby móc załadować je do magazynu danych, w którym można wykonywać zapytania. Po zainicjowaniu historycznego zestawu danych o kosztach, magazyn danych może być aktualizowany, gdy pojawiają się nowe koszty, co pozwala na bieżące utrzymywanie aktualności raportów. Koszty historyczne rzadko się zmieniają, a jeśli tak, otrzymasz powiadomienie. Dlatego zalecamy, aby zaktualizować dane dotyczące kosztów historycznych nie więcej niż raz w miesiącu.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

  • Uzyskiwanie tokenu dostępu dla głównej jednostki usługi
  • Formatowanie żądania
  • Wykonywanie żądań w fragmentach z 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.

Ponadto potrzebny jest sposób bezpośredniego wykonywania zapytań względem interfejsu API. Oto kilka popularnych sposobów wykonywania zapytań dotyczących interfejsu API:

Uzyskiwanie tokenu elementu nośnego dla jednostki usługi

Aby dowiedzieć się, jak uzyskać token typu bearer za pomocą podstawowej 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. Poniższe 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 skonfigurowanie partitionData = true eksportu jednokrotnego, aby podzielić dane 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 fragmentach z jednego miesiąca

Zalecamy tworzenie jednorazowych eksportów danych obejmujących okresy jednego miesiąca. Jeśli chcesz zainicjować roczny zestaw danych historycznych, powinieneś wykonać 12 żądań Exports API — po jednym na każdy miesiąc. Po utworzeniu 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.

Uruchom każdy eksport

Po utworzeniu eksportu dla każdego miesiąca należy ręcznie uruchomić każdy, wywołując interfejs API Execute . Oto 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 tym samouczku zawarto informacje na temat wykonywania następujących czynności:

  • Uzyskiwanie tokenu nosiciela dla głównego użytkownika usługi
  • Formatowanie żądania
  • Wykonywanie żądań w fragmentach z jednego miesiąca

Aby dowiedzieć się więcej na temat szczegółów kosztów, zobacz szczegóły 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.