Spec-Zone.ru › AWS CLI v2

[ aws . internetmonitor ]

list-health-events

Описание

Перечисляет все события состояния монитора в Amazon CloudWatch Internet Monitor. Возвращает информацию о событиях состояния, включая время начала и окончания события, а также статус.

Примечание

События состояния, у которых время начала находится в запрошенном временном интервале, не включаются в список событий состояния.

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

list-health-events — это посторінкова операция. Для получения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить посторінковую обработку, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с посторінковой обработкой, аргумент --query должен извлекать данные из результатов следующих выражений запроса: HealthEvents

Синтаксис

  list-health-events
--monitor-name <value>
[--start-time <value>]
[--end-time <value>]
[--event-status <value>]
[--linked-account-id <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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 (метка времени)

Время окончания события состояния. Если событие состояния всё ещё происходит, время окончания не задано.

--event-status (строка)

Статус события состояния.

Возможные значения:

  • ACTIVE
  • RESOLVED

--linked-account-id (строка)

Идентификатор учётной записи для учётной записи, для которой вы настроили совместное использование ресурсов между учётными записями в Amazon CloudWatch Internet Monitor. Вы настраиваете совместное использование ресурсов между учётными записями с помощью Amazon CloudWatch Observability Access Manager. Дополнительные сведения см. в разделе «Наблюдение за состояниями ресурсов между учётными записями в Internet Monitor» в руководстве пользователя Amazon CloudWatch Internet Monitor.

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

--starting-token (строка)

Токен для указания места начала посторінковой обработки. Это NextToken из ранее усечённого ответа.

Примеры использования см. в разделе «Посторінковая обработка» в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Уменьшение размера страницы приводит к большему количеству вызовов AWS-сервиса, при этом возвращается меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе «Посторінковая обработка» в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Для возобновления посторінковой обработки укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе «Посторінковая обработка» в Руководстве пользователя AWS Command Line Interface.

--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.

Вывод

HealthEvents -> (список)

Список событий состояния здоровья.

(структура)

Информация о событии состояния здоровья, созданном в мониторе Amazon CloudWatch Internet Monitor.

EventArn -> (строка)

Amazon Resource Name (ARN) события.

EventId -> (строка)

Внутренне сгенерированный идентификатор конкретного события сбоя сетевого трафика.

StartedAt -> (метка времени)

Время начала события состояния здоровья.

EndedAt -> (метка времени)

Время окончания события состояния здоровья. Если событие состояния здоровья всё ещё активно, то время окончания не установлено.

CreatedAt -> (метка времени)

Время создания события состояния здоровья.

LastUpdatedAt -> (метка времени)

Время последнего обновления события состояния здоровья.

ImpactedLocations -> (список)

Расположения, затронутые событием состояния здоровья.

(структура)

Информация о местоположении, затронутом событием состояния здоровья в Amazon CloudWatch Internet Monitor.

Географические регионы иерархически классифицируются по стране, административному округу, мегаполису и городу. Географический регион определяется на основе IP-адреса, используемого в местах расположения клиентов.

ASName -> (строка)

Название интернет-провайдера (ISP) или сети (ASN).

ASNumber -> (целое число)

Автономный системный номер (ASN) сети в затронутом местоположении.

Country -> (строка)

Название страны, где находится событие состояния здоровья.

Subdivision -> (строка)

Местоположение административного округа, где находится событие состояния здоровья. Административный округ обычно соответствует штатам в большинстве стран (включая США). Для Соединённого Королевства он соответствует стране (Англия, Шотландия, Уэльс) или провинции (Северная Ирландия).

Metro -> (строка)

Мегаполис, где находится событие состояния здоровья.

Мегаполис указывает на мегаполитенский регион в США, например, регион вокруг Нью-Йорка. В странах, не являющихся США, это административный округ второго уровня. Например, в Соединённом Королевстве это может быть графство, лондонский район, единый орган местного самоуправления, район совета и так далее.

City -> (строка)

Название города, где находится событие состояния здоровья.

Latitude -> (двойное число)

Широта местоположения события состояния здоровья.

Longitude -> (двойное число)

Долгота местоположения события состояния здоровья.

CountryCode -> (строка)

Код страны, где находится событие состояния здоровья. Коды ISO 3166-2 для страны предоставляются, если доступны.

SubdivisionCode -> (строка)

Код административного округа, где находится событие состояния здоровья. Коды ISO 3166-2 для административных округов страны предоставляются, если доступны.

ServiceLocation -> (строка)

Местоположение сервиса, где находится событие состояния здоровья.

Status -> (строка)

Состояние события состояния здоровья в затронутом местоположении.

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

Причина сбоя. Существует два типа сетевых сбоев: проблемы с сетью Amazon Web Services или проблемы с интернетом. Проблемы с интернетом обычно связаны с проблемой у провайдера сети, например, у интернет-провайдера (ISP).

Networks -> (список)

Сети, которые могут быть затронуты событием сбоя сети.

(структура)

Интернет-провайдер (ISP) или сеть (ASN) в Amazon CloudWatch Internet Monitor.

ASName -> (строка)

Название интернет-провайдера (ISP) или сети (ASN).

ASNumber -> (целое число)

Автономный системный номер (ASN) интернет-провайдера или сети.

AsPath -> (список)

Сочетание автономного системного номера (ASN) сети и названия сети.

(структура)

Интернет-провайдер (ISP) или сеть (ASN) в Amazon CloudWatch Internet Monitor.

ASName -> (строка)

Название интернет-провайдера (ISP) или сети (ASN).

ASNumber -> (целое число)

Автономный системный номер (ASN) интернет-провайдера или сети.

NetworkEventType -> (строка)

Тип сетевого сбоя.

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

Вычисленный уровень работоспособности в конкретном местоположении.

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

Доступность в Internet Monitor представляет собой оценку процента трафика, который не испытывает снижения доступности. Например, показатель доступности 99% для конечного пользователя и местоположения службы эквивалентен 1% трафика, испытывающего снижение доступности для этой пары.

Для получения дополнительной информации см. Как Internet Monitor рассчитывает показатели производительности и доступности в разделе Amazon CloudWatch Internet Monitor руководства пользователя CloudWatch.

ExperienceScore -> (двойное число)

Оценки производительности или работоспособности рассчитываются для различных географических и комбинаций провайдеров сети (то есть различных гранулярностей), а также суммируются в глобальные оценки. Если вы просматриваете показатели производительности или доступности без фильтрации по конкретной географии или провайдеру, Amazon CloudWatch Internet Monitor предоставляет глобальные оценки работоспособности.

Глава Amazon CloudWatch Internet Monitor в руководстве пользователя CloudWatch содержит подробную информацию о том, как Internet Monitor рассчитывает показатели работоспособности, включая показатели производительности и доступности, и когда он создаёт и разрешает события состояния здоровья. Для получения дополнительной информации см. Как Amazon Web Services рассчитывает показатели производительности и доступности в разделе Amazon CloudWatch Internet Monitor руководства пользователя CloudWatch.

PercentOfTotalTrafficImpacted -> (двойное число)

Влияние события состояния здоровья на общий трафик, выраженное в увеличении задержки или снижении доступности. Это процент того, насколько увеличилась задержка или уменьшилась доступность во время события по сравнению с типичными значениями для трафика из этого местоположения клиента к местоположению Amazon Web Services, использующего эту клиентскую сеть.

Для получения информации о том, как Internet Monitor рассчитывает влияние, см. Как работает Internet Monitor в разделе Amazon CloudWatch Internet Monitor руководства пользователя Amazon CloudWatch.

PercentOfClientLocationImpacted -> (двойное число)

Процент влияния, вызванного событием состояния здоровья на трафик местоположения клиента в глобальном масштабе.

Для получения информации о том, как Internet Monitor рассчитывает влияние, см. Внутри Internet Monitor в разделе Amazon CloudWatch Internet Monitor руководства пользователя Amazon CloudWatch.

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

Производительность в Internet Monitor представляет собой оценку процента трафика, который не испытывает снижения производительности. Например, показатель производительности 99% для конечного пользователя и местоположения службы эквивалентен 1% трафика, испытывающего снижение производительности для этой пары.

Для получения дополнительной информации см. Как Internet Monitor рассчитывает показатели производительности и доступности в разделе Amazon CloudWatch Internet Monitor руководства пользователя CloudWatch.

ExperienceScore -> (двойное число)

Оценки производительности или работоспособности рассчитываются для различных географических и комбинаций провайдеров сети (то есть различных гранулярностей), а также суммируются в глобальные оценки. Если вы просматриваете показатели производительности или доступности без фильтрации по конкретной географии или провайдеру, Amazon CloudWatch Internet Monitor предоставляет глобальные оценки работоспособности.

Глава Amazon CloudWatch Internet Monitor в руководстве пользователя CloudWatch содержит подробную информацию о том, как Internet Monitor рассчитывает показатели работоспособности, включая показатели производительности и доступности, и когда он создаёт и разрешает события состояния здоровья. Для получения дополнительной информации см. Как Amazon Web Services рассчитывает показатели производительности и доступности в разделе Amazon CloudWatch Internet Monitor руководства пользователя CloudWatch.

PercentOfTotalTrafficImpacted -> (двойное число)

Влияние события состояния здоровья на общий трафик, выраженное в увеличении задержки или снижении доступности. Это процент того, насколько увеличилась задержка или уменьшилась доступность во время события по сравнению с типичными значениями для трафика из этого местоположения клиента к местоположению Amazon Web Services, использующего эту клиентскую сеть.

Для получения дополнительной информации см. Когда Amazon Web Services создаёт и разрешает события состояния здоровья в разделе Amazon CloudWatch Internet Monitor руководства пользователя CloudWatch.

PercentOfClientLocationImpacted -> (двойное число)

Влияние события состояния здоровья на производительность в местоположении клиента. Для производительности это процент увеличения задержки во время события по сравнению с типичной производительностью трафика из этого местоположения клиента в местоположение Amazon Web Services, использующее определённую клиентскую сеть.

Для получения дополнительной информации см. Когда Amazon Web Services создаёт и разрешает события состояния здоровья в разделе Amazon CloudWatch Internet Monitor руководства пользователя CloudWatch.

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

Это процент увеличения времени обратного пути во время события по сравнению с типичным временем обратного пути для вашей программы для трафика.

Для получения дополнительной информации см. Когда Amazon Web Services создаёт и разрешает события состояния здоровья в разделе Amazon CloudWatch Internet Monitor руководства пользователя CloudWatch.

P50 -> (двойное число)

RTT на 50-м процентиле (p50).

P90 -> (двойное число)

RTT на 90-м процентиле (p90).

P95 -> (двойное число)

RTT на 95-м процентиле (p95).

Ipv4Prefixes -> (список)

IPv4-префиксы в местоположении клиента, которое было затронуто событием состояния здоровья.

(строка)

Status -> (строка)

Состояние события состояния здоровья.

PercentOfTotalTrafficImpacted -> (двойное число)

Влияние события состояния здоровья на общий трафик, выраженное в увеличении задержки или снижении доступности. Это процент того, насколько увеличилась задержка или уменьшилась доступность во время события по сравнению с типичными значениями для трафика из этого местоположения клиента к местоположению Amazon Web Services, использующего эту клиентскую сеть.

ImpactType -> (строка)

Тип сбоя для события состояния здоровья.

HealthScoreThreshold -> (двойное число)

Значение порога процента производительности или доступности, которое было настроено, когда Amazon CloudWatch Internet Monitor создал событие состояния здоровья.

NextToken -> (строка)

Токен для следующего набора результатов. Вы получаете этот токен из предыдущего вызова.

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

Spec-Zone.ru

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