Query - Resource Execute

Başvuru

Hizmet:: Log Analytics

API Sürümü:: 2022-10-27_Preview

Kaynak kimliğini kullanarak Analiz sorgusu yürütme
Bir kaynak bağlamında veriler için bir Analytics sorgusu yürütür. Post'un Bir Analytics sorgusuyla kullanılmasına yönelik bir örnek aşağıda verilmiştir.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceId	path	True	string	Kaynağın tanımlayıcısı.

İstek Başlığı

Name	Gerekli	Tür	Description
Prefer		string	İsteğe bağlı. Sunucu zaman aşımını, sorgu istatistiklerini ve görselleştirme bilgilerini ayarlamak için tercih üst bilgisi.

İstek Gövdesi

Name	Gerekli	Tür	Description
query	True	string	Yürütülecek sorgu.
timespan		string	İsteğe bağlı. Verilerin sorgulandığı zaman aralığı. Bu bir ISO8601 zaman aralığı değeridir. Bu zaman aralığı, sorgu ifadesinde belirtilenlere ek olarak uygulanır.
workspaces		string[]	Sorguya dahil edilen çalışma alanlarının listesi.

Yanıtlar

Name	Tür	Description
200 OK	queryResults	Tamam ögesini seçin. API çağrısı başarılı oldu ve Analytics sorgu sonucu yanıt yükünde
Other Status Codes	errorResponse	Hata yanıtı nesnesi.

Güvenlik

oauth2

Azure Active Directory OAuth2 Flow

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

simple-query

Örnek isteği

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"
}

Örnek yanıt

Durum kodu:: 200

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

Tanımlar

Name	Description
column	Tablo sütunu.
errorDetail	Hata ayrıntıları.
errorInfo	Hatanın kodu ve iletisi.
errorResponse	Hata ayrıntıları.
logsColumnType	Bu sütunun veri türü.
queryBody	Analytics sorgusu. Analiz sorgusu söz dizimi hakkında daha fazla bilgi edinin
queryResults	Sorgu yanıtı.
Render	Görselleştirme verileri JSON biçimindedir.
Statistics	JSON biçiminde temsil edilen istatistikler.
table	Sorgu yanıt tablosu.

column

Tablo sütunu.

Name	Tür	Description
name	string	Bu sütunun adı.
type	logsColumnType	Bu sütunun veri türü.

errorDetail

Hata ayrıntıları.

Name	Tür	Description
additionalProperties	object	Hata ayrıntıları nesnesinde sağlanabilir ek özellikler
code	string	Hatanın kodu.
message	string	okunabilir bir hata iletisi.
resources	string[]	Hatadan sorumlu kaynakları gösterir.
target	string	İstekteki hangi özelliğin hatadan sorumlu olduğunu gösterir.
value	string	Hatadan 'target' içindeki hangi değerin sorumlu olduğunu gösterir.

errorInfo

Hatanın kodu ve iletisi.

Name	Tür	Description
additionalProperties	object	Hata bilgisi nesnesinde sağlanabilir ek özellikler
code	string	Makine okunabilir hata kodu.
details	errorDetail[]	hata ayrıntıları.
innererror	errorInfo	Hatanın kodu ve iletisi. Varsa iç hata ayrıntıları.
message	string	okunabilir bir hata iletisi.

errorResponse

Hata ayrıntıları.

Name	Tür	Description
error	errorInfo	Hatanın kodu ve iletisi. Hata ayrıntıları.

logsColumnType

Bu sütunun veri türü.

Name	Tür	Description
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryBody

Analytics sorgusu. Analiz sorgusu söz dizimi hakkında daha fazla bilgi edinin

Name	Tür	Description
query	string	Yürütülecek sorgu.
timespan	string	İsteğe bağlı. Verilerin sorgulandığı zaman aralığı. Bu bir ISO8601 zaman aralığı değeridir. Bu zaman aralığı, sorgu ifadesinde belirtilenlere ek olarak uygulanır.
workspaces	string[]	Sorguya dahil edilen çalışma alanlarının listesi.

queryResults

Sorgu yanıtı.

Name	Tür	Description
error	errorInfo	Hatanın kodu ve iletisi.
render	Render	Görselleştirme verileri JSON biçimindedir.
statistics	Statistics	JSON biçiminde temsil edilen istatistikler.
tables	table[]	Tablo, sütun ve satır listesi.

Render

Görselleştirme verileri JSON biçimindedir.

Statistics

JSON biçiminde temsil edilen istatistikler.

table

Sorgu yanıt tablosu.

Name	Tür	Description
columns	column[]	Bu tablodaki sütunların listesi.
name	string	Tablonun adı.
rows	object[]	Bu sorgudan elde edilen satırlar.

Aracılığıyla paylaş