Udostępnij za pośrednictwem

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

  • Artykuł

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 zainicjowaniu historycznego zestawu danych kosztów magazyn danych może zostać zaktualizowany, gdy pojawią 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.

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

  • Uzyskiwanie tokenu elementu nośnego dla 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 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. 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 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 fragmentach z jednego miesiąca

Zalecamy utworzenie 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 — jeden 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.

Uruchamianie każdego eksportu

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 elementu nośnego dla jednostki usługi
  • Formatowanie żądania
  • Wykonywanie żądań w fragmentach z jednego miesiąca

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