diff --git a/lib/ansible/modules/cloud/amazon/ec2_instance.py b/lib/ansible/modules/cloud/amazon/ec2_instance.py index 33e196a4223..a8b982f6c58 100644 --- a/lib/ansible/modules/cloud/amazon/ec2_instance.py +++ b/lib/ansible/modules/cloud/amazon/ec2_instance.py @@ -171,26 +171,48 @@ extends_documentation_fragment: EXAMPLES = ''' # Note: These examples do not set authentication details, see the AWS Guide for details. -# Terminate every instance in a region. Use with caution. -- ec2_instance_facts: +# Terminate every running instance in a region. Use with EXTREME caution. +- ec2_instance: state: absent filters: instance-state-name: running -# Gather facts about all instances in AZ ap-southeast-2a -- ec2_instance_facts: - filters: - availability-zone: ap-southeast-2a - -# Gather facts about a particular instance using ID -- ec2_instance_facts: +# restart a particular instance by its ID +- ec2_instance: + state: restarted instance_ids: - i-12345678 -# Gather facts about any instance with a tag key Name and value Example -- ec2_instance_facts: - filters: - "tag:Name": Example +# start an instance with a public IP address +- ec2_instance: + name: "public-compute-instance" + key_name: "prod-ssh-key" + vpc_subnet_id: subnet-5ca1ab1e + instance_type: c5.large + security_group: default + network: + assign_public_ip: true + image_id: ami-123456 + tags: + Environment: Testing + +# start an instance and have it begin a Tower callback on boot +- ec2_instance: + name: "tower-callback-test" + key_name: "prod-ssh-key" + vpc_subnet_id: subnet-5ca1ab1e + security_group: default + tower_callback: + # IP or hostname of tower server + tower_address: 1.2.3.4 + job_template_id: 876 + host_config_key: '[secret config key goes here]' + network: + assign_public_ip: true + image_id: ami-123456 + cpu_credit_specification: unlimited + tags: + SomeThing: "A value" ''' RETURN = '''