launch_configurations

Creates, updates, deletes, gets or lists a launch_configurations resource.

Overview

Name	launch_configurations
Type	Resource
Id	aws.drs.launch_configurations

Fields

The following fields are returned by SELECT queries:

get_launch_configuration

Name	Datatype	Description
name	string	The name of the launch configuration.
copy_private_ip	boolean	Whether we should copy the Private IP of the Source Server to the Recovery Instance.
copy_tags	boolean	Whether we want to copy the tags of the Source Server to the EC2 machine of the Recovery Instance.
ec_2_launch_template_id	string	The EC2 launch template ID of this launch configuration.
launch_disposition	string	The state of the Recovery Instance in EC2 after the recovery operation. (STOPPED, STARTED)
launch_into_instance_properties	object	Launch into existing instance properties.
licensing	object	Configuration of a machine's license.
post_launch_enabled	boolean	Whether we want to activate post-launch actions for the Source Server.
recovery_mode	string	Recovery mode to use during launch. FAST skips conversion to reduce recovery time. OPTIMAL runs full conversion for maximum compatibility. (FAST, OPTIMAL)
source_server_id	string	The ID of the Source Server for this launch configuration. (pattern: <code>s-[0-9a-zA-Z]{17}</code>)
target_instance_type_right_sizing_method	string	Whether Elastic Disaster Recovery should try to automatically choose the instance type that best matches the OS, CPU, and RAM of your Source Server. (NONE, BASIC, IN_AWS)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_launch_configuration	select	region		Gets a LaunchConfiguration, filtered by Source Server IDs.
update_launch_configuration	update	region, sourceServerID		Updates a LaunchConfiguration by Source Server ID.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)

SELECT examples

get_launch_configuration

Gets a LaunchConfiguration, filtered by Source Server IDs.

SELECT
name,
copy_private_ip,
copy_tags,
ec_2_launch_template_id,
launch_disposition,
launch_into_instance_properties,
licensing,
post_launch_enabled,
recovery_mode,
source_server_id,
target_instance_type_right_sizing_method
FROM aws.drs.launch_configurations
WHERE region = '{{ region }}' -- required
;

UPDATE examples

update_launch_configuration

Updates a LaunchConfiguration by Source Server ID.

UPDATE aws.drs.launch_configurations
SET 
sourceServerID = '{{ sourceServerID }}',
name = '{{ name }}',
launchDisposition = '{{ launchDisposition }}',
targetInstanceTypeRightSizingMethod = '{{ targetInstanceTypeRightSizingMethod }}',
copyPrivateIp = {{ copyPrivateIp }},
copyTags = {{ copyTags }},
licensing = '{{ licensing }}',
postLaunchEnabled = {{ postLaunchEnabled }},
launchIntoInstanceProperties = '{{ launchIntoInstanceProperties }}',
recoveryMode = '{{ recoveryMode }}'
WHERE 
region = '{{ region }}' --required
AND sourceServerID = '{{ sourceServerID }}' --required
RETURNING
name,
copy_private_ip,
copy_tags,
ec_2_launch_template_id,
launch_disposition,
launch_into_instance_properties,
licensing,
post_launch_enabled,
recovery_mode,
source_server_id,
target_instance_type_right_sizing_method;