Spec-Zone.ru › AWS CLI v2

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

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

  • PENDING
  • ACTIVE
  • INACTIVE
  • ERROR

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

Уникальная, регистрозависимая строка длиной до 64 ASCII-символов, которую вы указываете для выполнения идемпотентного запроса API. Не следует повторно использовать один и тот же токен клиента для других запросов API.

--max-city-networks-to-monitor (целое число)

Максимальное количество городских сетей для мониторинга вашего приложения. Городская сеть — это местоположение (город), откуда клиенты получают доступ к вашим ресурсам приложения, и ASN или поставщик сети, например, интернет-провайдер (ISP), через который клиенты получают доступ к ресурсам. Установка этого ограничения может помочь контролировать затраты на оплату.

--internet-measurements-log-delivery (структура)

Опубликовать интернет-измерения для Internet Monitor в другое место, например, в ведро Amazon S3. Измерения также публикуются в Amazon CloudWatch Logs.

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

Конфигурация для публикации интернет-измерений Internet Monitor в Amazon S3. Конфигурация включает имя ведра и (необязательно) префикс для ведра S3 для хранения измерений, а также статус доставки. Статус доставки — ENABLED или DISABLED, в зависимости от того, выбираете ли вы доставку интернет-измерений в журналы S3.

BucketName -> (строка)

Имя ведра Amazon S3.

BucketPrefix -> (строка)

Префикс ведра Amazon S3.

LogDeliveryStatus -> (строка)

Статус публикации интернет-измерений Internet Monitor в ведро Amazon S3.

Сокращенный синтаксис:

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 -> (строка)

Статус создания Internet Monitor события работоспособности на основе процентного порога, установленного для локальной оценки работоспособности. Статус может быть ENABLED или DISABLED.

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

Процентный порог события работоспособности, установленный для локальной оценки работоспособности.

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

Минимальный процент общего трафика приложения, на который должно повлиять проблема, прежде чем Internet Monitor создаст событие, когда будет превышен порог локальной оценки работоспособности.

Если вы не зададите минимальный порог влияния на трафик, значение по умолчанию — 0,1%.

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

Конфигурация, определяющая порог и другие условия, при которых Internet Monitor создает событие работоспособности для проблемы с локальной производительностью.

Status -> (строка)

Статус создания Internet Monitor события работоспособности на основе процентного порога, установленного для локальной оценки работоспособности. Статус может быть 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 -> (строка)

Amazon Resource Name (ARN) монитора.

Status -> (строка)

Статус монитора.

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

Spec-Zone.ru

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