Spec-Zone.ru › AWS CLI v2

[ aws . lightsail ]

put-instance-public-ports

Описание

Открывает порты для определённой инстанции Amazon Lightsail, указывает IP-адреса, разрешённые для подключения к инстанции через эти порты, и протокол. Данное действие также закрывает все текущие открытые порты, не включённые в запрос. Включите все желаемые порты и протоколы в вашем PutInstancePublicPorts запросе. Или используйте действие OpenInstancePublicPorts для открытия портов без закрытия текущих открытых портов.

Действие PutInstancePublicPorts поддерживает контроль доступа на основе тегов, используя теги ресурсов, применённые к ресурсу, идентифицируемому instanceName . Для получения дополнительной информации, обратитесь к руководству разработчика Amazon Lightsail.

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

Синтаксис

  put-instance-public-ports
--port-infos <value>
--instance-name <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]

Параметры

--port-infos (список)

Массив объектов для описания портов, которые нужно открыть для указанной инстанции.

(структура)

Описывает порты для открытия на инстанции, IP-адреса, разрешённые для подключения к инстанции через эти порты, и протокол.

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

Первый порт в диапазоне открытых портов на инстанции.

Разрешенные порты:

  • TCP и UDP - 0 до 65535
  • ICMP - Тип ICMP для IPv4-адресов. Например, укажите 8 как fromPort (тип ICMP), и -1 как toPort (код ICMP), чтобы включить ICMP Ping. Для получения дополнительной информации см. Управляющие сообщения на Wikipedia.
  • ICMPv6 - Тип ICMP для IPv6-адресов. Например, укажите 128 как fromPort (тип ICMPv6), и 0 как toPort (код ICMPv6). Для получения дополнительной информации см. Internet Control Message Protocol for IPv6.

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

Последний порт в диапазоне открытых портов на инстанции.

Разрешенные порты:

  • TCP и UDP - 0 до 65535
  • ICMP - Код ICMP для IPv4-адресов. Например, укажите 8 как fromPort (тип ICMP), и -1 как toPort (код ICMP), чтобы включить ICMP Ping. Для получения дополнительной информации см. Управляющие сообщения на Wikipedia.
  • ICMPv6 - Код ICMP для IPv6-адресов. Например, укажите 128 как fromPort (тип ICMPv6), и 0 как toPort (код ICMPv6). Для получения дополнительной информации см. Internet Control Message Protocol for IPv6.

protocol -> (строка)

Имя IP-протокола.

Имя может быть одним из следующих:

  • tcp - Протокол управления передачей (TCP) обеспечивает надёжную, упорядоченную и проверяющую ошибки доставку потоковых данных между приложениями, работающими на узлах, общающихся по IP-сети. Если ваше приложение не требует надёжной службы потоковой передачи данных, используйте UDP.
  • all - Все типы протоколов транспортного уровня. Для получения более общей информации см. Транспортный уровень на Wikipedia.
  • udp - С помощью протокола пользовательских датаграмм (UDP) компьютерные приложения могут отправлять сообщения (или датаграммы) другим узлам в сети Интернет-протокола (IP). Для установления каналов передачи или путей данных предварительные коммуникации не требуются. Приложения, которые не требуют надёжной службы потоковой передачи данных, могут использовать UDP, который предоставляет беспроводную службу датаграмм, делая упор на сокращение задержки в ущерб надёжности. Если вам требуется надёжная служба потоковой передачи данных, используйте TCP вместо UDP.
  • icmp - Протокол управления сообщениями в Интернете (ICMP) используется для отправки сообщений об ошибках и оперативной информации, указывающей на успех или неудачу при общении с инстанцией. Например, ошибка указывается, когда инстанция не может быть достигнута. Если вы указали icmp как protocol, вам необходимо указать тип ICMP с помощью параметра fromPort и код ICMP с помощью параметра toPort.
  • icmp6 - Протокол управления сообщениями в Интернете (ICMP) для IPv6. Если вы указали icmp6 как protocol, вам необходимо указать тип ICMP с помощью параметра fromPort и код ICMP с помощью параметра toPort.

cidrs -> (список)

IPv4-адрес или диапазон IPv4-адресов (в CIDR-нотации), разрешённых для подключения к инстанции через порты и протокол.

Примечание

Параметр ipv6Cidrs перечисляет IPv6-адреса, разрешённые для подключения к инстанции.

Примеры:

  • Чтобы разрешить IP-адрес 192.0.2.44, укажите 192.0.2.44 или 192.0.2.44/32.
  • Чтобы разрешить IP-адреса от 192.0.2.0 до 192.0.2.255, укажите 192.0.2.0/24.

Для получения дополнительной информации о CIDR-блочной нотации, см. Classless Inter-Domain Routing на Wikipedia.

(строка)

ipv6Cidrs -> (список)

IPv6-адрес или диапазон IPv6-адресов (в CIDR-нотации), разрешённых для подключения к инстанции через порты и протокол. Для подключения к инстанции через IPv6 необходимы устройства с IPv6-адресом; в противном случае следует использовать IPv4.

Примечание

Параметр cidrs перечисляет IPv4-адреса, разрешённые для подключения к инстанции.

Для получения дополнительной информации о CIDR-блочной нотации, см. Classless Inter-Domain Routing на Wikipedia.

(строка)

cidrListAliases -> (список)

Псевдоним, определяющий доступ для предварительно настроенного диапазона IP-адресов.

В настоящее время поддерживается только псевдоним lightsail-connect, который позволяет IP-адресам браузерного RDP/SSH-клиента в консоли Lightsail подключаться к вашей инстанции.

(строка)

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

fromPort=integer,toPort=integer,protocol=string,cidrs=string,string,ipv6Cidrs=string,string,cidrListAliases=string,string ...

Синтаксис JSON:

[
  {
    "fromPort": integer,
    "toPort": integer,
    "protocol": "tcp"|"all"|"udp"|"icmp"|"icmpv6",
    "cidrs": ["string", ...],
    "ipv6Cidrs": ["string", ...],
    "cidrListAliases": ["string", ...]
  }
  ...
]

--instance-name (строка)

Имя инстанции, для которой необходимо открыть порты.

--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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое отображает двоичный блок, 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.

Вывод

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

Массив объектов, описывающих результат действия, например, состояние запроса, отметку времени запроса и ресурсы, затронутые запросом.

id -> (строка)

Идентификатор операции.

resourceName -> (строка)

Имя ресурса.

resourceType -> (строка)

Тип ресурса.

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

Отметка времени инициализации операции (1479816991.349).

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

Регион и зона доступности Amazon Web Services.

availabilityZone -> (строка)

Зона доступности. Следует формату us-east-2a (регистрозависимый).

regionName -> (строка)

Имя региона Amazon Web Services.

isTerminal -> (булево)

Булево значение, указывающее, является ли операция терминальной.

operationDetails -> (строка)

Подробности об операции (Debian-1GB-Ohio-1).

operationType -> (строка)

Тип операции.

status -> (строка)

Состояние операции.

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

Отметка времени изменения состояния (1479816991.349).

errorCode -> (строка)

Код ошибки.

errorDetails -> (строка)

Подробности об ошибке.

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

Spec-Zone.ru

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