Query - Batch

Serviço:

Log Analytics

Versão da API:

2022-10-27_Preview

Executar um lote de consultas do Analytics
Executa um lote de consultas de Análise para dados. Aqui está um exemplo para usar POST com uma consulta de Análise.

POST https://api.loganalytics.io/v1/$batch

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
requests	True	batchQueryRequest[]	Uma única solicitação em um lote.

Respostas

Nome	Tipo	Description
200 OK	batchResponse	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

metadataPost

Solicitação de exemplo

HTTP

POST https://api.loganalytics.io/v1/$batch

{
  "requests": [
    {
      "id": "1",
      "body": {
        "query": "AppRequests | take 2"
      },
      "path": "/query",
      "method": "POST",
      "workspace": "d2d0e126-fa1e-4b0a-b647-250cdd471e68"
    },
    {
      "id": "2",
      "body": {
        "query": "AppRequests | take 3"
      },
      "path": "/query",
      "method": "POST",
      "workspace": "d2d0e126-fa1e-4b0a-b647-250cdd471e68"
    }
  ]
}

Resposta de exemplo

Código de status:

200

{
  "responses": [
    {
      "id": "1",
      "status": 200,
      "body": {
        "tables": [
          {
            "name": "PrimaryResult",
            "columns": [
              {
                "name": "TenantId",
                "type": "string"
              },
              {
                "name": "TimeGenerated",
                "type": "datetime"
              },
              {
                "name": "Id",
                "type": "string"
              },
              {
                "name": "Source",
                "type": "string"
              },
              {
                "name": "Name",
                "type": "string"
              },
              {
                "name": "Url",
                "type": "string"
              },
              {
                "name": "Success",
                "type": "bool"
              },
              {
                "name": "ResultCode",
                "type": "string"
              },
              {
                "name": "DurationMs",
                "type": "real"
              },
              {
                "name": "PerformanceBucket",
                "type": "string"
              },
              {
                "name": "Properties",
                "type": "dynamic"
              },
              {
                "name": "Measurements",
                "type": "dynamic"
              },
              {
                "name": "OperationName",
                "type": "string"
              },
              {
                "name": "OperationId",
                "type": "string"
              },
              {
                "name": "OperationLinks",
                "type": "dynamic"
              },
              {
                "name": "ParentId",
                "type": "string"
              },
              {
                "name": "SyntheticSource",
                "type": "string"
              },
              {
                "name": "SessionId",
                "type": "string"
              },
              {
                "name": "UserId",
                "type": "string"
              },
              {
                "name": "UserAuthenticatedId",
                "type": "string"
              },
              {
                "name": "UserAccountId",
                "type": "string"
              },
              {
                "name": "AppVersion",
                "type": "string"
              },
              {
                "name": "AppRoleName",
                "type": "string"
              },
              {
                "name": "AppRoleInstance",
                "type": "string"
              },
              {
                "name": "ClientType",
                "type": "string"
              },
              {
                "name": "ClientModel",
                "type": "string"
              },
              {
                "name": "ClientOS",
                "type": "string"
              },
              {
                "name": "ClientIP",
                "type": "string"
              },
              {
                "name": "ClientCity",
                "type": "string"
              },
              {
                "name": "ClientStateOrProvince",
                "type": "string"
              },
              {
                "name": "ClientCountryOrRegion",
                "type": "string"
              },
              {
                "name": "ClientBrowser",
                "type": "string"
              },
              {
                "name": "ResourceGUID",
                "type": "string"
              },
              {
                "name": "IKey",
                "type": "string"
              },
              {
                "name": "SDKVersion",
                "type": "string"
              },
              {
                "name": "ItemCount",
                "type": "int"
              },
              {
                "name": "ReferencedItemId",
                "type": "string"
              },
              {
                "name": "ReferencedType",
                "type": "string"
              },
              {
                "name": "SourceSystem",
                "type": "string"
              },
              {
                "name": "Type",
                "type": "string"
              },
              {
                "name": "_ResourceId",
                "type": "string"
              }
            ],
            "rows": [
              [
                "d2d0e126-fa1e-4b0a-b647-250cdd471e68",
                "2021-06-02T00:18:13.317Z",
                "a3273b160f86b5c4",
                "",
                "ServiceBus.process",
                "",
                true,
                "200",
                0,
                "<250ms",
                "{\"x-opt-enqueued-time\":\"1622593091\"}",
                null,
                "ServiceBus.process",
                "e5d21caf619d4ef564a4b5920cadce47",
                null,
                "c6864f9d3649f302",
                "",
                "",
                "",
                "",
                "",
                "",
                "",
                "srikanta",
                "PC",
                "",
                "",
                "0.0.0.0",
                "Edmonds",
                "Washington",
                "United States",
                "",
                "fc5f5a5d-d6d1-47f9-be1b-aa57185ec6be",
                "b4f83947-968d-4e2f-82ad-804be07697ae",
                "java:3.1.1-BETA.2",
                1,
                "",
                "",
                "Azure",
                "AppRequests",
                "/subscriptions/faa080af-c1d8-40ad-9cce-e1a450ca5b57/resourcegroups/srnagar-azuresdkgroup/providers/microsoft.insights/components/srnagarappinsights"
              ],
              [
                "d2d0e126-fa1e-4b0a-b647-250cdd471e68",
                "2021-06-02T00:19:13.44Z",
                "bebb49e7a1344c07",
                "",
                "ServiceBus.process",
                "",
                true,
                "200",
                0,
                "<250ms",
                "{\"x-opt-enqueued-time\":\"1622593091\"}",
                null,
                "ServiceBus.process",
                "d76c6dec50d2c12267d7d3a246a0c237",
                null,
                "b68fff4775c77214",
                "",
                "",
                "",
                "",
                "",
                "",
                "",
                "srikanta",
                "PC",
                "",
                "",
                "0.0.0.0",
                "Edmonds",
                "Washington",
                "United States",
                "",
                "fc5f5a5d-d6d1-47f9-be1b-aa57185ec6be",
                "b4f83947-968d-4e2f-82ad-804be07697ae",
                "java:3.1.1-BETA.2",
                1,
                "",
                "",
                "Azure",
                "AppRequests",
                "/subscriptions/faa080af-c1d8-40ad-9cce-e1a450ca5b57/resourcegroups/srnagar-azuresdkgroup/providers/microsoft.insights/components/srnagarappinsights"
              ]
            ]
          }
        ]
      }
    },
    {
      "id": "2",
      "status": 200,
      "body": {
        "tables": [
          {
            "name": "PrimaryResult",
            "columns": [
              {
                "name": "TenantId",
                "type": "string"
              },
              {
                "name": "TimeGenerated",
                "type": "datetime"
              },
              {
                "name": "Id",
                "type": "string"
              },
              {
                "name": "Source",
                "type": "string"
              },
              {
                "name": "Name",
                "type": "string"
              },
              {
                "name": "Url",
                "type": "string"
              },
              {
                "name": "Success",
                "type": "bool"
              },
              {
                "name": "ResultCode",
                "type": "string"
              },
              {
                "name": "DurationMs",
                "type": "real"
              },
              {
                "name": "PerformanceBucket",
                "type": "string"
              },
              {
                "name": "Properties",
                "type": "dynamic"
              },
              {
                "name": "Measurements",
                "type": "dynamic"
              },
              {
                "name": "OperationName",
                "type": "string"
              },
              {
                "name": "OperationId",
                "type": "string"
              },
              {
                "name": "OperationLinks",
                "type": "dynamic"
              },
              {
                "name": "ParentId",
                "type": "string"
              },
              {
                "name": "SyntheticSource",
                "type": "string"
              },
              {
                "name": "SessionId",
                "type": "string"
              },
              {
                "name": "UserId",
                "type": "string"
              },
              {
                "name": "UserAuthenticatedId",
                "type": "string"
              },
              {
                "name": "UserAccountId",
                "type": "string"
              },
              {
                "name": "AppVersion",
                "type": "string"
              },
              {
                "name": "AppRoleName",
                "type": "string"
              },
              {
                "name": "AppRoleInstance",
                "type": "string"
              },
              {
                "name": "ClientType",
                "type": "string"
              },
              {
                "name": "ClientModel",
                "type": "string"
              },
              {
                "name": "ClientOS",
                "type": "string"
              },
              {
                "name": "ClientIP",
                "type": "string"
              },
              {
                "name": "ClientCity",
                "type": "string"
              },
              {
                "name": "ClientStateOrProvince",
                "type": "string"
              },
              {
                "name": "ClientCountryOrRegion",
                "type": "string"
              },
              {
                "name": "ClientBrowser",
                "type": "string"
              },
              {
                "name": "ResourceGUID",
                "type": "string"
              },
              {
                "name": "IKey",
                "type": "string"
              },
              {
                "name": "SDKVersion",
                "type": "string"
              },
              {
                "name": "ItemCount",
                "type": "int"
              },
              {
                "name": "ReferencedItemId",
                "type": "string"
              },
              {
                "name": "ReferencedType",
                "type": "string"
              },
              {
                "name": "SourceSystem",
                "type": "string"
              },
              {
                "name": "Type",
                "type": "string"
              },
              {
                "name": "_ResourceId",
                "type": "string"
              }
            ],
            "rows": [
              [
                "d2d0e126-fa1e-4b0a-b647-250cdd471e68",
                "2021-06-02T16:31:25.383Z",
                "08bf242cdc68504c",
                "",
                "ServiceBus.process",
                "",
                true,
                "200",
                0,
                "<250ms",
                "{\"x-opt-enqueued-time\":\"1622651483\"}",
                null,
                "ServiceBus.process",
                "65d9eb1ccf85b1b7ed1e2ea6bb72f563",
                null,
                "146140ce8493a6ed",
                "",
                "",
                "",
                "",
                "",
                "",
                "",
                "srikanta",
                "PC",
                "",
                "",
                "0.0.0.0",
                "Edmonds",
                "Washington",
                "United States",
                "",
                "fc5f5a5d-d6d1-47f9-be1b-aa57185ec6be",
                "b4f83947-968d-4e2f-82ad-804be07697ae",
                "java:3.1.1-BETA.2",
                1,
                "",
                "",
                "Azure",
                "AppRequests",
                "/subscriptions/faa080af-c1d8-40ad-9cce-e1a450ca5b57/resourcegroups/srnagar-azuresdkgroup/providers/microsoft.insights/components/srnagarappinsights"
              ],
              [
                "d2d0e126-fa1e-4b0a-b647-250cdd471e68",
                "2021-06-02T16:32:25.492Z",
                "9f4cd78c10d57b4f",
                "",
                "ServiceBus.process",
                "",
                true,
                "200",
                0,
                "<250ms",
                "{\"x-opt-enqueued-time\":\"1622651483\"}",
                null,
                "ServiceBus.process",
                "ae054fe7b7ac3adf8b841ebbe1ecb912",
                null,
                "14eab103a1969665",
                "",
                "",
                "",
                "",
                "",
                "",
                "",
                "srikanta",
                "PC",
                "",
                "",
                "0.0.0.0",
                "Edmonds",
                "Washington",
                "United States",
                "",
                "fc5f5a5d-d6d1-47f9-be1b-aa57185ec6be",
                "b4f83947-968d-4e2f-82ad-804be07697ae",
                "java:3.1.1-BETA.2",
                1,
                "",
                "",
                "Azure",
                "AppRequests",
                "/subscriptions/faa080af-c1d8-40ad-9cce-e1a450ca5b57/resourcegroups/srnagar-azuresdkgroup/providers/microsoft.insights/components/srnagarappinsights"
              ],
              [
                "d2d0e126-fa1e-4b0a-b647-250cdd471e68",
                "2021-06-02T16:33:25.585Z",
                "ea7e09d4baa4e4ce",
                "",
                "ServiceBus.process",
                "",
                true,
                "200",
                0,
                "<250ms",
                "{\"x-opt-enqueued-time\":\"1622651483\"}",
                null,
                "ServiceBus.process",
                "ba6162e3ccd803086944750b82600a3a",
                null,
                "b60455183860caaf",
                "",
                "",
                "",
                "",
                "",
                "",
                "",
                "srikanta",
                "PC",
                "",
                "",
                "0.0.0.0",
                "Edmonds",
                "Washington",
                "United States",
                "",
                "fc5f5a5d-d6d1-47f9-be1b-aa57185ec6be",
                "b4f83947-968d-4e2f-82ad-804be07697ae",
                "java:3.1.1-BETA.2",
                1,
                "",
                "",
                "Azure",
                "AppRequests",
                "/subscriptions/faa080af-c1d8-40ad-9cce-e1a450ca5b57/resourcegroups/srnagar-azuresdkgroup/providers/microsoft.insights/components/srnagarappinsights"
              ]
            ]
          }
        ]
      }
    }
  ]
}

