[ aws . internetmonitor ]
update-monitor
Описание
Обновляет монитор. Вы можете обновить монитор, чтобы изменить процент трафика для мониторинга или максимальное количество городских сетей (местоположений и ASN), добавить или удалить ресурсы или изменить статус монитора. Обратите внимание, что вы не можете изменить имя монитора.
Максимальное количество городских сетей, которое вы выбираете, является ограничением, но вы платите только за количество городских сетей, которые фактически отслеживаются. Для получения дополнительной информации см. Выбор максимального значения для городских сетей в руководстве Amazon CloudWatch User Guide.
См. также: AWS API документацию
Синтаксис
update-monitor
--monitor-name <value>
[--resources-to-add <value>]
[--resources-to-remove <value>]
[--status <value>]
[--client-token <value>]
[--max-city-networks-to-monitor <value>]
[--internet-measurements-log-delivery <value>]
[--traffic-percentage-to-monitor <value>]
[--health-events-config <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 (строка)
--resources-to-add (список)
Ресурсы, которые нужно включить в монитор, предоставляемые в виде набора Amazon Resource Names (ARN). Ресурсы могут быть VPC, NLB, распределениями Amazon CloudFront или каталогами Amazon WorkSpaces.
Можно добавить комбинацию VPC и распределений CloudFront, или можно добавить каталоги WorkSpaces, или можно добавить NLB. Нельзя добавлять NLB или каталоги WorkSpaces вместе с другими ресурсами.
Примечание
Если вы добавляете только ресурсы Amazon Virtual Private Clouds, по крайней мере один VPC должен иметь подключенный шлюз Интернет, чтобы убедиться, что у него есть подключение к Интернету.(строка)
Синтаксис:
"string" "string" ...
--resources-to-remove (список)
Ресурсы, которые нужно удалить из монитора, предоставляемые в виде набора Amazon Resource Names (ARN).
(строка)
Синтаксис:
"string" "string" ...
--status (строка)
Статус монитора. Допустимые значения для Status с вызовом API UpdateMonitor следующие: ACTIVE и INACTIVE. Следующие значения не принимаются: PENDING и ERROR.
Возможные значения:
PENDINGACTIVEINACTIVEERROR
--client-token (строка)
--max-city-networks-to-monitor (целое число)
--internet-measurements-log-delivery (структура)
Опубликовать интернет-измерения для Internet Monitor в другое место, например, в ведро Amazon S3. Измерения также публикуются в Amazon CloudWatch Logs.
S3Config -> (структура)
Конфигурация для публикации интернет-измерений Internet Monitor в Amazon S3. Конфигурация включает имя ведра и (необязательно) префикс для ведра S3 для хранения измерений, а также статус доставки. Статус доставки — ENABLED или DISABLED, в зависимости от того, выбираете ли вы доставку интернет-измерений в журналы S3.
BucketName -> (строка)
BucketPrefix -> (строка)
LogDeliveryStatus -> (строка)
Сокращенный синтаксис:
S3Config={BucketName=string,BucketPrefix=string,LogDeliveryStatus=string}
Синтаксис JSON:
{
"S3Config": {
"BucketName": "string",
"BucketPrefix": "string",
"LogDeliveryStatus": "ENABLED"|"DISABLED"
}
}
--traffic-percentage-to-monitor (целое число)
Процент интернет-трафика вашего приложения, который вы хотите отслеживать с помощью этого монитора. Если вы установили максимальное количество городских сетей, это ограничение переопределяет процент трафика, который вы установили.
Дополнительные сведения см. в разделе «Выбор процента трафика приложения для мониторинга» в разделе Amazon CloudWatch Internet Monitor руководства CloudWatch User Guide.
--health-events-config (структура)
Список пороговых значений оценки работоспособности. Процентный порог для оценок работоспособности, а также другая конфигурационная информация определяют, когда Internet Monitor создает событие работоспособности, когда возникает проблема с интернетом, которая влияет на конечных пользователей вашего приложения.
Дополнительные сведения см. в разделе «Изменение пороговых значений событий работоспособности» в разделе «Монитор интернета» руководства CloudWatch User Guide.
AvailabilityScoreThreshold -> (двойное число)
PerformanceScoreThreshold -> (двойное число)
AvailabilityLocalHealthEventsConfig -> (структура)
Конфигурация, определяющая порог и другие условия, при которых Internet Monitor создает событие работоспособности для проблемы с локальной доступностью.
Status -> (строка)
ENABLED или DISABLED.HealthScoreThreshold -> (двойное число)
MinTrafficImpact -> (двойное число)
Минимальный процент общего трафика приложения, на который должно повлиять проблема, прежде чем Internet Monitor создаст событие, когда будет превышен порог локальной оценки работоспособности.
Если вы не зададите минимальный порог влияния на трафик, значение по умолчанию — 0,1%.
PerformanceLocalHealthEventsConfig -> (структура)
Конфигурация, определяющая порог и другие условия, при которых Internet Monitor создает событие работоспособности для проблемы с локальной производительностью.
Status -> (строка)
ENABLED или DISABLED.HealthScoreThreshold -> (двойное число)
MinTrafficImpact -> (двойное число)
Минимальный процент общего трафика приложения, на который должно повлиять проблема, прежде чем Internet Monitor создаст событие, когда будет превышен порог локальной оценки работоспособности.
Если вы не зададите минимальный порог влияния на трафик, значение по умолчанию — 0,1%.
Сокращенный синтаксис:
AvailabilityScoreThreshold=double,PerformanceScoreThreshold=double,AvailabilityLocalHealthEventsConfig={Status=string,HealthScoreThreshold=double,MinTrafficImpact=double},PerformanceLocalHealthEventsConfig={Status=string,HealthScoreThreshold=double,MinTrafficImpact=double}
Синтаксис JSON:
{
"AvailabilityScoreThreshold": double,
"PerformanceScoreThreshold": double,
"AvailabilityLocalHealthEventsConfig": {
"Status": "ENABLED"|"DISABLED",
"HealthScoreThreshold": double,
"MinTrafficImpact": double
},
"PerformanceLocalHealthEventsConfig": {
"Status": "ENABLED"|"DISABLED",
"HealthScoreThreshold": double,
"MinTrafficImpact": double
}
}
--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-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запроса параметров ввода CLI.
Вывод
MonitorArn -> (строка)
Status -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.