Dela via

Hämta all information om Azure-användningsanalys

  • Artikel

Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Så här hämtar du all information om Azure-användningsanalys för dina kunder.

Förutsättningar

  • Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med användarautentiseringsuppgifter.

REST-begäran

Begärandesyntax

Metod URI för förfrågan
GET {baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

URI-parametrar

Parameter Typ Description
top sträng Antalet rader med data som ska returneras i begäran. Maxvärdet och standardvärdet om det inte anges är 10000. Om det finns fler rader i frågan innehåller svarstexten en nästa länk som du kan använda för att begära nästa sida med data.
hoppa över int Antalet rader som ska hoppas över i frågan. Använd den här parametern för att bläddra igenom stora datamängder. Hämtar till exempel top=10000 and skip=0 de första 1 0000 raderna med data, top=10000 and skip=10000 hämtar de följande 1 0000 raderna med data och så vidare.
filter sträng Filterparametern för begäran innehåller en eller flera instruktioner som filtrerar raderna i svaret. Varje instruktion innehåller ett fält och ett värde som är associerade med operatorerna eq eller och -instruktioner kan kombineras med eller andorne . Du kan ange följande strängar:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Exempel:
.../usage/azure?filter=meterCategory eq 'Data Management'

Exempel:
.../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 sträng Anger det tidsintervall som aggregerade data ska hämtas för. Kan vara en av följande strängar: day, weekeller month. Om det är ospecificerat är daystandardvärdet .

Parametern aggregationLevel stöds inte utan en groupby. Parametern aggregationLevel gäller för alla datumfält som finns i groupby.
Orderby sträng En instruktion som beställer resultatdatavärdena för varje installation. Syntax: ...&orderby=field [order],field [order],.... Parametern field kan vara en av följande strängar:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Orderparametern är valfri och kan vara asc eller desc för att ange stigande eller fallande ordning för varje fält. Standardvärdet är asc.

Exempel:
...&orderby=meterCategory,meterUnit
groupby sträng En instruktion som endast tillämpar dataaggregering på de angivna fälten. Du kan ange följande fält:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


De returnerade dataraderna innehåller de fält som anges i parametern groupby och Quantity.

Parametern groupby kan användas med parametern aggregationLevel .

Exempel:
...&groupby=meterCategory,meterUnit

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Inga.

Exempel på begäran

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-svar

Om åtgärden lyckas innehåller svarstexten en samling Azure-användningsresurser .

Lyckade svar och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckat eller misslyckat och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder.

Exempel på svar

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

Se även