Compartilhar via


Query - Resource Execute

Executar uma consulta do Analytics usando a ID do 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.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceId
path True

string

O identificador do recurso.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
Prefer

string

Opcional. O cabeçalho prefer para definir o tempo limite do servidor, estatísticas de consulta e informações de visualização.

Corpo da solicitação

Nome Obrigatório Tipo Description
query True

string

A consulta a ser executada.

timespan

string

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.

workspaces

string[]

Uma lista de workspaces incluídos na 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

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

Resposta de exemplo

{
  "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.

queryBody

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

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

queryBody

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

Nome Tipo Description
query

string

A consulta a ser executada.

timespan

string

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.

workspaces

string[]

Uma lista de workspaces incluídos na consulta.

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.