DescribeSecurityGroups
The DescribeSecurityGroups operation returns
information about security groups owned by the user making the
request.
An optional list of security group names may be provided to request information for those security groups only. If no security group names are provided, information of all security groups will be returned. If a group is specified that does not exist a fault is returned.
The following table describes the request parameters for
DescribeSecurityGroups. Parameter names are case
sensitive.
| Element Name | Definition | Required? | Type |
|---|---|---|---|
securityGroupSet
|
List of security groups to describe. | Yes |
xsd:string[]
|
The following table describes the default response tags included
in DescribeSecurityGroups responses.
| Element Name | Definition | Type |
|---|---|---|
securityGroupInfo
|
Information about security groups. |
ec2:SecurityGroupItemType[]
|
<DescribeSecurityGroups xmlns="http://ec2.amazonaws.com/doc/2007-01-03">
<securityGroupSet>
<item>
<groupName>WebServers</groupName>
</item>
<item>
<groupName>RangedPortsBySource</groupName>
</item>
</securityGroupSet>
</DescribeSecurityGroups>
<DescribeSecurityGroupsResponse xmlns="http://ec2.amazonaws.com/doc/2007-01-03">
<securityGroupInfo>
<item>
<ownerId>UYY3TLBUXIEON5NQVUUX6OMPWBZIQNFM</ownerId>
<groupName>WebServers</groupName>
<groupDescription>Web</groupDescription>
<ipPermissions>
<item>
<ipProtocol>tcp</ipProtocol>
<fromPort>80</fromPort>
<toPort>80</toPort>
<groups/>
<ipRanges>
<item>
<cidrIp>0.0.0.0/0</cidrIp>
</item>
</ipRanges>
</item>
</ipPermissions>
</item>
<item>
<ownerId>UYY3TLBUXIEON5NQVUUX6OMPWBZIQNFM</ownerId>
<groupName>RangedPortsBySource</groupName>
<groupDescription>A</groupDescription>
<ipPermissions>
<item>
<ipProtocol>tcp</ipProtocol>
<fromPort>6000</fromPort>
<toPort>7000</toPort>
<groups/>
<ipRanges/>
</item>
</ipPermissions>
</item>
</securityGroupInfo>
</DescribeSecurityGroupsResponse>