Query - Resource Execute

Ссылка

Служба:: Log Analytics

Версия API:: 2022-10-27_Preview

Выполнение запроса аналитики с помощью идентификатора ресурса
Выполняет запрос аналитики для данных в контексте ресурса. Ниже приведен пример использования POST с запросом Аналитики.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceId	path	True	string	Идентификатор ресурса.

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

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

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

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

Ответы

Имя	Тип	Описание
200 OK	queryResults	Все в порядке. Вызов API выполнен успешно, и результат запроса Аналитики находится в полезных данных ответа
Other Status Codes	errorResponse	Объект ответа об ошибке.

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

oauth2

Поток OAuth2 в Azure Active Directory

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

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

simple-query

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

HTTP

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

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

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

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

Определения

Имя	Описание
column	Столбец таблицы.
errorDetail	Сведения об ошибке.
errorInfo	Код и сообщение об ошибке.
errorResponse	Сведения об ошибке.
logsColumnType	Тип данных этого столбца.
queryBody	Запрос Аналитики. Дополнительные сведения о синтаксисе запросов Аналитики
queryResults	Ответ запроса.
Render	Данные визуализации в формате JSON.
Statistics	Статистика, представленная в формате JSON.
table	Таблица ответов на запросы.

column

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

Имя	Тип	Описание
name	string	Имя этого столбца.
type	logsColumnType	Тип данных этого столбца.

errorDetail

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

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

errorInfo

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

Имя	Тип	Описание
additionalProperties	object	Дополнительные свойства, которые можно указать в объекте сведений об ошибке
code	string	Код ошибки, доступный для чтения компьютером.
details	errorDetail[]	сведения об ошибке.
innererror	errorInfo	Код и сообщение об ошибке. Сведения о внутренней ошибке, если они существуют.
message	string	Удобочитаемое сообщение об ошибке.

errorResponse

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

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

logsColumnType

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

Имя	Тип	Описание
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryBody

Запрос Аналитики. Дополнительные сведения о синтаксисе запросов Аналитики

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

queryResults

Ответ запроса.

Имя	Тип	Описание
error	errorInfo	Код и сообщение об ошибке.
render	Render	Данные визуализации в формате JSON.
statistics	Statistics	Статистика, представленная в формате JSON.
tables	table[]	Список таблиц, столбцов и строк.

Render

Данные визуализации в формате JSON.

Statistics

Статистика, представленная в формате JSON.

table

Таблица ответов на запросы.

Имя	Тип	Описание
columns	column[]	Список столбцов в этой таблице.
name	string	Имя таблицы.
rows	object[]	Результирующая строка из этого запроса.

Поделиться через