Query - Execute With Resource Id

Служба:: Log Analytics

Версия API:: v1

Выполните аналитический запрос с помощью resource ID
Выполняет аналитический запрос для данных в контексте ресурса. Вот пример использования POST с аналитическим запросом.

POST {endpoint}/{apiVersion}/{resourceId}/query

Параметры URI

Имя	В	Обязательно	Тип	Описание
apiVersion	path	True	string	Версия сервисного API.
endpoint	path	True	string (uri)	Конечная точка сервиса Log Analytics.
resourceId	path	True	string	Идентификатор ресурса.

Заголовок запроса

Имя	Обязательно	Тип	Описание
Prefer		string	Необязательно. Предпочитают заголовок для установки таймаута сервера, запроса статистики и информации визуализации.

Текст запроса

Имя	Обязательно	Тип	Описание
query	True	string	Выполняемый запрос.
timespan		string	Необязательно. Временной промежуток для запроса данных. Это значение ISO8601 периода времени. Этот временной интервал применяется в дополнение к тем, что указаны в выражении запроса.
workspaces		string[]	Список рабочих пространслей для запроса помимо основного рабочего пространства.

Ответы

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

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

OAuth2Auth

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

Области

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

Примеры

Simple resource-centric POST query

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

HTTP

POST {endpoint}/{apiVersion}/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"
}

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

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

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "OperationName",
          "type": "string"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "operation1",
          "10"
        ]
      ]
    }
  ]
}

Определения

Имя	Описание
Column	Столбец в таблице.
ColumnDataType	Тип данных столбца.
ErrorDetail	Сведения об ошибке.
ErrorInfo	Код и сообщение об ошибке.
ErrorResponse	Содержит сведения, когда код ответа указывает на ошибку.
QueryBody	Запрос Analytics. Узнайте больше о синтаксисе аналитических запросов
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	Сведения об ошибке.

QueryBody

Объект

Запрос Analytics. Узнайте больше о синтаксисе аналитических запросов

Имя	Тип	Описание
query	string	Выполняемый запрос.
timespan	string	Необязательно. Временной промежуток для запроса данных. Это значение ISO8601 периода времени. Этот временной интервал применяется в дополнение к тем, что указаны в выражении запроса.
workspaces	string[]	Список рабочих пространслей для запроса помимо основного рабочего пространства.

QueryResults

Объект

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

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

Table

Объект

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

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