Megosztás a következőn keresztül:

Az összes Azure-beli használatelemzési adat lekérése

  • Cikk

A következőre vonatkozik: Partnerközpont | A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont Microsoft Cloud for US Government

Hogyan szerezheti be az összes Azure-használati elemzési információt az ügyfelek számára.

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak a felhasználói hitelesítő adatokkal való hitelesítést támogatja.

REST-kérelem

Kérés szintaxisa

Metódus Kérés URI-ja
GET {baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

URI-paraméterek

Paraméter Típus Leírás
top sztring A kérelemben visszaadandó adatsorok száma. A maximális érték és az alapértelmezett érték, ha nincs megadva, 10000. Ha a lekérdezés több sort tartalmaz, a válasz törzse tartalmaz egy következő hivatkozást, amellyel lekérheti a következő adatoldalt.
Ugrál int A lekérdezésben kihagyandó sorok száma. Ezzel a paramétersel nagy adatkészleteken haladhat végig. Lekéri például top=10000 and skip=0 az első 10000 adatsort, top=10000 and skip=10000 lekéri a következő 10000 adatsort stb.
filter (szűrő) sztring A kérelem szűrőparamétere egy vagy több utasítást tartalmaz, amelyek a válasz sorait szűrik. Minden utasítás tartalmaz egy mezőt és egy értéket, amely a vagy operátorokhoz eq van társítva, és az utasítások kombinálhatók a vagy ora használatávaland.ne A következő sztringeket adhatja meg:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Példa
.../usage/azure?filter=meterCategory eq 'Data Management'

Példa
.../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 sztring Meghatározza az összesített adatok lekérésének időtartományát. A következő sztringek egyike lehet: day, weekvagy month. Ha nincs meghatározva, az alapértelmezett érték a .day

A aggregationLevel paraméter nem támogatott groupby. A aggregationLevel paraméter a fájlban groupbytalálható összes dátummezőre vonatkozik.
orderby sztring Egy utasítás, amely az egyes telepítések eredményadat-értékeit rendeli meg. A szintaxis a következő: ...&orderby=field [order],field [order],.... A field paraméter a következő sztringek egyike lehet:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


A rendelés paramétere nem kötelező, és ascdesc az egyes mezőkhöz megadhat növekvő vagy csökkenő sorrendet. A mező alapértelmezett értéke: asc.

Példa
...&orderby=meterCategory,meterUnit
groupby sztring Egy utasítás, amely csak a megadott mezőkre alkalmazza az adatösszesítést. A következő mezőket adhatja meg:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


A visszaadott adatsorok tartalmazzák a paraméterben és a groupbyMennyiségben megadott mezőket.

A groupby paraméter használható a aggregationLevel paraméterrel.

Példa
...&groupby=meterCategory,meterUnit

Kérésfejlécek

További információ: Partnerközpont REST-fejlécei.

A kérés törzse

Nincsenek.

Példa kérésre

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

REST-válasz

Ha sikeres, a válasz törzse Azure-használati erőforrások gyűjteményét tartalmazza.

Sikeres válasz és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. Használja a hálózati nyomkövetési eszközt a kód, a hibatípus és a további paraméterek olvasásához. A teljes listát lásd: Hibakódok.

Példa válaszra

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

Lásd még