RevokeSecurityGroupIngress

The RevokeSecurityGroupIngress operation revokes permissions from a security group. The permissions used to revoke must be specified using the same values used to grant the permissions.

Permissions are specified by IP protocol (TCP, UDP, or ICMP), the source of the request (by IP range or an Amazon EC2 user-group pair), the source and destination port ranges (for TCP and UDP), and the ICMP codes and types (for ICMP).

Permission changes are quickly propagated to instances within the security group. However, depending on the number of instances in the group, a small delay is might occur, .

The following table describes the request parameters for RevokeSecurityGroupIngress. Parameter names are case sensitive.

NameDescriptionRequired

userId

AWS Access Key ID.

Type: xsd:string

Yes

groupName

Name of the group to modify.

Type: xsd:string

Yes

ipPermissions

Set of permissions to remove from the group.

Type: IpPermissionType[]

Yes

The following table describes the default response tags included in RevokeSecurityGroupIngress responses.

NameDescription

return

true if permissions successfully revoked.

Type: xsd:boolean

<RevokeSecurityGroupIngress xmlns="http://ec2.amazonaws.com/doc/2008-02-01">
    <userId/>
    <groupName>RangedPortsBySource</groupName>
    <ipPermissions>
        <item>
            <ipProtocol>tcp</ipProtocol>
            <fromPort>6000</fromPort>
            <toPort>7000</toPort>
            <groups/>
            <ipRanges/>
        </item>
    </ipPermissions>
</RevokeSecurityGroupIngress>
<RevokeSecurityGroupIngressResponse xmlns="http://ec2.amazonaws.com/doc/2008-02-01">
  <return>true</return>
</RevokeSecurityGroupIngressResponse>