Testen der Berichtsabfrage-API für den kommerziellen Marketplace
Diese API führt eine Berichtsabfrageanweisung aus. Die API gibt nur 10 Datensätze zurück, die Sie als Partner verwenden können, um zu überprüfen, ob die Daten den Erwartungen entsprechen.
Wichtig
Das Timeout für die Abfrageausführung beträgt bei dieser API 100 Sekunden. Wenn Sie bemerken, dass die API-Ausführung länger als 100 Sekunden dauert, ist die Abfrage sehr wahrscheinlich syntaktisch korrekt, da Sie andernfalls einen anderen Fehlercode als 200 erhalten. Die tatsächliche Berichterstellung gilt als bestanden, wenn die Abfragesyntax korrekt ist.
Anforderungssyntax
Methode | Anforderungs-URI |
---|---|
GET | https://api.partnercenter.microsoft.com/insights/v1.1/cmp/ScheduledQueries/testQueryResult?exportQuery={query text} |
Anforderungsheader
Übergeordnet | Typ | Beschreibung |
---|---|---|
Autorisierung | Zeichenfolge | Erforderlich. Das Microsoft Entra-Zugriffstoken im Formular Bearer <token> |
Content-Type | Zeichenfolge | Application/JSON |
QueryParameter
Parametername | Typ | Beschreibung |
---|---|---|
exportQuery |
string | Berichtsabfragezeichenfolge, die ausgeführt werden soll |
queryId |
Zeichenfolge | Eine gültige vorhandene Abfrage-ID |
Pfadparameter
Keine
Anforderungsnutzdaten
Keine
Glossar
Keine
Antwort
Die Antwortnutzdaten sind wie folgt strukturiert:
Antwortcode: 200, 400, 401, 403, 404, 500
Antwortnutzdaten: erste 10 Zeilen der Abfrageausführung