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 NameDefinitionRequired?Type
GroupName.n List of security groups to describe. Nostring

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

Element NameDefinitionType
securityGroupInfo Information about security groups. ec2:SecurityGroupItemType[]
https://ec2.amazonaws.com/
?Action=DescribeSecurityGroups
&GroupName.1=WebServers
&GroupName.2=RangedPortsBySource
&...auth parameters...
<DescribeSecurityGroupsResponse xmlns="http://ec2.amazonaws.com/doc/2007-03-01">
  <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>