Query - Resource Get Xms

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ő adatokhoz. Itt 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ó a Analytics lekérdezési szintaxisáról
timespan	query		string (duration)	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.

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

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

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.