Dela via


Query - Resource Execute Xms

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

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

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

Exempelsvar

{
  "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.