Definições

Nome	Description
batchQueryRequest	Uma única solicitação em um lote.
batchQueryResponse
batchQueryResults	Uma resposta de consulta para uma única consulta em um lote.
batchRequest	Uma matriz de solicitações.
batchResponse	Resposta a uma consulta em lote.
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.
methodType
path
queryBody	A consulta análise. Saiba mais sobre a sintaxe de consulta do Analytics
Render	Dados de visualização no formato JSON.
Statistics	Estatísticas representadas no formato JSON.
table	Uma tabela de resposta de consulta.

batchQueryRequest

Uma única solicitação em um lote.

Nome	Tipo	Description
body	queryBody	A consulta análise. Saiba mais sobre a sintaxe de consulta do Analytics
headers	object
id	string	Os detalhes do erro.
method	methodType
path	path
workspace	string	ID do workspace a ser incluída na consulta

batchQueryResponse

Nome	Tipo	Description
body	batchQueryResults	Uma resposta de consulta para uma única consulta em um lote. Contém as tabelas, colunas & linhas resultantes de uma consulta.
headers	object
id	string
status	integer

batchQueryResults

Uma resposta de consulta para uma única consulta em um lote.

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.

batchRequest

Uma matriz de solicitações.

Nome	Tipo	Description
requests	batchQueryRequest[]	Uma única solicitação em um lote.

batchResponse

Resposta a uma consulta em lote.

Nome	Tipo	Description
responses	batchQueryResponse[]	Uma matriz de respostas correspondentes a cada solicitação individual em um lote.

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

methodType

Nome	Tipo	Description
POST	string

path

Nome	Tipo	Description
/query	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.

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.