Abrufen aller Informationen zur Azure-Nutzungsanalyse

  • Artikel

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

Hier erfahren Sie, wie Sie alle Informationen zur Azure-Nutzungsanalyse für Ihre Kunden abrufen.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt nur die Authentifizierung mit Benutzeranmeldeinformationen.

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET {baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

URI-Parameter

Parameter Typ BESCHREIBUNG
top Zeichenfolge Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Maximal- und Standardwert ist 10.000, wenn nicht anders angegeben. Sind in der Abfrage keine weiteren Zeilen, enthält der Antworttext den Link „Weiter“, über den Sie die nächste Seite mit Daten anfordern können.
skip INT Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datensätze durchzublättern. Ruft beispielsweise top=10000 and skip=0 die ersten 10.000 Datenzeilen ab, top=10000 and skip=10000 ruft die nächsten 10.000 Datenzeilen ab usw.
filter Zeichenfolge Der Parameter filter der Anforderung enthält mindestens eine Anweisung, die die Zeilen in der Antwort filtert. Jede Anweisung enthält ein Feld und einen Wert, die den eq Operatoren oder zugeordnet ne sind, und Anweisungen können mit and oder orkombiniert werden. Sie können die folgenden Zeichenfolgen angeben:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


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

Beispiel:
.../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 Zeichenfolge Gibt den Zeitraum an, für den aggregierte Daten abgerufen werden sollen. Kann eine der folgenden Zeichenfolgen sein: day, weekoder month. Wenn keine Angabe erfolgt, lautet der Standardwert day.

Der aggregationLevel Parameter wird ohne groupbynicht unterstützt. Der aggregationLevel Parameter gilt für alle Datumsfelder, die in vorhanden groupbysind.
orderby Zeichenfolge Eine Anweisung, die die Ergebnisdatenwerte für jede Installation anordnet. Die Syntax ist ...&orderby=field [order],field [order],.... Der field Parameter kann eine der folgenden Zeichenfolgen sein:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Der Order-Parameter ist optional und kann bzwdesc. seinasc, um aufsteigende oder absteigende Reihenfolge für jedes Feld anzugeben. Der Standardwert ist asc.

Beispiel:
...&orderby=meterCategory,meterUnit
groupby Zeichenfolge Eine Anweisung, die nur auf die angegebenen Felder Datenaggregationen anwendet. Sie können die folgenden Felder angeben:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Die zurückgegebenen Datenzeilen enthalten die felder, die groupby im Parameter und in der Menge angegeben sind.

Der groupby Parameter kann mit dem aggregationLevel Parameter verwendet werden.

Beispiel:
...&groupby=meterCategory,meterUnit

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Anforderungsbeispiel

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

Bei erfolgreicher Ausführung enthält der Antworttext eine Sammlung von Azure-Nutzungsressourcen .

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Antwortbeispiel

{
  "customerTenantId": "39A1DFAC-4969-4F31-AF94-D76588189CFE",
  "customerName": "A",
  "subscriptionId": "EC649980-D623-49F5-B7C1-80CC772B83A8",
  "subscriptionName": "AZURE PURCHSE SAMPLE APP",
  "usageDate": "2018-05-27T00:00:00",
  "resourceLocation": "useast",
  "meterCategory": "Data Management",
  "meterSubcategory": "None",
  "meterUnit": "10,000s",
  "quantity": 20
}

Weitere Informationen