create-monitor

Описание

Создаёт монитор между подсетью-источником и IP-адресом-назначения. В рамках монитора вы создадите один или несколько зондов, которые будут отслеживать сетевой трафик между вашими подсетями VPC Amazon Web Services (источник) и IP-адресами назначения. Каждый зонд затем агрегирует и отправляет метрики в Amazon CloudWatch.

Вы также можете создать монитор с зондами, используя эту команду. Для каждого зонда вы определяете следующее:

• source — идентификаторы подсетей, где будут созданы зонды.
• destination — целевой IP-адрес назначения для зонда.
• destinationPort — требуется только если протокол является TCP .
• protocol — протокол связи между источником и назначением. Он будет либо TCP, либо ICMP.
• packetSize — размер пакетов. Он должен быть числом от 56 до 8500.
• (Необязательно) tags — пары ключ-значение, созданные и назначенные зонду.

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

Синтаксис

  create-monitor
--monitor-name <value>
[--probes <value>]
[--aggregation-period <value>]
[--client-token <value>]
[--tags <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 (строка)

--probes (список)

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

sourceArn=string,destination=string,destinationPort=integer,protocol=string,packetSize=integer,probeTags={KeyName1=string,KeyName2=string} ...

Синтаксис JSON:

[
  {
    "sourceArn": "string",
    "destination": "string",
    "destinationPort": integer,
    "protocol": "TCP"|"ICMP",
    "packetSize": integer,
    "probeTags": {"string": "string"
      ...}
  }
  ...
]

--aggregation-period (длинное целое число)

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

--tags (карта)

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--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 для вывода.

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

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

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

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

Примеры

Пример 1: Создание сетевого монитора с периодом агрегации

Следующий пример создания сетевого монитора с именем Example_NetworkMonitor с периодом агрегации, установленным на 30 секунд. Изначальное состояние монитора будет INACTIVE, потому что нет зондов, связанных с ним. Состояние изменится на ACTIVE только после добавления зондов. Вы можете использовать команды update-monitor или create-probe для добавления зондов в этот монитор.

aws networkmonitor create-monitor \
     --monitor-name Example_NetworkMonitor \
     --aggregation-period 30

Вывод:

{
    "monitorArn": "arn:aws:networkmonitor:region:111122223333:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "INACTIVE",
    "aggregationPeriod": 30,
    "tags": {}
}

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

Пример 2: Создание сетевого монитора с зондом, использующим TCP, и тегами

Следующий пример создаёт монитор с именем Example_NetworkMonitor. Команда также создаёт один зонд, использующий протокол ICMP и включает теги. Поскольку значение aggregationPeriod не передано в запросе, по умолчанию установлено значение 60 секунд. Состояние монитора со зондом будет PENDING до тех пор, пока монитор не будет ACTIVE. Это может занять несколько минут, после чего состояние state изменится на ACTIVE, и вы сможете начать просмотр метрик CloudWatch.

aws networkmonitor create-monitor \
    --monitor-name Example_NetworkMonitor \
    --probes sourceArn=arn:aws:ec2:region:111122223333:subnet/subnet-id,destination=10.0.0.100,destinationPort=80,protocol=TCP,packetSize=56,probeTags={Name=Probe1} \
    --tags Monitor=Monitor1

Вывод:

{
    "monitorArn": "arn:aws:networkmonitor:region111122223333:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "PENDING",
    "aggregationPeriod": 60,
    "tags": {
        "Monitor": "Monitor1"
    }
}

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

Пример 3: Создание сетевого монитора с зондом, использующим ICMP, и тегами

Следующий пример создаёт монитор с именем Example_NetworkMonitor с периодом агрегации 30 секунд. Команда также создаёт один зонд, использующий протокол ICMP и включает теги. Поскольку значение aggregationPeriod не передано в запросе, по умолчанию установлено значение 60 секунд. Состояние монитора со зондом будет PENDING до тех пор, пока монитор не будет ACTIVE. Это может занять несколько минут, после чего состояние state изменится на ACTIVE, и вы сможете начать просмотр метрик CloudWatch.

aws networkmonitor create-monitor \
     --monitor-name Example_NetworkMonitor \
     --aggregation-period 30 \
     --probes sourceArn=arn:aws:ec2:region111122223333:subnet/subnet-id,destination=10.0.0.100,protocol=ICMP,packetSize=56,probeTags={Name=Probe1} \
     --tags Monitor=Monitor1

Вывод:

{
    "monitorArn": "arn:aws:networkmonitor:region:111122223333:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "PENDING",
    "aggregationPeriod": 30,
    "tags": {
        "Monitor": "Monitor1"
    }
}

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

Вывод

monitorArn -> (строка)

monitorName -> (строка)

state -> (строка)

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

tags -> (карта)