[ aws . internetmonitor ]
start-query
Описание
Запустить запрос для возврата данных определенного типа запроса для интерфейса запросов Amazon CloudWatch Internet Monitor. Укажите временной период для возвращаемых данных, используя StartTime и EndTime. Вы фильтруете результаты запроса, предоставляя параметры, которые вы указываете с помощью FilterParameters.
Дополнительную информацию об использовании интерфейса запросов, включая примеры, см. в руководстве пользователя Amazon CloudWatch Internet Monitor в разделе «Использование интерфейса запросов Amazon CloudWatch Internet Monitor».
См. также: Документация API AWS
Синтаксис
start-query
--monitor-name <value>
--start-time <value>
--end-time <value>
--query-type <value>
[--filter-parameters <value>]
[--linked-account-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]
Параметры
--monitor-name (строка)
--start-time (метка времени)
--end-time (метка времени)
--query-type (строка)
Тип запроса. Ниже приведены три типа запросов, которые можно выполнить с помощью интерфейса запросов Internet Monitor:
-
MEASUREMENTS: Предоставляет оценки доступности, производительности, общий трафик и время обхода в 5-минутных интервалах. -
TOP_LOCATIONS: Предоставляет оценки доступности, производительности, общий трафик и время до первого байта (TTFB) для лучших комбинаций местоположения и ASN, которые вы отслеживаете, по объему трафика. -
TOP_LOCATION_DETAILS: Предоставляет информацию о TTFB для Amazon CloudFront, вашей текущей конфигурации и лучшей конфигурации EC2 в 1-часовых интервалах. -
OVERALL_TRAFFIC_SUGGESTIONS: Предоставляет TTFB, используя 30-дневное взвешенное среднее, для всего трафика в каждом регионе Amazon Web Services, который отслеживается. -
OVERALL_TRAFFIC_SUGGESTIONS_DETAILS: Предоставляет TTFB, используя 30-дневное взвешенное среднее, для каждого лучшего местоположения для предлагаемого региона Amazon Web Services. Необходимо указать регион Amazon Web Services для поиска. -
ROUTING_SUGGESTIONS: Предоставляет прогнозируемое среднее время обхода (RTT) из префикса IP в направлении региона Amazon Web Services для DNS-резолвера. RTT вычисляется в одном часовом интервале в течение одного часа.
Список полей, возвращаемых с каждым типом запроса, и дополнительную информацию о том, как выполняется каждый тип запроса, см. в руководстве пользователя Amazon CloudWatch Internet Monitor в разделе «Использование интерфейса запросов Amazon CloudWatch Internet Monitor».
Возможные значения:
MEASUREMENTSTOP_LOCATIONSTOP_LOCATION_DETAILSOVERALL_TRAFFIC_SUGGESTIONSOVERALL_TRAFFIC_SUGGESTIONS_DETAILSROUTING_SUGGESTIONS
--filter-parameters (список)
Поле FilterParameters, которое используется с запросами Amazon CloudWatch Internet Monitor, — это строка, определяющая, как вы хотите отфильтровать запрос. Параметры фильтра, которые вы можете указать, зависят от типа запроса, поскольку каждый тип запроса возвращает различные данные Internet Monitor.
Дополнительную информацию об указании параметров фильтра см. в руководстве пользователя Amazon CloudWatch Internet Monitor в разделе «Использование интерфейса запросов Amazon CloudWatch Internet Monitor».
(структура)
Фильтр, который вы используете с результатами запроса Amazon CloudWatch Internet Monitor, который вы создали и запустили. Запрос создает хранилище данных, которое является подмножеством данных мониторинга вашего приложения. FilterParameter — это строка, определяющая, как вы хотите отфильтровать хранилище данных для возврата набора результатов на основе ваших критериев.
Параметры фильтра, которые вы можете указать, зависят от типа запроса, который вы использовали для создания хранилища, поскольку каждый тип запроса возвращает различные данные Internet Monitor.
Для каждого фильтра вы указываете поле (например, city), оператор (например, not_equals) и значение или массив значений (например, ["Seattle", "Redmond"]). Разделяйте значения в массиве запятыми.
Дополнительную информацию об указании параметров фильтра см. в руководстве пользователя Amazon CloudWatch Internet Monitor в разделе «Использование интерфейса запросов Amazon CloudWatch Internet Monitor».
Поле -> (строка)
city. Поле должно быть одним из полей, возвращенных конкретным запросом, который вы использовали для создания хранилища.Оператор -> (строка)
not_equals.Значения -> (список)
Одно или несколько значений, которые будут использоваться вместе с указанным оператором для фильтрации данных для запроса. Например, вы можете указать массив значений, такой как ["Seattle", "Redmond"]. Значения в массиве разделяются запятыми.
(строка)
Сокращенный синтаксис:
Field=string,Operator=string,Values=string,string ...
Синтаксис JSON:
[
{
"Field": "string",
"Operator": "EQUALS"|"NOT_EQUALS",
"Values": ["string", ...]
}
...
]
--linked-account-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
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла с данными учетных записей.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- включен
- выключен
- автоматически
--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-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запроса параметров ввода CLI.
Вывод
QueryId -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.