ec2-describe_vpcs
Retrieve and filter VPC information for network planning, security auditing, and infrastructure management in AWS environments.
Instructions
Retrieve comprehensive VPC information with advanced filtering for network infrastructure analysis.
This tool provides complete VPC data including CIDR blocks, DNS settings, tenancy, and associated
resources. Essential for network planning, security auditing, and infrastructure management.
**Required Parameters:**
- profile_name (str): AWS profile name from ~/.aws/credentials
- region (str): AWS region (e.g., 'us-east-1', 'eu-west-1')
**Optional Parameters:**
- vpc_ids (List[str]): Specific VPC IDs to retrieve
Example: ['vpc-12345678', 'vpc-87654321']
- filters (Dict[str, Any]): Advanced filtering options
**State Filters:**
- 'state': ['pending', 'available'] - Filter by VPC state
**Network Configuration:**
- 'cidr': ['10.0.0.0/16', '172.16.0.0/12'] - Filter by primary CIDR block
- 'cidr-block-association.cidr-block': ['10.1.0.0/16'] - Filter by any CIDR block
- 'cidr-block-association.state': ['associated', 'associating', 'disassociated']
**DNS and Networking:**
- 'dhcp-options-id': ['dopt-12345678'] - Filter by DHCP options set
- 'dns-resolution': ['true', 'false'] - Filter by DNS resolution support
- 'dns-hostnames': ['true', 'false'] - Filter by DNS hostnames support
**Default VPC:**
- 'is-default': ['true', 'false'] - Filter default vs custom VPCs
**Tenancy:**
- 'instance-tenancy': ['default', 'dedicated', 'host'] - Filter by instance tenancy
**Ownership:**
- 'owner-id': ['123456789012'] - Filter by AWS account ID
**Tag Filters:**
- 'tag:Name': ['production-vpc', 'staging-vpc'] - Filter by Name tag
- 'tag:Environment': ['production', 'staging'] - Filter by Environment tag
- 'tag-key': ['Owner'] - Filter by tag key existence
- max_results (int): Limit results (5-1000). Default: no limit
- next_token (str): Pagination token from previous request
**Common Use Cases:**
1. Find default VPC: filters={'is-default': ['true']}
2. List production VPCs: filters={'tag:Environment': ['production']}
3. Find VPCs with specific CIDR: filters={'cidr': ['10.0.0.0/16']}
4. Audit DNS settings: filters={'dns-resolution': ['true']}
5. Check tenancy: filters={'instance-tenancy': ['dedicated']}
**Response includes:** VPC ID, state, CIDR blocks, DNS resolution settings, DHCP options,
instance tenancy, default VPC flag, owner ID, tags, and associated CIDR block associations.
Critical for network architecture planning and security compliance auditing.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | Yes | ||
| profile_name | No | default | |
| vpc_ids | No | ||
| filters | No | ||
| max_results | No | ||
| next_token | No |