Query - Resource Execute

Referens

Service:: Log Analytics

API Version:: 2022-10-27_Preview

Köra en Analysfråga med resurs-ID
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.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceId	path	True	string	Resursens identifierare.

Begärandehuvud

Name	Obligatorisk	Typ	Description
Prefer		string	Valfritt. Prioritera huvudet för att ange servertimeout, frågestatistik och visualiseringsinformation.

Begärandetext

Name	Obligatorisk	Typ	Description
query	True	string	Frågan som ska köras.
timespan		string	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.
workspaces		string[]	En lista över arbetsytor som ingår i frågan.

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

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

simple-query

Sample Request

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

Sample Response

Status code:: 200

{
  "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.
queryBody	Analytics-frågan. Läs mer om analytics-frågesyntaxen
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

queryBody

Analytics-frågan. Läs mer om analytics-frågesyntaxen

Name	Typ	Description
query	string	Frågan som ska köras.
timespan	string	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.
workspaces	string[]	En lista över arbetsytor som ingår i frågan.

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.

Share via