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 -> (строка)
isTerminal -> (булево)
operationDetails -> (строка)
Debian-1GB-Ohio-1).operationType -> (строка)
status -> (строка)
statusChangedAt -> (метка времени)
1479816991.349).errorCode -> (строка)
errorDetails -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.