API zum Abrufen aller Datasets

Mit der API zum Abrufen aller Datasets werden alle verfügbaren Datasets abgerufen. Zu den Datasets gehören Tabellen, Spalten, Metriken und Zeitbereiche.

Anforderungssyntax

Methode Anforderungs-URI
GET https://api.partnercenter.microsoft.com/insights/v1/cmp/ScheduledDataset?datasetName={Dataset Name}

Anforderungsheader

Header Typ Beschreibung
Authorization Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken (Azure Active Directory) in der Form Bearer <token>.
Content-Type Zeichenfolge Application/JSON

Pfadparameter

Keine

Query parameter (Abfrageparameter)

Parametername Typ Erforderlich Beschreibung
datasetName string Nein Filter, um nur Details zu einem Dataset abzurufen

Anforderungsnutzlast

Keine

Glossar

Keine

Antwort

Die Antwortnutzdaten sind wie folgt strukturiert:

Antwortcode: 200, 400, 401, 403, 404, 500

Beispiel einer Antwortnutzlast:

{
   "Value":[
      {
         "DatasetName ":"string",
         "SelectableColumns":[
            "string"
         ],
         "AvailableMetrics":[
            "string"
         ],
         "AvailableDateRanges ":[
            "string"
         ]
      }
   ],
   "TotalCount":int,
   "Message":"<Error Message>",
   "StatusCode": int
}

Glossar

In dieser Tabelle werden die Schlüsselelemente in der Antwort definiert:

Parameter Beschreibung
DatasetName Name des Datasets, das von diesem Arrayobjekt definiert wird
SelectableColumns Rohspalten, die in den ausgewählten Spalten angegeben werden können
AvailableMetrics Spaltennamen von Aggregationen/Metriken, die in den ausgewählten Spalten angegeben werden können
AvailableDateRanges Datumsbereich, der in Berichtsabfragen für das Dataset verwendet werden kann
NextLink Link zur nächsten Seite, wenn die Daten auf mehrere Seiten verteilt sind
TotalCount Anzahl von Datasets im Wertarray
StatusCode Ergebniscode. Die möglichen Werte sind 200, 400, 401, 403, 500.