Query - Resource Execute Xms

Riferimento

Servizio:: Log Analytics

Versione API:: 2022-10-27_Preview

Eseguire una query di Analytics usando l'ID risorsa
Esegue una query di Analisi per i dati nel contesto di una risorsa. Di seguito è riportato un esempio per l'uso di POST con una query di Analisi.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceId	path	True	string	Identificatore della risorsa.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Prefer		string	facoltativo. L'intestazione preferita per impostare il timeout del server, le statistiche delle query e le informazioni di visualizzazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
query	True	string	Query da eseguire.
timespan		string	facoltativo. Intervallo di tempo in cui eseguire query sui dati. Si tratta di un valore ISO8601 periodo di tempo. Questo intervallo di tempo viene applicato oltre a qualsiasi specificato nell'espressione di query.
workspaces		string[]	Elenco di aree di lavoro incluse nella query.

Risposte

Nome	Tipo	Descrizione
200 OK	queryResults	OK. La chiamata API ha avuto esito positivo e il risultato della query di Analisi è 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

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

Risposta di esempio

Codice di stato:: 200

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "OperationName",
          "type": "string"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "operation1",
          "10"
        ]
      ]
    }
  ]
}

Definizioni

Nome	Descrizione
column	Colonna di tabella.
errorDetail	Dettagli errore.
errorInfo	Codice e messaggio per un errore.
errorResponse	Dettagli errore.
logsColumnType	Tipo di dati di questa colonna.
queryBody	Query di Analisi. Altre informazioni sulla sintassi delle query di Analytics
queryResults	Risposta di query.
Render	Dati di visualizzazione in formato JSON.
Statistics	Statistiche rappresentate in formato JSON.
table	Una tabella di risposta alla query.

column

Colonna di tabella.

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

errorDetail

Dettagli errore.

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 il 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 errore.

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

queryBody

Query di Analisi. Altre informazioni sulla sintassi delle query di Analytics

Nome	Tipo	Descrizione
query	string	Query da eseguire.
timespan	string	facoltativo. Intervallo di tempo in cui eseguire query sui dati. Si tratta di un valore ISO8601 periodo di tempo. Questo intervallo di tempo viene applicato oltre a qualsiasi specificato nell'espressione di query.
workspaces	string[]	Elenco di aree di lavoro incluse nella query.

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

Una tabella di risposta alla 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