@@ -45,6 +45,9 @@ Ansible Changes By Release

   module is deprecated and slated to go away in 2.8.  The functionality has been

   moved to `ansible.utils.unsafe_proxy` to avoid a circular import.

+#### Deprecated Modules:

+* ec2_facts (removed in 2.7), replaced by ec2_metadata_facts

+

 ### Minor Changes

 * removed previously deprecated config option `hostfile` and env var `ANSIBLE_HOSTS`

 * removed unused and deprecated config option `pattern`

@@ -109,6 +112,7 @@ Ansible Changes By Release

 - aix_lvol

 - amazon

+  * ec2_metadata_facts

   * ec2_vpc_endpoint

   * iam_cert_facts

   * lightsail

new file mode 120000

@@ -0,0 +1 @@

+ec2_metadata_facts.py

\ No newline at end of file

deleted file mode 100644

@@ -1,549 +0,0 @@

-#!/usr/bin/python

-# -*- coding: utf-8 -*-

-

-# This file is part of Ansible

-#

-# Ansible is free software: you can redistribute it and/or modify

-# it under the terms of the GNU General Public License as published by

-# the Free Software Foundation, either version 3 of the License, or

-# (at your option) any later version.

-#

-# Ansible is distributed in the hope that it will be useful,

-# but WITHOUT ANY WARRANTY; without even the implied warranty of

-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

-# GNU General Public License for more details.

-#

-# You should have received a copy of the GNU General Public License

-# along with Ansible.  If not, see <http://www.gnu.org/licenses/>.

-

-ANSIBLE_METADATA = {'metadata_version': '1.0',

-                    'status': ['stableinterface'],

-                    'supported_by': 'curated'}

-

-

-DOCUMENTATION = '''

-module: ec2_facts

-short_description: Gathers facts (instance metadata) about remote hosts within ec2

-version_added: "1.0"

-author:

-    - Silviu Dicu (@silviud)

-    - Vinay Dandekar (@roadmapper)

-description:

-    - This module fetches data from the instance metadata endpoint in ec2 as per

-      http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html.

-      The module must be called from within the EC2 instance itself.

-notes:

-    - Parameters to filter on ec2_facts may be added later.

-'''

-

-EXAMPLES = '''

-# Gather EC2 facts

-- ec2_facts:

-

-- debug:

-    msg: "This instance is a t1.micro"

-  when: ansible_ec2_instance_type == "t1.micro"

-'''

-

