Query - Resource Get Xms

Referentie

Service:: Log Analytics

API-versie:: 2022-10-27_Preview

Een Analytics-query uitvoeren met behulp van de resource-URI
Hiermee wordt een Analyse-query uitgevoerd voor gegevens in de context van een resource. Hier volgt een voorbeeld voor het gebruik van POST met een Analytics-query.

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

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
resourceId	path	True	string	De id van de resource.
query	query	True	string	De Analytics-query. Meer informatie over de analysequerysyntaxis
timespan	query		string duration	Optioneel. De periode waarin gegevens moeten worden opgevraagd. Dit is een ISO8601 tijdsperiodewaarde. Deze periode wordt toegepast naast alle die zijn opgegeven in de query-expressie.

Antwoorden

Name	Type	Description
200 OK	queryResults	OK. De API-aanroep is geslaagd en het resultaat van de analysequery bevindt zich in de nettolading van het antwoord
Other Status Codes	errorResponse	Een foutreactieobject.

Beveiliging

oauth2

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

simple-query

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name	Description
column	Een tabelkolom.
errorDetail	Foutdetails.
errorInfo	De code en het bericht voor een fout.
errorResponse	Foutdetails.
logsColumnType	Het gegevenstype van deze kolom.
queryResults	Een queryantwoord.
Render	Visualisatiegegevens in JSON-indeling.
Statistics	Statistieken die worden weergegeven in JSON-indeling.
table	Een tabel met queryreacties.

column

Een tabelkolom.

Name	Type	Description
name	string	De naam van deze kolom.
type	logsColumnType	Het gegevenstype van deze kolom.

errorDetail

Foutdetails.

Name	Type	Description
additionalProperties	object	Aanvullende eigenschappen die kunnen worden opgegeven voor het object met foutdetails
code	string	De code van de fout.
message	string	Een door mensen leesbaar foutbericht.
resources	string[]	Geeft resources aan die verantwoordelijk zijn voor de fout.
target	string	Geeft aan welke eigenschap in de aanvraag verantwoordelijk is voor de fout.
value	string	Geeft aan welke waarde in 'doel' verantwoordelijk is voor de fout.

errorInfo

De code en het bericht voor een fout.

Name	Type	Description
additionalProperties	object	Aanvullende eigenschappen die kunnen worden opgegeven voor het foutinformatieobject
code	string	Een machineleesbare foutcode.
details	errorDetail[]	details van de fout.
innererror	errorInfo	De code en het bericht voor een fout. Details van interne fout, indien aanwezig.
message	string	Een door mensen leesbaar foutbericht.

errorResponse

Foutdetails.

Name	Type	Description
error	errorInfo	De code en het bericht voor een fout. De foutdetails.

logsColumnType

Het gegevenstype van deze kolom.

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

queryResults

Een queryantwoord.

Name	Type	Description
error	errorInfo	De code en het bericht voor een fout.
render	Render	Visualisatiegegevens in JSON-indeling.
statistics	Statistics	Statistieken die worden weergegeven in JSON-indeling.
tables	table[]	De lijst met tabellen, kolommen en rijen.

Render

Visualisatiegegevens in JSON-indeling.

Statistics

Statistieken die worden weergegeven in JSON-indeling.

table

Een tabel met queryreacties.

Name	Type	Description
columns	column[]	De lijst met kolommen in deze tabel.
name	string	De naam van de tabel.
rows	object[]	De resulterende rijen van deze query.

Delen via