Udostępnij za pośrednictwem

Pobieranie wszystkich informacji analitycznych dotyczących użycia platformy Azure

  • Artykuł

Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla Microsoft Cloud for US Government

Jak uzyskać wszystkie informacje analizy użycia platformy Azure dla klientów.

Wymagania wstępne

Żądanie REST

Składnia żądania

Metoda Identyfikator URI żądania
GET {baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

Parametry identyfikatora URI

Parametr Typ Opis
top (pierwsze) ciąg Liczba wierszy danych do zwrócenia w żądaniu. Wartość maksymalna i wartość domyślna, jeśli nie zostanie określona, to 10000. Jeśli w zapytaniu znajduje się więcej wierszy, treść odpowiedzi zawiera następny link, którego można użyć do żądania następnej strony danych.
Pomiń int Liczba wierszy do pominięcia w zapytaniu. Użyj tego parametru, aby stronicować za pośrednictwem dużych zestawów danych. Na przykład top=10000 and skip=0 pobiera pierwsze 10000 wierszy danych, top=10000 and skip=10000 pobiera kolejne 10000 wierszy danych itd.
filter ciąg Parametr filtru żądania zawiera jedną lub więcej instrukcji filtrujących wiersze w odpowiedzi. Każda instrukcja zawiera pole i wartość, które są skojarzone z operatorami eq lub ne , a instrukcje można łączyć przy użyciu instrukcji and lub or. Można określić następujące ciągi:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Przykład:
.../usage/azure?filter=meterCategory eq 'Data Management'

Przykład:
.../usage/azure?filter=meterCategory eq 'Data Management' or (usageDate le cast('2018-01-01', Edm.DateTimeOffset) and usageDate le cast('2018-04-01', Edm.DateTimeOffset))
aggregationLevel ciąg Określa zakres czasu, dla którego mają być pobierane zagregowane dane. Może to być jeden z następujących ciągów: day, weeklub month. Jeśli nie zostanie określona, wartość domyślna to day.

Parametr aggregationLevel nie jest obsługiwany bez .groupby Parametr aggregationLevel ma zastosowanie do wszystkich pól daty znajdujących się w obiekcie groupby.
Orderby ciąg Instrukcja, która porządkuje wartości danych wynikowych dla każdej instalacji. Składnia jest następująca: ...&orderby=field [order],field [order],... Parametr field może być jednym z następujących ciągów:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Parametr order jest opcjonalny i może być asc lub desc może określać kolejność rosnącą lub malejącą odpowiednio dla każdego pola. Wartość domyślna to asc.

Przykład:
...&orderby=meterCategory,meterUnit
Groupby ciąg Instrukcja, która stosuje agregację danych tylko do określonych pól. Możesz określić następujące pola:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Zwrócone wiersze danych będą zawierać pola określone w parametrze groupby i ilość.

Parametr groupby może być używany z parametrem aggregationLevel .

Przykład:
...&groupby=meterCategory,meterUnit

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Brak.

Przykład żądania

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/usage/azure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

Odpowiedź REST

W przypadku powodzenia treść odpowiedzi zawiera kolekcję zasobów użycia platformy Azure .

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie oraz dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów.

Przykład odpowiedzi

{
  "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "customerName": "A",
  "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
  "subscriptionName": "AZURE PURCHSE SAMPLE APP",
  "usageDate": "2018-05-27T00:00:00",
  "resourceLocation": "useast",
  "meterCategory": "Data Management",
  "meterSubcategory": "None",
  "meterUnit": "10,000s",
  "quantity": 20
}

Zobacz też