RevokeSecurityGroupIngress
Description
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.
Request Parameters
| Name | Description | Required |
|---|---|---|
| AWS Access Key ID. Type: String Default: None | Yes |
| Name of the group to modify. Type: String Default: None | Yes |
| IP protocol. Type: String Default: None Valid Values: | Yes |
| Start of port range for the TCP and UDP protocols, or an ICMP type number. An ICMP type number of -1 indicates a wildcard (i.e., any ICMP type number). Type: Integer Default: None | Yes |
| End of port range for the TCP and UDP protocols, or an ICMP code. An ICMP code of -1 indicates a wildcard (i.e., any ICMP code). Type: Integer Default: None | Yes |
| AWS User ID of an account. Type: String Default: None | Yes |
| Name of the security group. Type: String Default: None | Yes |
| CIDR range. Type: String Default: None Constraints: Valid CIDR IP address range. | Yes |
Response Elements
| Name | Description |
|---|---|
|
Type: |
Ancestor: None
Children: requestId, return
requestId
The ID of the request.
Type: xsd:string
Ancestor: RevokeSecurityGroupIngressResponseType
Children: None
return
Returns "true" if the request is successful; otherwise "false".
Type: xsd:boolean
Ancestor: RevokeSecurityGroupIngressResponseType
Children: None
Examples
Example Request
This example revokes TCP port 80 access from the 205.192.0.0/16 address range for the websrv security group.
https://ec2.amazonaws.com/?Action=RevokeSecurityGroupIngress&IpProtocol=tcp&FromPort=80&ToPort=80&CidrIp=205.192.0.0/16 &AuthParams
Example Response
<RevokeSecurityGroupIngressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/"> <return>true</return> </RevokeSecurityGroupIngressResponse>