Query - Resource Execute

Referensi

Layanan:: Log Analytics

Versi API:: 2022-10-27_Preview

Menjalankan kueri Analytics menggunakan ID sumber daya
Menjalankan kueri Analytics untuk data dalam konteks sumber daya. Berikut adalah contoh untuk menggunakan POST dengan kueri Analytics.

POST https://api.loganalytics.io/v1/{resourceId}/query

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
resourceId	path	True	string	Pengidentifikasi sumber daya.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
Prefer		string	Pilihan. Header pilihan untuk mengatur batas waktu server, statistik kueri, dan informasi visualisasi.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
query	True	string	Kueri yang akan dijalankan.
timespan		string	Pilihan. Rentang waktu untuk mengkueri data. Ini adalah nilai periode waktu ISO8601. Rentang waktu ini diterapkan selain yang ditentukan dalam ekspresi kueri.
workspaces		string[]	Daftar ruang kerja yang disertakan dalam kueri.

Respons

Nama	Jenis	Deskripsi
200 OK	queryResults	OK. Panggilan API berhasil dan hasil kueri Analytics berada dalam payload respons
Other Status Codes	errorResponse	Objek respons kesalahan.

Keamanan

oauth2

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

simple-query

Permintaan sampel

HTTP

POST https://api.loganalytics.io/v1//subscriptions/fffa080af-c2d8-40ad-9cce-e1a450bawb57/resourceGroups/test-resourcegroup/providers/Microsoft.Storage/storageAccounts/storageaccountname/query

{
  "query": "StorageBlobLogs | summarize count() by OperationName | top 10 by count_ desc",
  "timespan": "PT24H"
}

Respon sampel

Kode status:: 200

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "OperationName",
          "type": "string"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "operation1",
          "10"
        ]
      ]
    }
  ]
}

Definisi

Nama	Deskripsi
column	Kolom tabel.
errorDetail	Detail kesalahan.
errorInfo	Kode dan pesan untuk kesalahan.
errorResponse	Detail kesalahan.
logsColumnType	Jenis data kolom ini.
queryBody	Kueri Analitik. Pelajari selengkapnya tentang sintaks kueri Analytics
queryResults	Respons kueri.
Render	Data visualisasi dalam format JSON.
Statistics	Statistik yang diwakili dalam format JSON.
table	Tabel respons kueri.

column

Kolom tabel.

Nama	Jenis	Deskripsi
name	string	Nama kolom ini.
type	logsColumnType	Jenis data kolom ini.

errorDetail

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalProperties	object	Properti tambahan yang dapat disediakan pada objek detail kesalahan
code	string	Kode kesalahan.
message	string	Pesan kesalahan yang dapat dibaca manusia.
resources	string[]	Menunjukkan sumber daya yang bertanggung jawab atas kesalahan tersebut.
target	string	Menunjukkan properti mana dalam permintaan yang bertanggung jawab atas kesalahan tersebut.
value	string	Menunjukkan nilai mana dalam 'target' yang bertanggung jawab atas kesalahan tersebut.

errorInfo

Kode dan pesan untuk kesalahan.

Nama	Jenis	Deskripsi
additionalProperties	object	Properti tambahan yang dapat disediakan pada objek info kesalahan
code	string	Kode kesalahan yang dapat dibaca mesin.
details	errorDetail[]	detail kesalahan.
innererror	errorInfo	Kode dan pesan untuk kesalahan. Detail kesalahan dalam jika ada.
message	string	Pesan kesalahan yang dapat dibaca manusia.

errorResponse

Detail kesalahan.

Nama	Jenis	Deskripsi
error	errorInfo	Kode dan pesan untuk kesalahan. Detail kesalahan.

logsColumnType

Jenis data kolom ini.

Nama	Jenis	Deskripsi
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryBody

Kueri Analitik. Pelajari selengkapnya tentang sintaks kueri Analytics

Nama	Jenis	Deskripsi
query	string	Kueri yang akan dijalankan.
timespan	string	Pilihan. Rentang waktu untuk mengkueri data. Ini adalah nilai periode waktu ISO8601. Rentang waktu ini diterapkan selain yang ditentukan dalam ekspresi kueri.
workspaces	string[]	Daftar ruang kerja yang disertakan dalam kueri.

queryResults

Respons kueri.

Nama	Jenis	Deskripsi
error	errorInfo	Kode dan pesan untuk kesalahan.
render	Render	Data visualisasi dalam format JSON.
statistics	Statistics	Statistik yang diwakili dalam format JSON.
tables	table[]	Daftar tabel, kolom, dan baris.

Render

Data visualisasi dalam format JSON.

Statistics

Statistik yang diwakili dalam format JSON.

table

Tabel respons kueri.

Nama	Jenis	Deskripsi
columns	column[]	Daftar kolom dalam tabel ini.
name	string	Nama tabel.
rows	object[]	Baris yang dihasilkan dari kueri ini.

Bagikan melalui