DescribeSecurityGroups

The DescribeSecurityGroups operation returns information about security groups that you own.

If you specify security group names, information about those security group is returned. Otherwise, information for all security group is returned. If you specify a group that does not exist, a fault is returned.

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

NameDescriptionRequired

GroupName.n

List of security groups to describe.

Type: String

No

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

NameDescription

securityGroupInfo

Information about security groups.

Type: ec2:SecurityGroupItemType[]

https://ec2.amazonaws.com/
?Action=DescribeSecurityGroups
&GroupName.1=WebServers
&GroupName.2=RangedPortsBySource
&...auth parameters...
<DescribeSecurityGroupsResponse xmlns="http://ec2.amazonaws.com/doc/2007-08-29">
  <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>