Query - Resource Get Xms

Referencia

Szolgáltatás:: Log Analytics

API-verzió:: 2022-10-27_Preview

Elemzési lekérdezés végrehajtása erőforrás-URI használatával
Elemzési lekérdezést hajt végre egy erőforrás kontextusában lévő adatokra vonatkozóan. Íme egy példa a POST analyticses lekérdezéssel való használatára.

GET https://api.loganalytics.io/v1/{resourceId}/query?disambiguation_dummy&query={query}

Opcionális paraméterekkel:

GET https://api.loganalytics.io/v1/{resourceId}/query?disambiguation_dummy&query={query}&timespan={timespan}

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceId	path	True	string	Az erőforrás azonosítója.
query	query	True	string	Az Analytics-lekérdezés. További információ az Analytics lekérdezési szintaxisáról
timespan	query		string duration	Választható. Az adatok lekérdezésének időtartománya. Ez egy ISO8601 időszak értéke. Ez az időtartomány a lekérdezési kifejezésben megadottakon kívül lesz alkalmazva.

Válaszok

Name	Típus	Description
200 OK	queryResults	OK gombra. Az API-hívás sikeres volt, és az Analytics-lekérdezés eredménye a válasz hasznos adatában van
Other Status Codes	errorResponse	Egy 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	felhasználói fiók megszemélyesítése

Példák

simple-query

Mintakérelem

HTTP

GET https://api.loganalytics.io/v1//subscriptions/fffa080af-c2d8-40ad-9cce-e1a450bawb57/resourceGroups/test-resourcegroup/providers/Microsoft.Storage/storageAccounts/storageaccountname/query?disambiguation_dummy&query=StorageBlobLogs | summarize count() by OperationName | top 10 by count_ desc&timespan=PT24H

Mintaválasz

Állapotkód:: 200

x-ms-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
x-ms-correlation-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5

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

Definíciók

Name	Description
column	Egy táblázatoszlop.
errorDetail	Hiba részletei.
errorInfo	A hiba kódja és üzenete.
errorResponse	Hiba részletei.
logsColumnType	Az oszlop adattípusa.
queryResults	Lekérdezési válasz.
Render	Vizualizációs adatok JSON formátumban.
Statistics	JSON formátumban ábrázolt statisztikák.
table	Egy lekérdezési választáblát.

column

Egy táblázatoszlop.

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

errorDetail

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 "target" melyik értéke felelős a hibáért.

errorInfo

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

Hiba részletei.

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

logsColumnType

Az oszlop adattípusa.

Name	Típus	Description
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryResults

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

Vizualizációs adatok JSON formátumban.

Statistics

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

table

Egy lekérdezési választáblát.

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.

Megosztás a következőn keresztül: