mirror of
https://github.com/thegeeklab/ansible-later.git
synced 2024-07-06 09:00:58 +02:00
138 lines
4.2 KiB
Python
138 lines
4.2 KiB
Python
#!/usr/bin/python
|
|
# Copyright: Ansible Project
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
from __future__ import absolute_import, division, print_function
|
|
__metaclass__ = type
|
|
|
|
|
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
|
'status': ['preview'],
|
|
'supported_by': 'community'}
|
|
|
|
DOCUMENTATION = '''
|
|
module: ec2_vpc_peering_facts
|
|
short_description: Retrieves AWS VPC Peering details using AWS methods.
|
|
description:
|
|
- Gets various details related to AWS VPC Peers
|
|
version_added: "2.4"
|
|
requirements: [ boto3 ]
|
|
options:
|
|
peer_connection_ids:
|
|
description:
|
|
- Get details of specific vpc peer IDs
|
|
filters:
|
|
description:
|
|
- A dict of filters to apply. Each dict item consists of a filter key and a filter value.
|
|
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVpcPeeringConnections.html)
|
|
for possible filters.
|
|
author: Karen Cheng (@Etherdaemon)
|
|
extends_documentation_fragment:
|
|
- aws
|
|
- ec2
|
|
'''
|
|
|
|
EXAMPLES = '''
|
|
# Simple example of listing all VPC Peers
|
|
- name: List all vpc peers
|
|
ec2_vpc_peering_facts:
|
|
region: ap-southeast-2
|
|
register: all_vpc_peers
|
|
|
|
- name: Debugging the result
|
|
debug:
|
|
msg: "{{ all_vpc_peers.result }}"
|
|
|
|
- name: Get details on specific VPC peer
|
|
ec2_vpc_peering_facts:
|
|
peer_connection_ids:
|
|
- pcx-12345678
|
|
- pcx-87654321
|
|
region: ap-southeast-2
|
|
register: all_vpc_peers
|
|
|
|
- name: Get all vpc peers with specific filters
|
|
ec2_vpc_peering_facts:
|
|
region: ap-southeast-2
|
|
filters:
|
|
status-code: ['pending-acceptance']
|
|
register: pending_vpc_peers
|
|
'''
|
|
|
|
RETURN = '''
|
|
result:
|
|
description: The result of the describe.
|
|
returned: success
|
|
type: list
|
|
'''
|
|
|
|
import json
|
|
|
|
try:
|
|
import botocore
|
|
except ImportError:
|
|
pass # will be picked up by imported HAS_BOTO3
|
|
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
from ansible.module_utils.ec2 import (ec2_argument_spec, boto3_conn, get_aws_connection_info,
|
|
ansible_dict_to_boto3_filter_list, HAS_BOTO3, camel_dict_to_snake_dict)
|
|
|
|
|
|
def date_handler(obj):
|
|
return obj.isoformat() if hasattr(obj, 'isoformat') else obj
|
|
|
|
|
|
def get_vpc_peers(client, module):
|
|
params = dict()
|
|
params['Filters'] = ansible_dict_to_boto3_filter_list(module.params.get('filters'))
|
|
if module.params.get('peer_connection_ids'):
|
|
params['VpcPeeringConnectionIds'] = module.params.get('peer_connection_ids')
|
|
try:
|
|
result = json.loads(json.dumps(client.describe_vpc_peering_connections(**params), default=date_handler))
|
|
except Exception as e:
|
|
module.fail_json(msg=str(e.message))
|
|
|
|
return result['VpcPeeringConnections']
|
|
|
|
|
|
def main():
|
|
argument_spec = ec2_argument_spec()
|
|
argument_spec.update(
|
|
dict(
|
|
filters=dict(default=dict(), type='dict'),
|
|
peer_connection_ids=dict(default=None, type='list'),
|
|
)
|
|
)
|
|
|
|
module = AnsibleModule(argument_spec=argument_spec,
|
|
supports_check_mode=True)
|
|
|
|
# Validate Requirements
|
|
if not HAS_BOTO3:
|
|
module.fail_json(msg='botocore and boto3 are required.')
|
|
|
|
try:
|
|
region, ec2_url, aws_connect_kwargs = get_aws_connection_info(module, boto3=True)
|
|
except NameError as e:
|
|
# Getting around the get_aws_connection_info boto reliance for region
|
|
if "global name 'boto' is not defined" in e.message:
|
|
module.params['region'] = botocore.session.get_session().get_config_variable('region')
|
|
if not module.params['region']:
|
|
module.fail_json(msg="Error - no region provided")
|
|
else:
|
|
module.fail_json(msg="Can't retrieve connection information - " + str(e))
|
|
|
|
try:
|
|
region, ec2_url, aws_connect_kwargs = get_aws_connection_info(module, boto3=True)
|
|
ec2 = boto3_conn(module, conn_type='client', resource='ec2', region=region, endpoint=ec2_url, **aws_connect_kwargs)
|
|
except botocore.exceptions.NoCredentialsError as e:
|
|
module.fail_json(msg=str(e))
|
|
|
|
results = [camel_dict_to_snake_dict(peer) for peer in get_vpc_peers(ec2, module)]
|
|
|
|
module.exit_json(result=results)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|