-RETURN = '''

-ansible_facts:

-    description: Dictionary of new facts representing discovered properties of the EC2 instance.

-    returned: changed

-    type: complex

-    contains:

-        ansible_ec2_ami_id:

-            description: The AMI ID used to launch the instance.

-            type: string

-            sample: "ami-XXXXXXXX"

-        ansible_ec2_ami_launch_index:

-            description:

-                - If you started more than one instance at the same time, this value indicates the order in which the instance was launched.

-                  The value of the first instance launched is 0.

-            type: string

-            sample: "0"

-        ansible_ec2_ami_manifest_path:

-            description:

-                - The path to the AMI manifest file in Amazon S3.

-                  If you used an Amazon EBS-backed AMI to launch the instance, the returned result is unknown.

-            type: string

-            sample: "(unknown)"

-        ansible_ec2_ancestor_ami_ids:

-            description:

-                - The AMI IDs of any instances that were rebundled to create this AMI.

-                  This value will only exist if the AMI manifest file contained an ancestor-amis key.

-            type: string

-            sample: "(unknown)"

-        ansible_ec2_block_device_mapping_ami:

-            description: The virtual device that contains the root/boot file system.

-            type: string

-            sample: "/dev/sda1"

-        ansible_ec2_block_device_mapping_ebsN:

-            description:

-                - The virtual devices associated with Amazon EBS volumes, if any are present.

-                  Amazon EBS volumes are only available in metadata if they were present at launch time or when the instance was last started.

-                  The N indicates the index of the Amazon EBS volume (such as ebs1 or ebs2).

-            type: string

-            sample: "/dev/xvdb"

-        ansible_ec2_block_device_mapping_ephemeralN:

-            description: The virtual devices associated with ephemeral devices, if any are present. The N indicates the index of the ephemeral volume.

-            type: string

-            sample: "/dev/xvdc"

-        ansible_ec2_block_device_mapping_root:

-            description:

-                - The virtual devices or partitions associated with the root devices, or partitions on the virtual device,

-                  where the root (/ or C) file system is associated with the given instance.

-            type: string

-            sample: "/dev/sda1"

-        ansible_ec2_block_device_mapping_swap:

-            description: The virtual devices associated with swap. Not always present.

-            type: string

-            sample: "/dev/sda2"

-        ansible_ec2_fws_instance_monitoring:

-            description: "Value showing whether the customer has enabled detailed one-minute monitoring in CloudWatch."

-            type: string

-            sample: "enabled"

-        ansible_ec2_hostname:

-            description:

-                - The private IPv4 DNS hostname of the instance.

-                  In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0).

-            type: string

-            sample: "ip-10-0-0-1.ec2.internal"

-        ansible_ec2_iam_info:

-            description:

-                - If there is an IAM role associated with the instance, contains information about the last time the instance profile was updated,

-                  including the instance's LastUpdated date, InstanceProfileArn, and InstanceProfileId. Otherwise, not present.

-            type: complex

-            sample: ""

-        ansible_ec2_iam_info_instanceprofilearn:

-            description: The IAM instance profile ARN.

-            type: string

-            sample: "arn:aws:iam::<account id>:instance-profile/<role name>"

-        ansible_ec2_iam_info_instanceprofileid:

-            description: IAM instance profile ID.

-            type: string

-            sample: ""

-        ansible_ec2_iam_info_lastupdated:

-            description: IAM info last updated time.

-            type: string

-            sample: "2017-05-12T02:42:27Z"

-        ansible_ec2_iam_instance_profile_role:

-            description: IAM instance role.

-            type: string

-            sample: "role_name"

-        ansible_ec2_iam_security_credentials_<role name>:

-            description:

-                - If there is an IAM role associated with the instance, role-name is the name of the role,

-                  and role-name contains the temporary security credentials associated with the role. Otherwise, not present.

-            type: string

-            sample: ""

-        ansible_ec2_iam_security_credentials_<role name>_accesskeyid:

-            description: IAM role access key ID.

-            type: string

-            sample: ""

-        ansible_ec2_iam_security_credentials_<role name>_code:

-            description: IAM code.

-            type: string

-            sample: "Success"

-        ansible_ec2_iam_security_credentials_<role name>_expiration:

-            description: IAM role credentials expiration time.

-            type: string

-            sample: "2017-05-12T09:11:41Z"

-        ansible_ec2_iam_security_credentials_<role name>_lastupdated:

-            description: IAM role last updated time.

-            type: string

-            sample: "2017-05-12T02:40:44Z"

-        ansible_ec2_iam_security_credentials_<role name>_secretaccesskey:

-            description: IAM role secret access key.

-            type: string

-            sample: ""

-        ansible_ec2_iam_security_credentials_<role name>_token:

-            description: IAM role token.

-            type: string

-            sample: ""

-        ansible_ec2_iam_security_credentials_<role name>_type:

-            description: IAM role type.

-            type: string

-            sample: "AWS-HMAC"

-        ansible_ec2_instance_action:

-            description: Notifies the instance that it should reboot in preparation for bundling.

-            type: string

-            sample: "none"

-        ansible_ec2_instance_id:

-            description: The ID of this instance.

-            type: string

-            sample: "i-XXXXXXXXXXXXXXXXX"

-        ansible_ec2_instance_identity_document:

-            description: JSON containing instance attributes, such as instance-id, private IP address, etc.

-            type: string

-            sample: ""

-        ansible_ec2_instance_identity_document_accountid:

-            description: ""

-            type: string

-            sample: "012345678901"

-        ansible_ec2_instance_identity_document_architecture:

-            description: Instance system architecture.

-            type: string

-            sample: "x86_64"

-        ansible_ec2_instance_identity_document_availabilityzone:

-            description: The Availability Zone in which the instance launched.

-            type: string

-            sample: "us-east-1a"

-        ansible_ec2_instance_identity_document_billingproducts:

-            description: Billing products for this instance.

-            type: string

-            sample: ""

-        ansible_ec2_instance_identity_document_devpayproductcodes:

-            description: Product codes for the launched AMI.

-            type: string

-            sample: ""

-        ansible_ec2_instance_identity_document_imageid:

-            description: The AMI ID used to launch the instance.

-            type: string

-            sample: "ami-01234567"

-        ansible_ec2_instance_identity_document_instanceid:

-            description: The ID of this instance.

-            type: string

-            sample: "i-0123456789abcdef0"

-        ansible_ec2_instance_identity_document_instancetype:

-            description: The type of instance.

-            type: string

-            sample: "m4.large"

-        ansible_ec2_instance_identity_document_kernelid:

-            description: The ID of the kernel launched with this instance, if applicable.

-            type: string

-            sample: ""

-        ansible_ec2_instance_identity_document_pendingtime:

-            description: The instance pending time.

-            type: string

-            sample: "2017-05-11T20:51:20Z"

-        ansible_ec2_instance_identity_document_privateip:

-            description:

-                - The private IPv4 address of the instance.

-                  In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0).

-            type: string

-            sample: "10.0.0.1"

-        ansible_ec2_instance_identity_document_ramdiskid:

-            description: The ID of the RAM disk specified at launch time, if applicable.

-            type: string

-            sample: ""

-        ansible_ec2_instance_identity_document_region:

-            description: The Region in which the instance launched.

-            type: string

-            sample: "us-east-1"

-        ansible_ec2_instance_identity_document_version:

-            description: Identity document version.

-            type: string

-            sample: "2010-08-31"

-        ansible_ec2_instance_identity_pkcs7:

-            description: Used to verify the document's authenticity and content against the signature.

-            type: string

-            sample: ""

-        ansible_ec2_instance_identity_rsa2048:

-            description: Used to verify the document's authenticity and content against the signature.

-            type: string

-            sample: ""

-        ansible_ec2_instance_identity_signature:

-            description: Data that can be used by other parties to verify its origin and authenticity.

-            type: string

-            sample: ""

-        ansible_ec2_instance_type:

-            description: The type of instance.

-            type: string

-            sample: "m4.large"

-        ansible_ec2_local_hostname:

-            description:

-                - The private IPv4 DNS hostname of the instance.

-                  In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0).

-            type: string

-            sample: "ip-10-0-0-1.ec2.internal"

-        ansible_ec2_local_ipv4:

-            description:

-                - The private IPv4 address of the instance.

-                  In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0).

-            type: string

-            sample: "10.0.0.1"

-        ansible_ec2_mac:

-            description:

-                - The instance's media access control (MAC) address.

-                  In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0).

-            type: string

-            sample: "00:11:22:33:44:55"

-        ansible_ec2_metrics_vhostmd:

-            description: Metrics.

-            type: string

-            sample: ""

-        ansible_ec2_network_interfaces_macs_<mac address>_device_number:

-            description:

-                - The unique device number associated with that interface. The device number corresponds to the device name;

-                  for example, a device-number of 2 is for the eth2 device.

-                  This category corresponds to the DeviceIndex and device-index fields that are used by the Amazon EC2 API and the EC2 commands for the AWS CLI.

-            type: string

-            sample: "0"

-        ansible_ec2_network_interfaces_macs_<mac address>_interface_id:

-            description: The elastic network interface ID.

-            type: string

-            sample: "eni-12345678"

-        ansible_ec2_network_interfaces_macs_<mac address>_ipv4_associations_<ip address>:

-            description: The private IPv4 addresses that are associated with each public-ip address and assigned to that interface.

-            type: string

-            sample: ""

-        ansible_ec2_network_interfaces_macs_<mac address>_ipv6s:

-            description: The IPv6 addresses associated with the interface. Returned only for instances launched into a VPC.

-            type: string

-            sample: ""

-        ansible_ec2_network_interfaces_macs_<mac address>_local_hostname:

-            description: The interface's local hostname.

-            type: string

-            sample: ""

-        ansible_ec2_network_interfaces_macs_<mac address>_local_ipv4s:

-            description: The private IPv4 addresses associated with the interface.

-            type: string

-            sample: ""

-        ansible_ec2_network_interfaces_macs_<mac address>_mac:

-            description: The instance's MAC address.

-            type: string

-            sample: "00:11:22:33:44:55"

-        ansible_ec2_network_interfaces_macs_<mac address>_owner_id:

-            description:

-                - The ID of the owner of the network interface.

-                  In multiple-interface environments, an interface can be attached by a third party, such as Elastic Load Balancing.

-                  Traffic on an interface is always billed to the interface owner.

-            type: string

-            sample: "01234567890"

-        ansible_ec2_network_interfaces_macs_<mac address>_public_hostname:

-            description:

-                - The interface's public DNS (IPv4). If the instance is in a VPC,

-                  this category is only returned if the enableDnsHostnames attribute is set to true.

-            type: string

-            sample: "ec2-1-2-3-4.compute-1.amazonaws.com"

-        ansible_ec2_network_interfaces_macs_<mac address>_public_ipv4s:

-            description: The Elastic IP addresses associated with the interface. There may be multiple IPv4 addresses on an instance.

-            type: string

-            sample: "1.2.3.4"

-        ansible_ec2_network_interfaces_macs_<mac address>_security_group_ids:

-            description: The IDs of the security groups to which the network interface belongs. Returned only for instances launched into a VPC.

-            type: string

-            sample: "sg-01234567,sg-01234568"

-        ansible_ec2_network_interfaces_macs_<mac address>_security_groups:

-            description: Security groups to which the network interface belongs. Returned only for instances launched into a VPC.

-            type: string

-            sample: "secgroup1,secgroup2"

-        ansible_ec2_network_interfaces_macs_<mac address>_subnet_id:

-            description: The ID of the subnet in which the interface resides. Returned only for instances launched into a VPC.

-            type: string

-            sample: "subnet-01234567"

-        ansible_ec2_network_interfaces_macs_<mac address>_subnet_ipv4_cidr_block:

-            description: The IPv4 CIDR block of the subnet in which the interface resides. Returned only for instances launched into a VPC.

-            type: string

-            sample: "10.0.1.0/24"

-        ansible_ec2_network_interfaces_macs_<mac address>_subnet_ipv6_cidr_blocks:

-            description: The IPv6 CIDR block of the subnet in which the interface resides. Returned only for instances launched into a VPC.

-            type: string

-            sample: ""

-        ansible_ec2_network_interfaces_macs_<mac address>_vpc_id:

-            description: The ID of the VPC in which the interface resides. Returned only for instances launched into a VPC.

-            type: string

-            sample: "vpc-0123456"

-        ansible_ec2_network_interfaces_macs_<mac address>_vpc_ipv4_cidr_block:

-            description: The IPv4 CIDR block of the VPC in which the interface resides. Returned only for instances launched into a VPC.

-            type: string

-            sample: "10.0.0.0/16"

-        ansible_ec2_network_interfaces_macs_<mac address>_vpc_ipv4_cidr_blocks:

-            description: The IPv4 CIDR block of the VPC in which the interface resides. Returned only for instances launched into a VPC.

-            type: string

-            sample: "10.0.0.0/16"

-        ansible_ec2_network_interfaces_macs_<mac address>_vpc_ipv6_cidr_blocks:

-            description: The IPv6 CIDR block of the VPC in which the interface resides. Returned only for instances launched into a VPC.

-            type: string

-            sample: ""

-        ansible_ec2_placement_availability_zone:

-            description: The Availability Zone in which the instance launched.

-            type: string

-            sample: "us-east-1a"

-        ansible_ec2_placement_region:

-            description: The Region in which the instance launched.

-            type: string

-            sample: "us-east-1"

-        ansible_ec2_product_codes:

-            description: Product codes associated with the instance, if any.

-            type: string

-            sample: "aw0evgkw8e5c1q413zgy5pjce"

-        ansible_ec2_profile:

-            description: EC2 instance hardware profile.

-            type: string

-            sample: "default-hvm"

-        ansible_ec2_public_hostname:

-            description:

-                - The instance's public DNS. If the instance is in a VPC, this category is only returned if the enableDnsHostnames attribute is set to true.

-            type: string

-            sample: "ec2-1-2-3-4.compute-1.amazonaws.com"

-        ansible_ec2_public_ipv4:

-            description: The public IPv4 address. If an Elastic IP address is associated with the instance, the value returned is the Elastic IP address.

-            type: string

-            sample: "1.2.3.4"

-        ansible_ec2_public_key:

-            description: Public key. Only available if supplied at instance launch time.

-            type: string

-            sample: ""

-        ansible_ec2_ramdisk_id:

-            description: The ID of the RAM disk specified at launch time, if applicable.

-            type: string

-            sample: ""

-        ansible_ec2_reservation_id:

-            description: The ID of the reservation.

-            type: string

-            sample: "r-0123456789abcdef0"

-        ansible_ec2_security_groups:

-            description:

-                - The names of the security groups applied to the instance. After launch, you can only change the security groups of instances running in a VPC.

-                  Such changes are reflected here and in network/interfaces/macs/mac/security-groups.

-            type: string

-            sample: "securitygroup1,securitygroup2"

-        ansible_ec2_services_domain:

-            description: The domain for AWS resources for the region; for example, amazonaws.com for us-east-1.

-            type: string

-            sample: "amazonaws.com"

-        ansible_ec2_services_partition:

-            description:

-                - The partition that the resource is in. For standard AWS regions, the partition is aws.

-                  If you have resources in other partitions, the partition is aws-partitionname.

-                  For example, the partition for resources in the China (Beijing) region is aws-cn.

-            type: string

-            sample: "aws"

-        ansible_ec2_spot_termination_time:

-            description:

-                - The approximate time, in UTC, that the operating system for your Spot instance will receive the shutdown signal.

-                  This item is present and contains a time value only if the Spot instance has been marked for termination by Amazon EC2.

-                  The termination-time item is not set to a time if you terminated the Spot instance yourself.

-            type: string

-            sample: "2015-01-05T18:02:00Z"

-        ansible_ec2_user_data:

-            description: The instance user data.

-            type: string

-            sample: "#!/bin/bash"

-'''

-

-import socket

-import re

-import json

-

-from ansible.module_utils._text import to_text

-from ansible.module_utils.basic import AnsibleModule

-from ansible.module_utils.urls import fetch_url, url_argument_spec

-

-socket.setdefaulttimeout(5)

-

-

-class Ec2Metadata(object):

-    ec2_metadata_uri = 'http://169.254.169.254/latest/meta-data/'

-    ec2_sshdata_uri = 'http://169.254.169.254/latest/meta-data/public-keys/0/openssh-key'

-    ec2_userdata_uri = 'http://169.254.169.254/latest/user-data/'

-    ec2_dynamicdata_uri = 'http://169.254.169.254/latest/dynamic/'

-

-    def __init__(self, module, ec2_metadata_uri=None, ec2_sshdata_uri=None, ec2_userdata_uri=None, ec2_dynamicdata_uri=None):

-        self.module = module

-        self.uri_meta = ec2_metadata_uri or self.ec2_metadata_uri

-        self.uri_user = ec2_userdata_uri or self.ec2_userdata_uri

-        self.uri_ssh = ec2_sshdata_uri or self.ec2_sshdata_uri

-        self.uri_dynamic = ec2_dynamicdata_uri or self.ec2_dynamicdata_uri

-        self._data = {}

-        self._prefix = 'ansible_ec2_%s'

-

-    def _fetch(self, url):

-        (response, info) = fetch_url(self.module, url, force=True)

-        if response:

-            data = response.read()

-        else:

-            data = None

-        return to_text(data)

-

-    def _mangle_fields(self, fields, uri, filter_patterns=['public-keys-0']):

-        new_fields = {}

-        for key, value in fields.items():

-            split_fields = key[len(uri):].split('/')

-            if len(split_fields) == 3 and split_fields[0:2] == ['iam', 'security-credentials'] and '_' not in split_fields[2]:

-                new_fields[self._prefix % "iam-instance-profile-role"] = split_fields[2]

-            if len(split_fields) > 1 and split_fields[1]:

-                new_key = "-".join(split_fields)

-                new_fields[self._prefix % new_key] = value

-            else:

-                new_key = "".join(split_fields)

-                new_fields[self._prefix % new_key] = value

-        for pattern in filter_patterns:

-            for key in dict(new_fields):

-                match = re.search(pattern, key)

-                if match:

-                    new_fields.pop(key)

-        return new_fields

-

-    def fetch(self, uri, recurse=True):

-        raw_subfields = self._fetch(uri)

-        if not raw_subfields:

-            return

-        subfields = raw_subfields.split('\n')

-        for field in subfields:

-            if field.endswith('/') and recurse:

-                self.fetch(uri + field)

-            if uri.endswith('/'):

-                new_uri = uri + field

-            else:

-                new_uri = uri + '/' + field

-            if new_uri not in self._data and not new_uri.endswith('/'):

-                content = self._fetch(new_uri)

-                if field == 'security-groups' or field == 'security-group-ids':

-                    sg_fields = ",".join(content.split('\n'))

-                    self._data['%s' % (new_uri)] = sg_fields

-                else:

-                    try:

-                        dict = json.loads(content)

-                        self._data['%s' % (new_uri)] = content

-                        for (key, value) in dict.items():

-                            self._data['%s_%s' % (new_uri, key.lower())] = value

-                    except:

-                        self._data['%s' % (new_uri)] = content  # not a stringifed JSON string

-

-    def fix_invalid_varnames(self, data):

-        """Change ':'' and '-' to '_' to ensure valid template variable names"""

-        new_data = data.copy()

-        for key, value in data.items():

-            if ':' in key or '-' in key:

-                newkey = re.sub(':|-', '_', key)

-                new_data[newkey] = value

-                del new_data[key]

-

-        return new_data

-

-    def run(self):

-        self.fetch(self.uri_meta)  # populate _data with metadata

-        data = self._mangle_fields(self._data, self.uri_meta)

