revoke-security-group-ingress

Описание

Удаляет указанные правила входящего (ingress) трафика для группы безопасности.

Вы можете указать правила, используя либо их ID, либо свойства правил группы безопасности. Если вы используете свойства правил, указанные значения (например, порты) должны точно совпадать со значениями существующего правила. Каждое правило имеет протокол, порты начала и конца диапазона, а также источник (CIDR-диапазон, группа безопасности или список префиксов). Для протоколов TCP и UDP также необходимо указать порт назначения или диапазон портов. Для протокола ICMP также необходимо указать тип и код ICMP. Если правило группы безопасности имеет описание, для удаления правила не требуется указывать описание.

Для виртуальной сети по умолчанию, если указанные значения не совпадают со значениями существующего правила, ошибка не возвращается, и вывод описывает правила группы безопасности, которые не были удалены.

Для виртуальной сети, отличной от виртуальной сети по умолчанию, если указанные значения не совпадают со значениями существующего правила, возвращается ошибка клиента InvalidPermission.NotFound, и правила не удаляются.

Компания Amazon Web Services рекомендует описать группу безопасности, чтобы убедиться, что правила были удалены.

Изменения правил распространяются на экземпляры внутри группы безопасности как можно быстрее. Однако может произойти небольшая задержка.

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

Синтаксис

  revoke-security-group-ingress
[--group-id <value>]
[--group-name <value>]
[--ip-permissions <value>]
[--security-group-rule-ids <value>]
[--dry-run | --no-dry-run]
[--protocol <value>]
[--port <value>]
[--cidr <value>]
[--source-group <value>]
[--group-owner <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]

Параметры

--group-id (строка)

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

--ip-permissions (список)

IpProtocol=string,FromPort=integer,ToPort=integer,UserIdGroupPairs=[{Description=string,UserId=string,GroupName=string,GroupId=string,VpcId=string,VpcPeeringConnectionId=string,PeeringStatus=string},{Description=string,UserId=string,GroupName=string,GroupId=string,VpcId=string,VpcPeeringConnectionId=string,PeeringStatus=string}],IpRanges=[{Description=string,CidrIp=string},{Description=string,CidrIp=string}],Ipv6Ranges=[{Description=string,CidrIpv6=string},{Description=string,CidrIpv6=string}],PrefixListIds=[{Description=string,PrefixListId=string},{Description=string,PrefixListId=string}] ...

[
  {
    "IpProtocol": "string",
    "FromPort": integer,
    "ToPort": integer,
    "UserIdGroupPairs": [
      {
        "Description": "string",
        "UserId": "string",
        "GroupName": "string",
        "GroupId": "string",
        "VpcId": "string",
        "VpcPeeringConnectionId": "string",
        "PeeringStatus": "string"
      }
      ...
    ],
    "IpRanges": [
      {
        "Description": "string",
        "CidrIp": "string"
      }
      ...
    ],
    "Ipv6Ranges": [
      {
        "Description": "string",
        "CidrIpv6": "string"
      }
      ...
    ],
    "PrefixListIds": [
      {
        "Description": "string",
        "PrefixListId": "string"
      }
      ...
    ]
  }
  ...
]

"string" "string" ...

Общие параметры

--debug (boolean)

Включить отладку регистрации.

--endpoint-url (string)

Переопределить стандартный URL команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет стандартное поведение проверки SSL-сертификатов.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

• json
• text
• table
• yaml
• yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определённый профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (string)

Показать версию этого инструмента.

--color (string)

Включить/отключить цветной вывод.

• on
• off
• auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат 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 (boolean)

Отключить страницу CLI для вывода.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Пример 1: Удаление правила из группы безопасности

Следующий revoke-security-group-ingress пример удаляет доступ по TCP порту 22 для диапазона адресов 203.0.113.0/24 из указанной группы безопасности для стандартной VPC.

aws ec2 revoke-security-group-ingress \
    --group-name mySecurityGroup
    --protocol tcp \
    --port 22 \
    --cidr 203.0.113.0/24

Если выполнение прошло успешно, эта команда не выдаст никакого вывода.

Дополнительную информацию см. в разделе «Группы безопасности» в руководстве пользователя Amazon EC2.

Пример 2: Удаление правила с использованием набора разрешений IP

Следующий revoke-security-group-ingress пример использует параметр ip-permissions для удаления входного правила, разрешающего сообщение ICMP Destination Unreachable: Fragmentation Needed and Don't Fragment was Set (тип 3, код 4).

aws ec2 revoke-security-group-ingress \
    --group-id sg-026c12253ce15eff7 \
    --ip-permissions IpProtocol=icmp,FromPort=3,ToPort=4,IpRanges=[{CidrIp=0.0.0.0/0}]

Если выполнение прошло успешно, эта команда не выдаст никакого вывода.

Дополнительную информацию см. в разделе «Группы безопасности» в руководстве пользователя Amazon EC2.

Вывод

Возврат -> (boolean)

UnknownIpPermissions -> (список)