Freigeben über


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