Coba API kueri laporan

API ini menjalankan pernyataan kueri Laporan. API hanya mengembalikan 100 rekaman yang dapat Anda gunakan sebagai mitra untuk memverifikasi apakah data sesuai harapan Anda.

Penting

API ini memiliki batas waktu eksekusi kueri 100 detik. Jika Anda melihat API membutuhkan waktu lebih dari 100 detik, kemungkinan besar kueri benar secara sintetis atau jika tidak, Anda akan menerima kode kesalahan selain 200. Pembuatan laporan aktual akan lulus jika sintaks kueri benar.

Sintaks permintaan

Metode	Meminta URI
DAPAT	https://api.partnercenter.microsoft.com/insights/v1/mpn/ScheduledQueries/testQueryResult?<exportQuery={querytext}\|queryId={queryId}>

Header permintaan

Header	Jenis	Deskripsi
Otorisasi	tali	Diperlukan. Token akses Microsoft Entra dalam formulir Bearer <token>
Tipe Isi	tali	Application/JSON

Parameter jalur

Tidak

Parameter kueri

Nama Parameter	Jenis	Diperlukan	Deskripsi
exportQuery	tali	Tidak	Laporkan string kueri yang perlu dijalankan
queryId	tali	Tidak	ID kueri yang sudah ada yang valid. Saling eksklusif dengan string kueri yang ditentukan dalam parameter exportQuery
startTime	tali	Tidak	Waktu mulai dari mana kita menginginkan data. Ini mengesampingkan rentang waktu yang ditentukan dalam kueri
endTime	tali	Tidak	Waktu selesai sampai kita menginginkan data. Ini mengesampingkan rentang waktu yang ditentukan dalam kueri

Meminta payload

Tidak

Meminta glosarium

Tidak

Jawaban

Payload respons disusun sebagai berikut:

Kode respons: 200, 400, 401, 403, 404, 500

Contoh payload respons:

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

Glosarium respons

Tabel ini menentukan elemen kunci dalam respons:

Parameter	Deskripsi
TotalCount	Jumlah himpunan data dalam array Nilai
Pesan	Pesan status dari eksekusi API
StatusCode	Kode Hasil. Nilai yang mungkin adalah 200, 400, 401, 403, 500