-        data[self._prefix % 'user-data'] = self._fetch(self.uri_user)

-        data[self._prefix % 'public-key'] = self._fetch(self.uri_ssh)

-

-        self._data = {}  # clear out metadata in _data

-        self.fetch(self.uri_dynamic)  # populate _data with dynamic data

-        dyndata = self._mangle_fields(self._data, self.uri_dynamic)

-        data.update(dyndata)

-        data = self.fix_invalid_varnames(data)

-

-        # Maintain old key for backwards compatibility

-        data['ansible_ec2_placement_region'] = data['ansible_ec2_instance_identity_document_region']

-        return data

-

-

-def main():

-    argument_spec = url_argument_spec()

-

-    module = AnsibleModule(

-        argument_spec=argument_spec,

-        supports_check_mode=True,

-    )

-

-    ec2_facts = Ec2Metadata(module).run()

-    ec2_facts_result = dict(changed=False, ansible_facts=ec2_facts)

-

-    module.exit_json(**ec2_facts_result)

-

-

-if __name__ == '__main__':

-    main()

new file mode 100644

@@ -0,0 +1,552 @@

+#!/usr/bin/python

+# -*- coding: utf-8 -*-

+

+# This file is part of Ansible

+#

+# Ansible is free software: you can redistribute it and/or modify

+# it under the terms of the GNU General Public License as published by

+# the Free Software Foundation, either version 3 of the License, or

+# (at your option) any later version.

+#

+# Ansible is distributed in the hope that it will be useful,

+# but WITHOUT ANY WARRANTY; without even the implied warranty of

+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+# GNU General Public License for more details.

+#

+# You should have received a copy of the GNU General Public License

+# along with Ansible.  If not, see <http://www.gnu.org/licenses/>.

+

+ANSIBLE_METADATA = {'metadata_version': '1.0',

+                    'status': ['stableinterface'],

+                    'supported_by': 'curated'}

+

+

+DOCUMENTATION = '''

+---

+module: ec2_metadata_facts

+short_description: Gathers facts (instance metadata) about remote hosts within ec2

+version_added: "1.0"

+author:

+    - Silviu Dicu (@silviud)

+    - Vinay Dandekar (@roadmapper)

+description:

+    - This module fetches data from the instance metadata endpoint in ec2 as per

+      http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html.

+      The module must be called from within the EC2 instance itself.

+notes:

+    - Parameters to filter on ec2_metadata_facts may be added later.

+'''

+

+EXAMPLES = '''

+# Gather EC2 metadata facts

+- ec2_metadata_facts:

+

+- debug:

+    msg: "This instance is a t1.micro"

+  when: ansible_ec2_instance_type == "t1.micro"

+'''

+

