Vyzkoušet rozhraní API dotazů sestav

Toto rozhraní API spustí příkaz dotazu sestavy. Rozhraní API vrátí pouze 100 záznamů, které jste jako partneři mohli použít k ověření, zda data jsou podle očekávání.

Důležité

Toto rozhraní API má časový limit spuštění dotazu 100 sekund. Pokud si všimnete, že rozhraní API trvá déle než 100 sekund, je velmi vhodné, aby dotaz byl syntakticky správný nebo jinak byl obdržen chybový kód jiný než 200. Pokud je syntaxe dotazu správná, vytvoří se skutečná generace sestavy.

Syntaxe žádosti

Metoda Identifikátor URI žádosti
GET https://api.partnercenter.microsoft.com/insights/v1/mpn/ScheduledQueries/testQueryResult?<exportQuery={query text}|queryId={queryId}>

Hlavička žádosti

Hlavička Typ Description
Autorizace řetězec Povinná hodnota. přístupový token pro Azure Active Directory (AAD) ve formulářiBearer <token>
Typ obsahu řetězec Application/JSON

Parametr cesty

Žádné

Parametr dotazu

Název parametru Typ Vyžadováno Popis
exportQuery řetězec No Řetězec dotazu sestavy, který musí být proveden
queryId řetězec No Platné existující ID dotazu. Vzájemně neexkluzivní s řetězcem dotazu zadaným v parametru exportQuery
startTime řetězec No Čas spuštění, ze kterého chceme data. Přepíše časový interval zadaný v dotazu.
endTime řetězec No Čas ukončení, na který se mají data pospat Přepíše časový interval zadaný v dotazu.

Datová část požadavku

Žádné

Glosář

Žádné

Response (Odpověď)

Datová část odpovědi je strukturována takto:

Kód odpovědi: 200, 400, 401, 403, 404, 500

Příklad datové části odpovědi:

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

Glosář

Tato tabulka definuje klíčové prvky v odpovědi:

Parametr Popis
TotalCount Počet datových sad v poli hodnot
Zpráva Stavová zpráva od spuštění rozhraní API
StatusCode Kód výsledku. Možné hodnoty jsou 200, 400, 401, 403, 500