ec2-revoke

ec2-revoke group [-P protocol] (-p port_range | -t icmp_type_code) [-u source_group_user ...] [-o source_group ...] [-s source_subnet ...]

Revokes a rule from the security group named GROUP. To identify the rule to be removed you must provide exactly the same set of options used to create that rule (see ec2-add-group).

OptionDescriptionRequired

group

The group to which this rule will apply.

Example: webservers

Yes

-P protocol

The protocol to revoke.

Condition: Applies when specifying a CIDR subnet as the source.

Valid Values: tcp | udp | icmp

Example: -P tcp

Yes

-p port_range

For the TCP or UDP protocols, this specifies the range of ports to revoke. You specify a single integer or a range (min-max).

Condition: Applies when specifying a CIDR subnet as the source.

Example: -p 80

Yes

-t icmp_type_code

For the ICMP protocol, you must specify the ICMP type and code. Use the type:code format, where both are integers. To specify a wildcard for either or both, enter -1.

Condition: Applies when specifying a CIDR subnet as the source.

Example: -t 2:5

Yes

-u source_group_user

The owner of a group specified using -o. If this is not specified, all groups will refer to the current user. If specified more than once, there must be exactly one -u per -o and each user will be mapped to the corresponding group.

Example: -u 495219933132

No

-o source_group

The network source from which traffic will be revoked specified as a security Group. See the description of the -u option for group owner information.

Example: -o headoffice

No

-s source_subnet

The network source from which traffic is to be revoked specified as a CIDR subnet range.

Example: -s 205.192.8.45/24

No

A table containing the following information is returned:

Amazon EC2 displays errors on stderr.

This example revokes TCP port 80 access from the 205.192.0.0/16 address range for the websrv security group.

$ ec2-revoke websrv -P tcp -p 80 -s 205.192.0.0/16
GROUP websrv ""
PERMISSION websrv ALLOWS tcp 80 80 FROM CIDR 205.192.0.0/16