Query - Resource Get Xms

Riferimento

Servizio:: Log Analytics

Versione API:: 2022-10-27_Preview

Eseguire una query di Analisi usando l'URI delle risorse
Esegue una query di Analisi per i dati nel contesto di una risorsa. Ecco un esempio per l'uso di POST con una query di Analisi.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceId	path	True	string	Identificatore della risorsa.
query	query	True	string	Query di Analisi. Altre informazioni sulla sintassi della query di Analytics
timespan	query		string duration	facoltativo. Intervallo di tempo su cui eseguire query sui dati. Si tratta di un valore ISO8601 periodo di tempo. Questo intervallo di tempo viene applicato oltre a qualsiasi oggetto specificato nell'espressione di query.

Risposte

Nome	Tipo	Descrizione
200 OK	queryResults	OK. La chiamata API ha avuto esito positivo e il risultato della query di Analisi si trova nel payload della risposta
Other Status Codes	errorResponse	Oggetto risposta di errore.

Sicurezza

oauth2

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

simple-query

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
        ]
      ]
    }
  ]
}

Definizioni

Nome	Descrizione
column	Colonna tabella.
errorDetail	Dettagli degli errori.
errorInfo	Codice e messaggio per un errore.
errorResponse	Dettagli degli errori.
logsColumnType	Tipo di dati di questa colonna.
queryResults	Risposta di query.
Render	Dati di visualizzazione in formato JSON.
Statistics	Statistiche rappresentate in formato JSON.
table	Tabella di risposta della query.

column

Colonna tabella.

Nome	Tipo	Descrizione
name	string	Nome di questa colonna.
type	logsColumnType	Tipo di dati di questa colonna.

errorDetail

Dettagli degli errori.

Nome	Tipo	Descrizione
additionalProperties	object	Proprietà aggiuntive che possono essere fornite nell'oggetto dettagli errore
code	string	Codice dell'errore.
message	string	Messaggio di errore leggibile.
resources	string[]	Indica le risorse responsabili dell'errore.
target	string	Indica quale proprietà nella richiesta è responsabile dell'errore.
value	string	Indica quale valore in "target" è responsabile dell'errore.

errorInfo

Codice e messaggio per un errore.

Nome	Tipo	Descrizione
additionalProperties	object	Proprietà aggiuntive che possono essere fornite nell'oggetto informazioni sugli errori
code	string	Codice di errore leggibile dal computer.
details	errorDetail[]	dettagli dell'errore.
innererror	errorInfo	Codice e messaggio per un errore. Dettagli dell'errore interno se esistenti.
message	string	Messaggio di errore leggibile.

errorResponse

Dettagli degli errori.

Nome	Tipo	Descrizione
error	errorInfo	Codice e messaggio per un errore. Dettagli dell'errore.

logsColumnType

Tipo di dati di questa colonna.

Nome	Tipo	Descrizione
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryResults

Risposta di query.

Nome	Tipo	Descrizione
error	errorInfo	Codice e messaggio per un errore.
render	Render	Dati di visualizzazione in formato JSON.
statistics	Statistics	Statistiche rappresentate in formato JSON.
tables	table[]	Elenco di tabelle, colonne e righe.

Render

Dati di visualizzazione in formato JSON.

Statistics

Statistiche rappresentate in formato JSON.

table

Tabella di risposta della query.

Nome	Tipo	Descrizione
columns	column[]	Elenco di colonne in questa tabella.
name	string	Nome della tabella.
rows	object[]	Righe risultanti da questa query.

Condividi tramite