AmazonEC2Client.DescribeSecurityGroups Method (DescribeSecurityGroupsRequest)

Describes the specified security groups or all of your security groups.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 security groups in the Amazon Elastic Compute Cloud User Guide and Security groups for your VPC in the Amazon Virtual Private Cloud User Guide.

We are retiring EC2-Classic. We recommend that you migrate from EC2-Classic to a VPC. For more information, see Migrate from EC2-Classic to a VPC in the Amazon Elastic Compute Cloud User Guide.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to DescribeSecurityGroupsAsync.

Namespace: Amazon.EC2
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z

Syntax

public virtual DescribeSecurityGroupsResponse DescribeSecurityGroups(
         DescribeSecurityGroupsRequest request
)

Parameters

request: Type: Amazon.EC2.Model.DescribeSecurityGroupsRequest

Container for the necessary parameters to execute the DescribeSecurityGroups service method.

Return Value

Type: DescribeSecurityGroupsResponse

The response from the DescribeSecurityGroups service method, as returned by EC2.

Examples

This example describes the specified security group.

To describe a security group


var client = new AmazonEC2Client();
var response = client.DescribeSecurityGroups(new DescribeSecurityGroupsRequest 
{
    GroupIds = new List<string> {
        "sg-903004f8"
    }
});

This example describes the security groups that include the specified tag (Purpose=test).

To describe a tagged security group


var client = new AmazonEC2Client();
var response = client.DescribeSecurityGroups(new DescribeSecurityGroupsRequest 
{
    Filters = new List<Filter> {
        new Filter {
            Name = "tag:Purpose",
            Values = new List<string> {
                "test"
            }
        }
    }
});

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

AmazonEC2Client.DescribeSecurityGroups (DescribeSecurityGroupsRequest)

Method