Compartilhar via


Query - Resource Get Xms

Executar uma consulta de Análise usando o URI de recurso
Executa uma consulta de Análise para dados no contexto de um recurso. Aqui está um exemplo para usar POST com uma consulta de Análise.

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}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceId
path True

string

O identificador do recurso.

query
query True

string

A consulta análise. Saiba mais sobre a sintaxe de consulta do Analytics

timespan
query

string

duration

Opcional. O período de tempo sobre o qual consultar dados. Esse é um valor de período de tempo ISO8601. Esse período de tempo é aplicado além de qualquer que seja especificado na expressão de consulta.

Respostas

Nome Tipo Description
200 OK

queryResults

OK. A chamada à API foi bem-sucedida e o resultado da consulta do Analytics está no conteúdo da resposta

Other Status Codes

errorResponse

Um objeto de resposta de erro.

Segurança

oauth2

Fluxo do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

simple-query

Solicitação de exemplo

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

Resposta de exemplo

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

Definições

Nome Description
column

Uma coluna de tabela.

errorDetail

Detalhes do erro.

errorInfo

O código e a mensagem de um erro.

errorResponse

Detalhes do erro.

logsColumnType

O tipo de dados desta coluna.

queryResults

Uma resposta de consulta.

Render

Dados de visualização no formato JSON.

Statistics

Estatísticas representadas no formato JSON.

table

Uma tabela de resposta de consulta.

column

Uma coluna de tabela.

Nome Tipo Description
name

string

O nome desta coluna.

type

logsColumnType

O tipo de dados desta coluna.

errorDetail

Detalhes do erro.

Nome Tipo Description
additionalProperties

object

Propriedades adicionais que podem ser fornecidas no objeto de detalhes do erro

code

string

O código do erro.

message

string

Uma mensagem de erro legível por humanos.

resources

string[]

Indica os recursos que foram responsáveis pelo erro.

target

string

Indica qual propriedade na solicitação é responsável pelo erro.

value

string

Indica qual valor em 'target' é responsável pelo erro.

errorInfo

O código e a mensagem de um erro.

Nome Tipo Description
additionalProperties

object

Propriedades adicionais que podem ser fornecidas no objeto de informações de erro

code

string

Um código de erro legível do computador.

details

errorDetail[]

detalhes do erro.

innererror

errorInfo

O código e a mensagem de um erro.
Detalhes do erro interno se eles existirem.

message

string

Uma mensagem de erro legível por humanos.

errorResponse

Detalhes do erro.

Nome Tipo Description
error

errorInfo

O código e a mensagem de um erro.
Os detalhes do erro.

logsColumnType

O tipo de dados desta coluna.

Nome Tipo Description
bool

string

datetime

string

decimal

string

dynamic

string

guid

string

int

string

long

string

real

string

string

string

timespan

string

queryResults

Uma resposta de consulta.

Nome Tipo Description
error

errorInfo

O código e a mensagem de um erro.

render

Render

Dados de visualização no formato JSON.

statistics

Statistics

Estatísticas representadas no formato JSON.

tables

table[]

A lista de tabelas, colunas e linhas.

Render

Dados de visualização no formato JSON.

Statistics

Estatísticas representadas no formato JSON.

table

Uma tabela de resposta de consulta.

Nome Tipo Description
columns

column[]

A lista de colunas nesta tabela.

name

string

O nome da tabela.

rows

object[]

As linhas resultantes dessa consulta.