Spec-Zone.ru › AWS CLI v2

[ aws . logs ]

get-query-results

Описание

Возвращает результаты из указанного запроса.

Возвращаются только поля, запрошенные в запросе, а также поле @ptr, являющееся идентификатором записи журнала. Вы можете использовать значение @ptr в операции GetLogRecord для получения полной записи журнала.

GetQueryResults не запускает запрос. Для запуска запроса используйте StartQuery . Дополнительную информацию о том, как долго результаты предыдущих запросов доступны, см. в разделе квоты CloudWatch Logs .

Если значение поля Status в выводе равно Running, эта операция возвращает только частичные результаты. Если вы видите значение Scheduled или Running для статуса, вы можете повторить операцию позже, чтобы увидеть окончательные результаты.

Если вы используете межсчётную наблюдательность CloudWatch, вы можете использовать эту операцию в счётном аккаунте мониторинга для запуска запросов в связанных исходных аккаунтах. Дополнительную информацию см. в разделе межсчётная наблюдательность CloudWatch .

См. также: Документация API AWS

Синтаксис

  get-query-results
--query-id <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--query-id (строка)

Идентификационный номер запроса.

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения, используя предоставленное значение JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или значение input, выводит пример входного JSON, который может быть использован в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, будет выведен пример входного YAML, который может быть использован с --cli-input-yaml. Если предоставлено значение output, он валидирует входные данные команд и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включить отладку логов.

--endpoint-url (строка)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI проверит SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команд.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, сопоставляющегося с двоичным блоком, fileb:// всегда будет обрабатываться как двоичное и использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

Отключить пейджер cli для вывода.

--cli-auto-prompt (булево)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запроса параметров ввода CLI.

Вывод

queryLanguage -> (строка)

Язык запроса, используемый для этого запроса. Дополнительную информацию о языках запросов, поддерживаемых CloudWatch Logs, см. в разделе Поддерживаемые языки запросов .

results -> (список)

События журналов, соответствующие критериям запроса в последнее время, когда он выполнялся.

Значение results представляет собой массив массивов. Каждое событие журнала — это один объект в массиве верхнего уровня. Каждый из этих объектов событий журнала — массив пар field/value.

(список)

(структура)

Содержит одно поле из одного события журнала, возвращенного запросом CloudWatch Logs Insights, вместе со значением этого поля.

Дополнительную информацию о полях, генерируемых CloudWatch logs, см. в разделе Поддерживаемые журналы и обнаруженные поля .

field -> (строка)

Поле события журнала.

value -> (строка)

Значение этого поля.

statistics -> (структура)

Включает количество событий журнала, просканированных запросом, количество событий журнала, соответствующих критериям запроса, и общее количество байтов в просканированных событиях журнала. Эти значения отражают полные необработанные результаты запроса.

recordsMatched -> (число)

Количество событий журналов, соответствующих строке запроса.

recordsScanned -> (число)

Общее количество событий журналов, просканированных во время запроса.

estimatedRecordsSkipped -> (число)

Оценка количества событий журналов, которые были пропущены при обработке запроса, потому что запрос содержал индексированное поле. Пропуск этих записей снижает затраты на запросы и улучшает время выполнения запроса. Дополнительную информацию об индексах полей см. в разделе PutIndexPolicy .

bytesScanned -> (число)

Общее количество байтов в событиях журнала, просканированных во время запроса.

estimatedBytesSkipped -> (число)

Оценка количества байтов в событиях журнала, которые были пропущены при обработке запроса, потому что запрос содержал индексированное поле. Пропуск этих записей снижает затраты на запросы и улучшает время выполнения запроса. Дополнительную информацию об индексах полей см. в разделе PutIndexPolicy .

logGroupsScanned -> (число)

Количество групп журналов, которые были просканированы этим запросом.

status -> (строка)

Статус последнего выполнения запроса. Возможные значения: Cancelled, Complete, Failed, Running, Scheduled, Timeout и Unknown.

Запросы отключаются по истечении 60 минут выполнения. Чтобы избежать отключения ваших запросов, уменьшите диапазон времени поиска или разделите ваш запрос на несколько запросов.

encryptionKey -> (строка)

Если вы связали ключ KMS с результатами запросов CloudWatch Logs Insights в этом аккаунте, это поле отображает ARN ключа, который используется для шифрования результатов запроса при хранении StartQuery.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API