+RETURN = '''

+ansible_facts:

+    description: Dictionary of new facts representing discovered properties of the EC2 instance.

+    returned: changed

+    type: complex

+    contains:

+        ansible_ec2_ami_id:

+            description: The AMI ID used to launch the instance.

+            type: string

+            sample: "ami-XXXXXXXX"

+        ansible_ec2_ami_launch_index:

+            description:

+                - If you started more than one instance at the same time, this value indicates the order in which the instance was launched.

+                  The value of the first instance launched is 0.

+            type: string

+            sample: "0"

+        ansible_ec2_ami_manifest_path:

+            description:

+                - The path to the AMI manifest file in Amazon S3.

+                  If you used an Amazon EBS-backed AMI to launch the instance, the returned result is unknown.

+            type: string

+            sample: "(unknown)"

+        ansible_ec2_ancestor_ami_ids:

+            description:

+                - The AMI IDs of any instances that were rebundled to create this AMI.

+                  This value will only exist if the AMI manifest file contained an ancestor-amis key.

+            type: string

+            sample: "(unknown)"

+        ansible_ec2_block_device_mapping_ami:

+            description: The virtual device that contains the root/boot file system.

+            type: string

+            sample: "/dev/sda1"

+        ansible_ec2_block_device_mapping_ebsN:

+            description:

+                - The virtual devices associated with Amazon EBS volumes, if any are present.

+                  Amazon EBS volumes are only available in metadata if they were present at launch time or when the instance was last started.

+                  The N indicates the index of the Amazon EBS volume (such as ebs1 or ebs2).

+            type: string

+            sample: "/dev/xvdb"

+        ansible_ec2_block_device_mapping_ephemeralN:

+            description: The virtual devices associated with ephemeral devices, if any are present. The N indicates the index of the ephemeral volume.

+            type: string

+            sample: "/dev/xvdc"

+        ansible_ec2_block_device_mapping_root:

+            description:

+                - The virtual devices or partitions associated with the root devices, or partitions on the virtual device,

+                  where the root (/ or C) file system is associated with the given instance.

+            type: string

+            sample: "/dev/sda1"

+        ansible_ec2_block_device_mapping_swap:

+            description: The virtual devices associated with swap. Not always present.

+            type: string

+            sample: "/dev/sda2"

+        ansible_ec2_fws_instance_monitoring:

+            description: "Value showing whether the customer has enabled detailed one-minute monitoring in CloudWatch."

+            type: string

+            sample: "enabled"

+        ansible_ec2_hostname:

+            description:

+                - The private IPv4 DNS hostname of the instance.

+                  In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0).

+            type: string

+            sample: "ip-10-0-0-1.ec2.internal"

+        ansible_ec2_iam_info:

+            description:

+                - If there is an IAM role associated with the instance, contains information about the last time the instance profile was updated,

+                  including the instance's LastUpdated date, InstanceProfileArn, and InstanceProfileId. Otherwise, not present.

+            type: complex

+            sample: ""

+        ansible_ec2_iam_info_instanceprofilearn:

+            description: The IAM instance profile ARN.

+            type: string

+            sample: "arn:aws:iam::<account id>:instance-profile/<role name>"

+        ansible_ec2_iam_info_instanceprofileid:

+            description: IAM instance profile ID.

+            type: string

+            sample: ""

+        ansible_ec2_iam_info_lastupdated:

+            description: IAM info last updated time.

+            type: string

+            sample: "2017-05-12T02:42:27Z"

+        ansible_ec2_iam_instance_profile_role:

+            description: IAM instance role.

+            type: string

+            sample: "role_name"

+        ansible_ec2_iam_security_credentials_<role name>:

+            description:

+                - If there is an IAM role associated with the instance, role-name is the name of the role,

+                  and role-name contains the temporary security credentials associated with the role. Otherwise, not present.

+            type: string

+            sample: ""

+        ansible_ec2_iam_security_credentials_<role name>_accesskeyid:

+            description: IAM role access key ID.

+            type: string

+            sample: ""

+        ansible_ec2_iam_security_credentials_<role name>_code:

+            description: IAM code.

+            type: string

+            sample: "Success"

+        ansible_ec2_iam_security_credentials_<role name>_expiration:

+            description: IAM role credentials expiration time.

+            type: string

+            sample: "2017-05-12T09:11:41Z"

+        ansible_ec2_iam_security_credentials_<role name>_lastupdated:

+            description: IAM role last updated time.

+            type: string

+            sample: "2017-05-12T02:40:44Z"

+        ansible_ec2_iam_security_credentials_<role name>_secretaccesskey:

+            description: IAM role secret access key.

+            type: string

+            sample: ""

+        ansible_ec2_iam_security_credentials_<role name>_token:

+            description: IAM role token.

+            type: string

+            sample: ""

+        ansible_ec2_iam_security_credentials_<role name>_type:

+            description: IAM role type.

+            type: string

+            sample: "AWS-HMAC"

+        ansible_ec2_instance_action:

+            description: Notifies the instance that it should reboot in preparation for bundling.

+            type: string

+            sample: "none"

+        ansible_ec2_instance_id:

+            description: The ID of this instance.

+            type: string

+            sample: "i-XXXXXXXXXXXXXXXXX"

+        ansible_ec2_instance_identity_document:

+            description: JSON containing instance attributes, such as instance-id, private IP address, etc.

+            type: string

+            sample: ""

+        ansible_ec2_instance_identity_document_accountid:

+            description: ""

+            type: string

+            sample: "012345678901"

+        ansible_ec2_instance_identity_document_architecture:

+            description: Instance system architecture.

+            type: string

+            sample: "x86_64"

+        ansible_ec2_instance_identity_document_availabilityzone:

+            description: The Availability Zone in which the instance launched.

+            type: string

+            sample: "us-east-1a"

+        ansible_ec2_instance_identity_document_billingproducts:

+            description: Billing products for this instance.

+            type: string

+            sample: ""

+        ansible_ec2_instance_identity_document_devpayproductcodes:

+            description: Product codes for the launched AMI.

+            type: string

+            sample: ""

+        ansible_ec2_instance_identity_document_imageid:

+            description: The AMI ID used to launch the instance.

+            type: string

+            sample: "ami-01234567"

+        ansible_ec2_instance_identity_document_instanceid:

+            description: The ID of this instance.

+            type: string

+            sample: "i-0123456789abcdef0"

+        ansible_ec2_instance_identity_document_instancetype:

+            description: The type of instance.

+            type: string

+            sample: "m4.large"

+        ansible_ec2_instance_identity_document_kernelid:

+            description: The ID of the kernel launched with this instance, if applicable.

+            type: string

+            sample: ""

+        ansible_ec2_instance_identity_document_pendingtime:

+            description: The instance pending time.

+            type: string

+            sample: "2017-05-11T20:51:20Z"

+        ansible_ec2_instance_identity_document_privateip:

+            description:

+                - The private IPv4 address of the instance.

+                  In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0).

+            type: string

+            sample: "10.0.0.1"

+        ansible_ec2_instance_identity_document_ramdiskid:

+            description: The ID of the RAM disk specified at launch time, if applicable.

+            type: string

+            sample: ""

+        ansible_ec2_instance_identity_document_region:

+            description: The Region in which the instance launched.

+            type: string

+            sample: "us-east-1"

+        ansible_ec2_instance_identity_document_version:

+            description: Identity document version.

+            type: string

+            sample: "2010-08-31"

+        ansible_ec2_instance_identity_pkcs7:

+            description: Used to verify the document's authenticity and content against the signature.

+            type: string

+            sample: ""

+        ansible_ec2_instance_identity_rsa2048:

+            description: Used to verify the document's authenticity and content against the signature.

+            type: string

+            sample: ""

+        ansible_ec2_instance_identity_signature:

+            description: Data that can be used by other parties to verify its origin and authenticity.

+            type: string

+            sample: ""

+        ansible_ec2_instance_type:

+            description: The type of instance.

+            type: string

+            sample: "m4.large"

+        ansible_ec2_local_hostname:

+            description:

+                - The private IPv4 DNS hostname of the instance.

+                  In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0).

+            type: string

+            sample: "ip-10-0-0-1.ec2.internal"

+        ansible_ec2_local_ipv4:

+            description:

+                - The private IPv4 address of the instance.

+                  In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0).

+            type: string

+            sample: "10.0.0.1"

+        ansible_ec2_mac:

+            description:

+                - The instance's media access control (MAC) address.

+                  In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0).

+            type: string

+            sample: "00:11:22:33:44:55"

+        ansible_ec2_metrics_vhostmd:

+            description: Metrics.

+            type: string

+            sample: ""

+        ansible_ec2_network_interfaces_macs_<mac address>_device_number:

+            description:

+                - The unique device number associated with that interface. The device number corresponds to the device name;

+                  for example, a device-number of 2 is for the eth2 device.

+                  This category corresponds to the DeviceIndex and device-index fields that are used by the Amazon EC2 API and the EC2 commands for the AWS CLI.

+            type: string

+            sample: "0"

+        ansible_ec2_network_interfaces_macs_<mac address>_interface_id:

+            description: The elastic network interface ID.

+            type: string

+            sample: "eni-12345678"

+        ansible_ec2_network_interfaces_macs_<mac address>_ipv4_associations_<ip address>:

+            description: The private IPv4 addresses that are associated with each public-ip address and assigned to that interface.

+            type: string

+            sample: ""

+        ansible_ec2_network_interfaces_macs_<mac address>_ipv6s:

+            description: The IPv6 addresses associated with the interface. Returned only for instances launched into a VPC.

+            type: string

+            sample: ""

+        ansible_ec2_network_interfaces_macs_<mac address>_local_hostname:

+            description: The interface's local hostname.

+            type: string

+            sample: ""

+        ansible_ec2_network_interfaces_macs_<mac address>_local_ipv4s:

+            description: The private IPv4 addresses associated with the interface.

+            type: string

+            sample: ""

+        ansible_ec2_network_interfaces_macs_<mac address>_mac:

+            description: The instance's MAC address.

+            type: string