Query - Get

Служба:: Log Analytics

Версия API:: v1

Выполнить аналитический запрос
Выполняет аналитический запрос для данных.

GET {endpoint}/{apiVersion}/workspaces/{workspaceId}/query?query={query}

С использованием необязательных параметров:

GET {endpoint}/{apiVersion}/workspaces/{workspaceId}/query?query={query}&timespan={timespan}

Параметры URI

Имя	В	Обязательно	Тип	Описание
apiVersion	path	True	string	Версия сервисного API.
endpoint	path	True	string (uri)	Конечная точка сервиса Log Analytics.
workspaceId	path	True	string	Основной идентификатор рабочего пространства запроса. Это идентификатор рабочего пространства из blade Properties в портале Azure.
query	query	True	string	Запрос Analytics. Узнайте больше о синтаксисе аналитических запросов
timespan	query		string (duration)	Необязательно. Временной промежуток для запроса данных. Это значение ISO8601 периода времени. Этот временной интервал применяется в дополнение к тем, что указаны в выражении запроса.

Ответы

Имя	Тип	Описание
200 OK	QueryResults	Запрос выполнен успешно.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Безопасность

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
https://api.loganalytics.io/.default

Примеры

A cross workspace GET query

A simple GET query on a workspace

A cross workspace GET query

Образец запроса

HTTP

GET {endpoint}/{apiVersion}/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query?query=union * | where TimeGenerated > ago(1h) | summarize count() by Type, TenantId

Пример ответа

Код состояния:: 200

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "Type",
          "type": "string"
        },
        {
          "name": "TenantId",
          "type": "string"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "Usage",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "1"
        ],
        [
          "Usage",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "1"
        ],
        [
          "BillingFact",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "1"
        ],
        [
          "BillingFact",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "1"
        ],
        [
          "Operation",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "7"
        ],
        [
          "Operation",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "5"
        ]
      ]
    }
  ]
}

A simple GET query on a workspace

Образец запроса

HTTP

GET {endpoint}/{apiVersion}/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query?query=Usage | take 10&timespan=PT12H

Пример ответа

Код состояния:: 200

x-ms-correlation-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
x-ms-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "TenantId",
          "type": "string"
        },
        {
          "name": "Computer",
          "type": "string"
        },
        {
          "name": "TimeGenerated",
          "type": "datetime"
        },
        {
          "name": "SourceSystem",
          "type": "string"
        },
        {
          "name": "StartTime",
          "type": "datetime"
        },
        {
          "name": "EndTime",
          "type": "datetime"
        },
        {
          "name": "ResourceUri",
          "type": "string"
        },
        {
          "name": "LinkedResourceUri",
          "type": "string"
        },
        {
          "name": "DataType",
          "type": "string"
        },
        {
          "name": "Solution",
          "type": "string"
        },
        {
          "name": "BatchesWithinSla",
          "type": "long"
        },
        {
          "name": "BatchesOutsideSla",
          "type": "long"
        },
        {
          "name": "BatchesCapped",
          "type": "long"
        },
        {
          "name": "TotalBatches",
          "type": "long"
        },
        {
          "name": "AvgLatencyInSeconds",
          "type": "real"
        },
        {
          "name": "Quantity",
          "type": "real"
        },
        {
          "name": "QuantityUnit",
          "type": "string"
        },
        {
          "name": "IsBillable",
          "type": "bool"
        },
        {
          "name": "MeterId",
          "type": "string"
        },
        {
          "name": "LinkedMeterId",
          "type": "string"
        },
        {
          "name": "Type",
          "type": "string"
        }
      ],
      "rows": [
        [
          "b438b4f6-912a-46d5-9cb1-b44069212abc",
          "ContosoSQLSrv1",
          "2017-08-24T06:59:59Z",
          "OMS",
          "2017-08-24T06:00:00Z",
          "2017-08-24T06:59:59Z",
          "/subscriptions/e4272367-5645-4c4e-9c67-3b74b59a6982/resourcegroups/contosoazurehq/providers/microsoft.operationalinsights/workspaces/contosoretail-it",
          null,
          "Perf",
          "LogManagement",
          "1",
          "0",
          "0",
          "1",
          "1.286",
          "0.076408",
          "MBytes",
          "true",
          "a4e29a95-5b4c-408b-80e3-113f9410566e",
          "00000000-0000-0000-0000-000000000000",
          "Usage"
        ],
        [
          "b438b4f6-912a-46d5-9cb1-b44069212abc",
          "Store010Web3",
          "2017-08-24T06:59:59Z",
          "OMS",
          "2017-08-24T06:00:00Z",
          "2017-08-24T06:59:59Z",
          "/subscriptions/e4272367-5645-4c4e-9c67-3b74b59a6982/resourcegroups/contosoazurehq/providers/microsoft.operationalinsights/workspaces/contosoretail-it",
          null,
          "Perf",
          "LogManagement",
          "1",
          "0",
          "0",
          "1",
          "1.7",
          "0.106767",
          "MBytes",
          "true",
          "a4e29a95-5b4c-408b-80e3-113f9410566e",
          "00000000-0000-0000-0000-000000000000",
          "Usage"
        ]
      ]
    }
  ]
}

