Query - Resource Get Xms

Referens

Tjänst:: Log Analytics

API-version:: 2022-10-27_Preview

Köra en analysfråga med resurs-URI
Kör en Analysfråga för data i kontexten för en resurs. Här är ett exempel på hur du använder POST med en analysfråga.

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

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceId	path	True	string	Resursens identifierare.
query	query	True	string	Analytics-frågan. Läs mer om analytics-frågesyntaxen
timespan	query		string duration	Valfritt. Tidsintervallet för att fråga efter data. Det här är ett ISO8601 tidsperiodvärde. Det här tidsintervallet tillämpas utöver alla som anges i frågeuttrycket.

Svar

Name	Typ	Description
200 OK	queryResults	OK. API-anropet lyckades och analytics-frågeresultatet finns i svarsnyttolasten
Other Status Codes	errorResponse	Ett felsvarsobjekt.

Säkerhet

oauth2

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

simple-query

Exempelbegäran

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

Exempelsvar

Statuskod:: 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"
        ]
      ]
    }
  ]
}

Definitioner

Name	Description
column	En tabellkolumn.
errorDetail	Felinformation.
errorInfo	Koden och meddelandet för ett fel.
errorResponse	Felinformation.
logsColumnType	Datatypen för den här kolumnen.
queryResults	Ett frågesvar.
Render	Visualiseringsdata i JSON-format.
Statistics	Statistik som representeras i JSON-format.
table	En frågesvarstabell.

column

En tabellkolumn.

Name	Typ	Description
name	string	Namnet på den här kolumnen.
type	logsColumnType	Datatypen för den här kolumnen.

errorDetail

Felinformation.

Name	Typ	Description
additionalProperties	object	Ytterligare egenskaper som kan anges för felinformationsobjektet
code	string	Felets kod.
message	string	Ett mänskligt läsbart felmeddelande.
resources	string[]	Anger resurser som var ansvariga för felet.
target	string	Anger vilken egenskap i begäran som ansvarar för felet.
value	string	Anger vilket värde i målet som är ansvarigt för felet.

errorInfo

Koden och meddelandet för ett fel.

Name	Typ	Description
additionalProperties	object	Ytterligare egenskaper som kan anges för felinformationsobjektet
code	string	En felkod som kan läsas av datorn.
details	errorDetail[]	felinformation.
innererror	errorInfo	Koden och meddelandet för ett fel. Inre felinformation om de finns.
message	string	Ett mänskligt läsbart felmeddelande.

errorResponse

Felinformation.

Name	Typ	Description
error	errorInfo	Koden och meddelandet för ett fel. Felinformationen.

logsColumnType

Datatypen för den här kolumnen.

Name	Typ	Description
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryResults

Ett frågesvar.

Name	Typ	Description
error	errorInfo	Koden och meddelandet för ett fel.
render	Render	Visualiseringsdata i JSON-format.
statistics	Statistics	Statistik som representeras i JSON-format.
tables	table[]	Listan över tabeller, kolumner och rader.

Render

Visualiseringsdata i JSON-format.

Statistics

Statistik som representeras i JSON-format.

table

En frågesvarstabell.

Name	Typ	Description
columns	column[]	Listan över kolumner i den här tabellen.
name	string	Namnet på tabellen.
rows	object[]	De resulterande raderna från den här frågan.

Dela via