Condividi tramite


Query - Resource Get Xms

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

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

simple-query

Sample Request

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

Sample Response

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.