Query - Resource Execute

Szolgáltatás:

Log Analytics

API-verzió:

2022-10-27_Preview

Elemzési lekérdezés végrehajtása erőforrás-azonosító használatával
Elemzési lekérdezést hajt végre egy erőforrás kontextusában lévő adatokhoz. Itt példa a POST analyticses lekérdezéssel való használatára.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceId	path	True	string	Az erőforrás azonosítója.

Kérelem fejléce

Name	Kötelező	Típus	Description
Prefer		string	Opcionális. A kiszolgáló időtúllépésének, a lekérdezési statisztikáknak és a vizualizációs adatoknak a beállításához előnyben részesítő fejléc.

Kérelem törzse

Name	Kötelező	Típus	Description
query	True	string	A végrehajtandó lekérdezés.
timespan		string	Opcionális. Az adatok lekérdezésének időkerete. Ez egy ISO8601 időszak értéke. Ezt az időbélyeget a lekérdezési kifejezésben megadottakon kívül alkalmazza a rendszer.
workspaces		string[]	A lekérdezésben szereplő munkaterületek listája.

Válaszok

Name	Típus	Description
200 OK	queryResults	OKÉ. Az API-hívás sikeres volt, és az Analytics-lekérdezés eredménye a válasz hasznos adatai között van
Other Status Codes	errorResponse	Hibaválasz-objektum.

Biztonság

oauth2

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

simple-query

Mintakérelem

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

Mintaválasz

Állapotkód:

200

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

Definíciók

Name	Description
column	Táblázatoszlop.
errorDetail	Hiba részletei.
errorInfo	A hiba kódja és üzenete.
errorResponse	Hiba részletei.
logsColumnType	Az oszlop adattípusa.
queryBody	Az Analytics-lekérdezés. További információ a Analytics lekérdezési szintaxisáról
queryResults	Lekérdezési válasz.
Render	Vizualizációs adatok JSON formátumban.
Statistics	JSON formátumban ábrázolt statisztikák.
table	Lekérdezési választábla.

column

Objektum

Táblázatoszlop.

Name	Típus	Description
name	string	Az oszlop neve.
type	logsColumnType	Az oszlop adattípusa.

errorDetail

Objektum

Hiba részletei.

Name	Típus	Description
additionalProperties	object	A hiba részletei objektumon megadható további tulajdonságok
code	string	A hiba kódja.
message	string	Emberi olvasásra alkalmas hibaüzenet.
resources	string[]	A hibáért felelős erőforrásokat jelzi.
target	string	Azt jelzi, hogy a kérelem melyik tulajdonsága felelős a hibáért.
value	string	Azt jelzi, hogy a "cél" melyik értéke felelős a hibáért.

errorInfo

Objektum

A hiba kódja és üzenete.

Name	Típus	Description
additionalProperties	object	A hibainformációs objektumon megadható további tulajdonságok
code	string	Géppel olvasható hibakód.
details	errorDetail[]	hiba részletei.
innererror	errorInfo	A hiba kódja és üzenete. Belső hiba részletei, ha léteznek.
message	string	Emberi olvasásra alkalmas hibaüzenet.

errorResponse

Objektum

Hiba részletei.

Name	Típus	Description
error	errorInfo	A hiba kódja és üzenete. A hiba részletei.

logsColumnType

Enumerálás

Az oszlop adattípusa.

Érték	Description
bool
datetime
decimal
dynamic
guid
int
long
real
string
timespan

queryBody

Objektum

Az Analytics-lekérdezés. További információ a Analytics lekérdezési szintaxisáról

Name	Típus	Description
query	string	A végrehajtandó lekérdezés.
timespan	string	Opcionális. Az adatok lekérdezésének időkerete. Ez egy ISO8601 időszak értéke. Ezt az időbélyeget a lekérdezési kifejezésben megadottakon kívül alkalmazza a rendszer.
workspaces	string[]	A lekérdezésben szereplő munkaterületek listája.

queryResults

Objektum

Lekérdezési válasz.

Name	Típus	Description
error	errorInfo	A hiba kódja és üzenete.
render	Render	Vizualizációs adatok JSON formátumban.
statistics	Statistics	JSON formátumban ábrázolt statisztikák.
tables	table[]	A táblák, oszlopok és sorok listája.

Render

Objektum

Vizualizációs adatok JSON formátumban.

Statistics

Objektum

JSON formátumban ábrázolt statisztikák.

table

Objektum

Lekérdezési választábla.

Name	Típus	Description
columns	column[]	A táblázat oszlopainak listája.
name	string	A tábla neve.
rows	object[]	A lekérdezés eredményként kapott sorai.