Jelentés-lekérdezések API kipróbálás

Ez az API egy jelentés lekérdezési utasítást hajt végre. Az API csak 100 rekordot ad vissza, amelyekkel Ön partnerként ellenőrizheti, hogy az adatok a vártnak megfelelően működnek-e.

Fontos

Ez az API 100 másodperces lekérdezés-végrehajtási időtúllépéssel rendelkezik. Ha azt tapasztalja, hogy az API több mint 100 másodpercet vesz igénybe, nagy valószínűséggel a lekérdezés szintaktikailag helyes, vagy ha 200-tól eltérő hibakódot kapott volna. Ha a lekérdezés szintaxisa helyes, a tényleges jelentéslétrehozás sikeres lesz.

Kérés szintaxisa

Módszer	URI kérése
KAP	https://api.partnercenter.microsoft.com/insights/v1/mpn/ScheduledQueries/testQueryResult?<exportQuery={querytext}\|queryId={queryId}>

Kérelem fejléce

Fejléc	Típus	Leírás
Felhatalmazás	húr	Szükséges. A Microsoft Entra hozzáférési jogkivonata az űrlapon Bearer <token>
Tartalomtípus	húr	Application/JSON

Elérési út paramétere

Egyik sem

Lekérdezési paraméter

Paraméter neve	Típus	Szükséges	Leírás
exportQuery	húr	Nem	Végrehajtandó jelentés lekérdezési sztringje
queryId	húr	Nem	Érvényes meglévő lekérdezésazonosító. Kölcsönösen kizárja az exportQuery paraméterben megadott lekérdezési sztringet
startTime	húr	Nem	Kezdési időpont, ahonnan az adatokat szeretnénk. Felülbírálja a lekérdezésben megadott időbélyeget
endTime	húr	Nem	A befejezési idő, ameddig az adatokat szeretnénk. Felülbírálja a lekérdezésben megadott időbélyeget

Hasznos adatok kérése

Egyik sem

Szószedet kérése

Egyik sem

Válasz

A válasz hasznos adatai a következőképpen épülnek fel:

Válaszkód: 200, 400, 401, 403, 404, 500

Példa válasz hasznos adatra:

Top 100 rows of query execution
{
  "Value": [
    {
    }
  ],
  "TotalCount": 0,
  "Message": "string",
  "StatusCode": 0,
}

Válaszszószedet

Ez a táblázat határozza meg a válasz főbb elemeit:

Paraméter	Leírás
TotalCount	Adathalmazok száma az Érték tömbben
Üzenet	Állapotüzenet az API végrehajtásából
StatusCode	Eredménykód. A lehetséges értékek: 200, 400, 401, 403, 500