Documentation

ec2_lc_find - Find AWS Autoscaling Launch Configurations

New in version 2.2.

Synopsis

  • Returns list of matching Launch Configurations for a given name, along with other useful information
  • Results can be sorted and sliced
  • It depends on boto
  • Based on the work by Tom Bamford (https://github.com/tombamford)

Options

parameter required default choices comments
limit
no
How many results to show.
Corresponds to Python slice notation like list[:limit].
name_regex
yes
A Launch Configuration to match
It'll be compiled as regex
region
yes
The AWS region to use.

aliases: aws_region, ec2_region
sort_order
no ascending
  • ascending
  • descending
Order in which to sort results.

Examples

# Note: These examples do not set authentication details, see the AWS Guide for details.

# Search for the Launch Configurations that start with "app"
- ec2_lc_find:
    name_regex: app.*
    sort_order: descending
    limit: 2

Return Values

Common return values are documented here Return Values, the following are the fields unique to this module:

name description returned type sample
ram_disk_id Launch Configuration ram disk property when Launch Configuration was found string
name Name of the AMI when Launch Configuration was found string myapp-v123
image_id AMI id when Launch Configuration was found string ami-0d75df7e
kernel_id Launch Configuration kernel to use when Launch Configuration was found string
ebs_optimized Launch Configuration EBS optimized property when Launch Configuration was found boolean False
user_data User data used to start instance when Launch Configuration was found string ZXhwb3J0IENMT1VE
instance_type Type of ec2 instance when Launch Configuration was found string t2.small
keyname Launch Configuration ssh key when Launch Configuration was found string mykey
arn Name of the AMI when Launch Configuration was found string arn:aws:autoscaling:eu-west-1:12345:launchConfiguration:d82f050e-e315:launchConfigurationName/yourproject
associate_public_address Assign public address or not when Launch Configuration was found boolean True
created_time When it was created when Launch Configuration was found string 2016-06-29T14:59:22.222000+00:00
instance_monitoring Launch Configuration instance monitoring property when Launch Configuration was found string {'Enabled': False}
classic_link_vpc_security_groups Launch Configuration classic link vpc security groups property when Launch Configuration was found list []
security_groups Launch Configuration security groups when Launch Configuration was found list []
block_device_mappings Launch Configuration block device mappings property when Launch Configuration was found list []


Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Support

This module is community maintained without core committer oversight.

For more information on what this means please read Module Support

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.