ec2_vpc_address_info – List EC2 VPC addresses¶
Retrieve information about AWS EC2 VPC addresses.
Examples¶
- name: List all VPC addresses in a region
ec2_vpc_address_info:
register: result
- name: List specific VPC addresses
ec2_vpc_address_info:
ips:
- 3.21.120.93
- 3.22.108.97
register: result
See Also¶
Parameters¶
- auth (optional)
Parameters for authenticating with the AWS service. Each of them may be defined via environment variables.
type: dict- access_key (optional)
The AWS access key ID. If not set, the value of the AWS_ACCESS_KEY environment variable will be checked.
Mutually exclusive with profile.
type: str- profile (optional)
The name of the AWS profile configured with
aws configure
.Can be used instead of explicitly specifying your access credentials and region.
Use
default
to use the default profile.Mutually exclusive with access_key and secret_key.
type: str- region (optional)
The name of the AWS region.
If not set, the value of the AWS_REGION environment variable will be checked.
If you set a profile that specifies a default region, that region is used and you can omit this parameter. Use this parameter to override the profile’s default region.
type: str- secret_key (optional)
The AWS secret access key. If not set, the value of the AWS_SECRET_KEY environment variable will be checked.
Mutually exclusive with profile.
type: str- url (optional)
The URL to the AWS service related to the resource. By default, this is automatically determined through the region parameter.
If not set explicitly, the value of the AWS_<SERVICE>_URL environment variable will be used.
The services currently supported are EC2 and S3.
type: str
- ips (optional)
Limit results to the specified VPC addresses only
type: list
Return Values¶
- objects (success), list,
A list of objects representing EC2 VPC addresses.
- ip (always), str, 3.20.251.70
The Elastic IP address.
- allocation_id (always), str, eipalloc-04bed816a62ae64b1
Allocation ID of the VPC address.
- network_interface (always), str, eni-0a6d3406ea74e7bab
ID of the network interface VPC address is associated with.
- instance (always), str, i-0c79884ded545df1a, None
ID of the instance to which the network interface associated with the VPC address is attached (if any).
- tags (always), dict, {‘Name’: ‘my-vpc-address’}
Tags associated with the internet gateway.