Získání všech analytických informací o využití Azure

  • Článek

Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud for US Government

Jak získat všechny informace o analýze využití Azure pro vaše zákazníky.

Požadavky

Požadavek REST

Syntaxe požadavku

Metoda Identifikátor URI žádosti
GET {baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

Parametry identifikátoru URI

Parametr Typ Description
top řetězec Počet řádků dat, které se mají vrátit v požadavku. Maximální hodnota a výchozí hodnota, pokud není zadána, je 10000. Pokud je v dotazu více řádků, tělo odpovědi obsahuje další odkaz, který můžete použít k vyžádání další stránky dat.
Přeskočit int Počet řádků, které se mají v dotazu přeskočit. Pomocí tohoto parametru můžete procházet velké datové sady. Například top=10000 and skip=0 načte prvních 10000 řádků dat, top=10000 and skip=10000 načte dalších 10000 řádků dat atd.
filter řetězec Parametr filter požadavku obsahuje jeden nebo více příkazů, které filtrují řádky v odpovědi. Každý příkaz obsahuje pole a hodnotu, které jsou přidruženy k operátorům eq nebo ne a příkazy lze kombinovat pomocí nebo andor. Můžete zadat následující řetězce:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Příklad:
.../usage/azure?filter=meterCategory eq 'Data Management'

Příklad:
.../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 řetězec Určuje časový rozsah, pro který se mají načíst agregovaná data. Může to být jeden z následujících řetězců: day, weeknebo month. Pokud není zadáno, výchozí hodnota je day.

Parametr aggregationLevel není podporován bez parametru groupby. Parametr aggregationLevel platí pro všechna pole kalendářních dat, která jsou v souboru groupby.
Orderby řetězec Příkaz, který seřídí hodnoty výsledných dat pro každou instalaci. Syntaxe je ...&orderby=field [order],field [order],.... Parametr field může být jeden z následujících řetězců:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Parametr order je volitelný a pro každé pole můžete ascdesc zadat vzestupné nebo sestupné pořadí. Výchozí formát je asc.

Příklad:
...&orderby=meterCategory,meterUnit
Groupby řetězec Příkaz, který použije agregaci dat pouze na zadaná pole. Můžete zadat následující pole:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Vrácené řádky dat budou obsahovat pole zadaná v parametru groupby a množství.

Parametr groupby lze použít s parametrem aggregationLevel .

Příklad:
...&groupby=meterCategory,meterUnit

Hlavičky požadavku

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Žádné

Příklad požadavku

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

Odpověď REST

V případě úspěchu obsahuje text odpovědi kolekci prostředků využití Azure .

Kódy úspěšných odpovědí a chyb

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání, a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi

{
  "customerTenantId": "39A1DFAC-4969-4F31-AF94-D76588189CFE",
  "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
}

Viz také