Abrufen aller Informationen zur Azure-Nutzungsanalyse

Artikel
05/28/2024

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 `or`kombiniert 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`, `week`oder `month`. Wenn keine Angabe erfolgt, lautet der Standardwert `day`. Der `aggregationLevel` Parameter wird ohne `groupby`nicht unterstützt. Der `aggregationLevel` Parameter gilt für alle Datumsfelder, die in vorhanden `groupby`sind.
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 bzw`desc`. sein`asc`, 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": "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
}

Weitere Informationen

Partner Center Analytics – Ressourcen

Teilen über