Определения

Имя	Описание
Column	Столбец в таблице.
ColumnDataType	Тип данных столбца.
ErrorDetail	Сведения об ошибке.
ErrorInfo	Код и сообщение об ошибке.
ErrorResponse	Содержит сведения, когда код ответа указывает на ошибку.
QueryResults	Содержит таблицы, столбцы и строки, полученные в результате запроса.
Table	Содержит столбцы и строки одной таблицы в ответе запроса.

Column

Объект

Столбец в таблице.

Имя	Тип	Описание
name	string	Название этой колонки.
type	ColumnDataType	Тип данных этого столбца.

ColumnDataType

Перечисление

Тип данных столбца.

Значение	Описание
bool	тип данных Boolean
datetime	Тип данных DateTime
dynamic	Динамический тип данных
int	Целочисленные типы данных
long	Длинный целочисленный тип данных
real	Тип данных с реальной/плавающей запятой
string	строковый тип данных
guid	Тип данных GUID
decimal	Тип десятичных данных
timespan	Тип данных временного промежутка

ErrorDetail

Объект

Сведения об ошибке.

Имя	Тип	Описание
additionalProperties		Дополнительные свойства, которые могут быть предоставлены объекту деталей ошибки
code	string	Код ошибки.
message	string	Удобочитаемое сообщение об ошибке.
resources	string[]	Указывает ресурсы, которые были ответственны за ошибку.
target	string	Указывает, какое свойство в запросе отвечает за ошибку.
value	string	Указывает, какое значение в 'target' ответственно за ошибку.

ErrorInfo

Объект

Код и сообщение об ошибке.

Имя	Тип	Описание
additionalProperties		Дополнительные свойства, которые могут быть указаны на объекте информации об ошибке
code	string	Машиночитаемый код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
innererror	ErrorInfo	Детали внутренних ошибок, если они есть.
message	string	Удобочитаемое сообщение об ошибке.

ErrorResponse

Объект

Содержит сведения, когда код ответа указывает на ошибку.

Имя	Тип	Описание
error	ErrorInfo	Сведения об ошибке.

QueryResults

Объект

Содержит таблицы, столбцы и строки, полученные в результате запроса.

Имя	Тип	Описание
error	ErrorInfo	Код и сообщение об ошибке.
render		Визуализационные данные в формате JSON.
statistics		Статистика представлена в формате JSON.
tables	Table[]	Результаты запроса в табличном формате.

Table

Объект

Содержит столбцы и строки одной таблицы в ответе запроса.

Имя	Тип	Описание
columns	Column[]	Список столбцов в этой таблице.
name	string	Название таблицы.
rows	Rows[]	Полученные строки из этого запроса.