> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# EC2 Describe Security Groups

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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html) in the *Amazon Elastic Compute Cloud User Guide* and [Security groups for your VPC](https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html) in the *Amazon Virtual Private Cloud User Guide*.

<Note>
  External Documentation

  To learn more, visit the [AWS documentation](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSecurityGroups.html).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter     | Description                                                                                                                                                                                                                                                                                                         |
  | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | AWS Region(s) | Enter the desired AWS Region(s).<br /><br />To execute the action in multiple regions, provide a comma-separated list.<br />For example: `us-east-1,eu-west-2`.<br /><br />If you wish to run the action in all available regions, use the asterisk symbol (`*`) instead.                                           |
  | Group Names   | \[EC2-Classic and default VPC only] The names of the security groups. You can specify either the security group name or the security group ID. For security groups in a nondefault VPC, use the `group-name` filter to describe security groups by name.<br /><br />Default: Describes all of your security groups. |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Disable XML To JSON Auto Convert | When checked, XML responses are not automatically converted into JSON format.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | Dry Run                          | Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | Filters                          | The filters. If using multiple filters for rules, the results include security groups for which any combination of rules - not necessarily a single rule - match all filters.<br /><br />- `description` - The description of the security group.<br /><br />- `egress.ip-permission.cidr` - An IPv4 CIDR block for an outbound security group rule.<br /><br />- `egress.ip-permission.from-port` - For an outbound rule, the start of port range for the TCP and UDP protocols, or an ICMP type number.<br /><br />- `egress.ip-permission.group-id` - The ID of a security group that has been referenced in an outbound security group rule.<br /><br />- `egress.ip-permission.group-name` - The name of a security group that is referenced in an outbound security group rule.<br /><br />- `egress.ip-permission.ipv6-cidr` - An IPv6 CIDR block for an outbound security group rule.<br /><br />- `egress.ip-permission.prefix-list-id` - The ID of a prefix list to which a security group rule allows outbound access.<br /><br />- `egress.ip-permission.protocol` - The IP protocol for an outbound security group rule ( `tcp` \\ | `udp` \\ | `icmp`, a protocol number, or -1 for all protocols).<br /><br />- `egress.ip-permission.to-port` - For an outbound rule, the end of port range for the TCP and UDP protocols, or an ICMP code.<br /><br />- `egress.ip-permission.user-id` - The ID of an Amazon Web Services account that has been referenced in an outbound security group rule.<br /><br />- `group-id` - The ID of the security group.<br /><br />- `group-name` - The name of the security group.<br /><br />- `ip-permission.cidr` - An IPv4 CIDR block for an inbound security group rule.<br /><br />- `ip-permission.from-port` - For an inbound rule, the start of port range for the TCP and UDP protocols, or an ICMP type number.<br /><br />- `ip-permission.group-id` - The ID of a security group that has been referenced in an inbound security group rule.<br /><br />- `ip-permission.group-name` - The name of a security group that is referenced in an inbound security group rule.<br /><br />- `ip-permission.ipv6-cidr` - An IPv6 CIDR block for an inbound security group rule.<br /><br />- `ip-permission.prefix-list-id` - The ID of a prefix list from which a security group rule allows inbound access.<br /><br />- `ip-permission.protocol` - The IP protocol for an inbound security group rule ( `tcp` \\ | `udp` \\ | `icmp`, a protocol number, or -1 for all protocols).<br /><br />- `ip-permission.to-port` - For an inbound rule, the end of port range for the TCP and UDP protocols, or an ICMP code.<br /><br />- `ip-permission.user-id` - The ID of an Amazon Web Services account that has been referenced in an inbound security group rule.<br /><br />- `owner-id` - The Amazon Web Services account ID of the owner of the security group.<br /><br />- `tag`:\<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key `Owner` and the value `TeamA`, specify `tag:Owner` for the filter name and `TeamA` for the filter value.<br /><br />- `tag-key` - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.<br /><br />- `vpc-id` - The ID of the VPC specified when the security group was created. |
  | Group IDs                        | The IDs of the security groups. Required for security groups in a nondefault VPC.<br /><br />Default: Describes all of your security groups.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | Max Results                      | The maximum number of results to return in a single call. To retrieve the remaining results, make another request with the returned `NextToken` value. This value can be between 5 and 1000. If this parameter is not specified, then all results are returned.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | Next Token                       | The token to request the next page of results.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
</div>

## Example Output

```json theme={"dark"}
{
	"DescribeSecurityGroupsResponse": {
		"securityGroupInfo": {
			"item": [
				{
					"groupName": "<string>",
					"groupDescription": "<string>",
					"vpcId": "<string>",
					"ipPermissions": {
						"item": {
							"fromPort": "<string>",
							"toPort": "<string>",
							"groups": "<string>",
							"ipRanges": {
								"item": {
									"cidrIp": "<string>"
								}
							},
							"ipv6Ranges": {
								"item": {
									"cidrIpv6": "<string>"
								}
							},
							"prefixListIds": "<string>",
							"ipProtocol": "<string>"
						}
					},
					"ipPermissionsEgress": {
						"item": {
							"groups": "<string>",
							"ipRanges": {
								"item": {
									"cidrIp": "<string>"
								}
							},
							"ipv6Ranges": {
								"item": {
									"cidrIpv6": "<string>"
								}
							},
							"prefixListIds": "<string>",
							"ipProtocol": "<string>"
						}
					},
					"securityGroupArn": "<string>",
					"ownerId": "<string>",
					"groupId": "<string>"
				}
			]
		},
		"-xmlns": "<string>",
		"requestId": "<string>"
	}
}
```

## Workflow Library Example

[Upgrade Amazon Eks Cluster](https://library.blinkops.com/workflows/upgrade-amazon-eks-cluster)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/upgrade-amazon-eks-cluster/canvas" />
</div>