Compartir a través de


Query - Resource Get

Ejecución de una consulta de Analytics mediante el URI de recursos
Ejecuta una consulta de Analytics para los datos en el contexto de un recurso. Este es un ejemplo de uso de POST con una consulta de Analytics.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceId
path True

string

Identificador del recurso.

query
query True

string

Consulta de Analytics. Más información sobre la sintaxis de consulta de Analytics

timespan
query

string

duration

Opcional. Intervalo de tiempo en el que se van a consultar los datos. Se trata de un valor de período de tiempo ISO8601. Este intervalo de tiempo se aplica además de los especificados en la expresión de consulta.

Respuestas

Nombre Tipo Description
200 OK

queryResults

Aceptar. La llamada API se realizó correctamente y el resultado de la consulta de Analytics se encuentra en la carga de respuesta.

Other Status Codes

errorResponse

Objeto de respuesta de error.

Seguridad

oauth2

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

simple-query

Solicitud de ejemplo

GET 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

Respuesta de muestra

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

Definiciones

Nombre Description
column

Una columna de tabla.

errorDetail

Detalles del error.

errorInfo

El código y el mensaje de un error.

errorResponse

Detalles del error.

logsColumnType

Tipo de datos de esta columna.

queryResults

Una respuesta de consulta.

Render

Datos de visualización en formato JSON.

Statistics

Estadísticas representadas en formato JSON.

table

Una tabla de respuesta de consulta.

column

Una columna de tabla.

Nombre Tipo Description
name

string

Nombre de esta columna.

type

logsColumnType

Tipo de datos de esta columna.

errorDetail

Detalles del error.

Nombre Tipo Description
additionalProperties

object

Propiedades adicionales que se pueden proporcionar en el objeto de detalles de error

code

string

Código del error.

message

string

Mensaje de error legible.

resources

string[]

Indica los recursos responsables del error.

target

string

Indica qué propiedad de la solicitud es responsable del error.

value

string

Indica qué valor de "destino" es responsable del error.

errorInfo

El código y el mensaje de un error.

Nombre Tipo Description
additionalProperties

object

Propiedades adicionales que se pueden proporcionar en el objeto de información de error

code

string

Código de error legible de la máquina.

details

errorDetail[]

detalles del error.

innererror

errorInfo

El código y el mensaje de un error.
Detalles del error interno si existen.

message

string

Mensaje de error legible.

errorResponse

Detalles del error.

Nombre Tipo Description
error

errorInfo

El código y el mensaje de un error.
Los detalles del error.

logsColumnType

Tipo de datos de esta columna.

Nombre Tipo Description
bool

string

datetime

string

decimal

string

dynamic

string

guid

string

int

string

long

string

real

string

string

string

timespan

string

queryResults

Una respuesta de consulta.

Nombre Tipo Description
error

errorInfo

El código y el mensaje de un error.

render

Render

Datos de visualización en formato JSON.

statistics

Statistics

Estadísticas representadas en formato JSON.

tables

table[]

Lista de tablas, columnas y filas.

Render

Datos de visualización en formato JSON.

Statistics

Estadísticas representadas en formato JSON.

table

Una tabla de respuesta de consulta.

Nombre Tipo Description
columns

column[]

Lista de columnas de esta tabla.

name

string

Nombre de la tabla.

rows

object[]

Filas resultantes de esta consulta.