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 |
---|---|---|---|---|
resource
|
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 |
OK. API-anropet lyckades och analytics-frågeresultatet finns i svarsnyttolasten |
|
Other Status Codes |
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. |
error |
Felinformation. |
error |
Koden och meddelandet för ett fel. |
error |
Felinformation. |
logs |
Datatypen för den här kolumnen. |
query |
Analytics-frågan. Läs mer om analytics-frågesyntaxen |
query |
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 |
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 |
felinformation. |
|
innererror |
Koden och meddelandet för ett fel. |
|
message |
string |
Ett mänskligt läsbart felmeddelande. |
errorResponse
Felinformation.
Name | Typ | Description |
---|---|---|
error |
Koden och meddelandet för ett fel. |
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 |
Koden och meddelandet för ett fel. |
|
render |
Visualiseringsdata i JSON-format. |
|
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. |