Elastic Disaster Recovery Service

2026/07/14 - Elastic Disaster Recovery Service - 5 updated api methods

Changes  Fast recovery of EC2 based drs workloads by skipping the conversion step

CreateLaunchConfigurationTemplate (updated) Link ¶
Changes (request, response)
Request
{'recoveryMode': 'FAST | OPTIMAL'}
Response
{'launchConfigurationTemplate': {'recoveryMode': 'FAST | OPTIMAL'}}

Creates a new Launch Configuration Template.

See also: AWS API Documentation

Request Syntax

client.create_launch_configuration_template(
    tags={
        'string': 'string'
    },
    launchDisposition='STOPPED'|'STARTED',
    targetInstanceTypeRightSizingMethod='NONE'|'BASIC'|'IN_AWS',
    copyPrivateIp=True|False,
    copyTags=True|False,
    licensing={
        'osByol': True|False
    },
    exportBucketArn='string',
    postLaunchEnabled=True|False,
    launchIntoSourceInstance=True|False,
    recoveryMode='FAST'|'OPTIMAL'
)
type tags:

dict

param tags:

Request to associate tags during creation of a Launch Configuration Template.

  • (string) --

    • (string) --

type launchDisposition:

string

param launchDisposition:

Launch disposition.

type targetInstanceTypeRightSizingMethod:

string

param targetInstanceTypeRightSizingMethod:

Target instance type right-sizing method.

type copyPrivateIp:

boolean

param copyPrivateIp:

Copy private IP.

type copyTags:

boolean

param copyTags:

Copy tags.

type licensing:

dict

param licensing:

Licensing.

  • osByol (boolean) --

    Whether to enable "Bring your own license" or not.

type exportBucketArn:

string

param exportBucketArn:

S3 bucket ARN to export Source Network templates.

type postLaunchEnabled:

boolean

param postLaunchEnabled:

Whether we want to activate post-launch actions.

type launchIntoSourceInstance:

boolean

param launchIntoSourceInstance:

DRS will set the 'launch into instance ID' of any source server when performing a drill, recovery or failback to the previous region or availability zone, using the instance ID of the source instance.

type recoveryMode:

string

param recoveryMode:

Recovery mode.

rtype:

dict

returns:

Response Syntax

{
    'launchConfigurationTemplate': {
        'launchConfigurationTemplateID': 'string',
        'arn': 'string',
        'tags': {
            'string': 'string'
        },
        'launchDisposition': 'STOPPED'|'STARTED',
        'targetInstanceTypeRightSizingMethod': 'NONE'|'BASIC'|'IN_AWS',
        'copyPrivateIp': True|False,
        'copyTags': True|False,
        'licensing': {
            'osByol': True|False
        },
        'exportBucketArn': 'string',
        'postLaunchEnabled': True|False,
        'launchIntoSourceInstance': True|False,
        'recoveryMode': 'FAST'|'OPTIMAL'
    }
}

Response Structure

  • (dict) --

    • launchConfigurationTemplate (dict) --

      Created Launch Configuration Template.

      • launchConfigurationTemplateID (string) --

        ID of the Launch Configuration Template.

      • arn (string) --

        ARN of the Launch Configuration Template.

      • tags (dict) --

        Tags of the Launch Configuration Template.

        • (string) --

          • (string) --

      • launchDisposition (string) --

        Launch disposition.

      • targetInstanceTypeRightSizingMethod (string) --

        Target instance type right-sizing method.

      • copyPrivateIp (boolean) --

        Copy private IP.

      • copyTags (boolean) --

        Copy tags.

      • licensing (dict) --

        Licensing.

        • osByol (boolean) --

          Whether to enable "Bring your own license" or not.

      • exportBucketArn (string) --

        S3 bucket ARN to export Source Network templates.

      • postLaunchEnabled (boolean) --

        Post-launch actions activated.

      • launchIntoSourceInstance (boolean) --

        DRS will set the 'launch into instance ID' of any source server when performing a drill, recovery or failback to the previous region or availability zone, using the instance ID of the source instance.

      • recoveryMode (string) --

        Recovery mode.

DescribeLaunchConfigurationTemplates (updated) Link ¶
Changes (response)
{'items': {'recoveryMode': 'FAST | OPTIMAL'}}

Lists all Launch Configuration Templates, filtered by Launch Configuration Template IDs

See also: AWS API Documentation

Request Syntax

client.describe_launch_configuration_templates(
    launchConfigurationTemplateIDs=[
        'string',
    ],
    maxResults=123,
    nextToken='string'
)
type launchConfigurationTemplateIDs:

list

param launchConfigurationTemplateIDs:

Request to filter Launch Configuration Templates list by Launch Configuration Template ID.

  • (string) --

type maxResults:

integer

param maxResults:

Maximum results to be returned in DescribeLaunchConfigurationTemplates.

type nextToken:

string

param nextToken:

The token of the next Launch Configuration Template to retrieve.

rtype:

dict

returns:

Response Syntax

{
    'items': [
        {
            'launchConfigurationTemplateID': 'string',
            'arn': 'string',
            'tags': {
                'string': 'string'
            },
            'launchDisposition': 'STOPPED'|'STARTED',
            'targetInstanceTypeRightSizingMethod': 'NONE'|'BASIC'|'IN_AWS',
            'copyPrivateIp': True|False,
            'copyTags': True|False,
            'licensing': {
                'osByol': True|False
            },
            'exportBucketArn': 'string',
            'postLaunchEnabled': True|False,
            'launchIntoSourceInstance': True|False,
            'recoveryMode': 'FAST'|'OPTIMAL'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      List of items returned by DescribeLaunchConfigurationTemplates.

      • (dict) --

        Account level Launch Configuration Template.

        • launchConfigurationTemplateID (string) --

          ID of the Launch Configuration Template.

        • arn (string) --

          ARN of the Launch Configuration Template.

        • tags (dict) --

          Tags of the Launch Configuration Template.

          • (string) --

            • (string) --

        • launchDisposition (string) --

          Launch disposition.

        • targetInstanceTypeRightSizingMethod (string) --

          Target instance type right-sizing method.

        • copyPrivateIp (boolean) --

          Copy private IP.

        • copyTags (boolean) --

          Copy tags.

        • licensing (dict) --

          Licensing.

          • osByol (boolean) --

            Whether to enable "Bring your own license" or not.

        • exportBucketArn (string) --

          S3 bucket ARN to export Source Network templates.

        • postLaunchEnabled (boolean) --

          Post-launch actions activated.

        • launchIntoSourceInstance (boolean) --

          DRS will set the 'launch into instance ID' of any source server when performing a drill, recovery or failback to the previous region or availability zone, using the instance ID of the source instance.

        • recoveryMode (string) --

          Recovery mode.

    • nextToken (string) --

      The token of the next Launch Configuration Template to retrieve.

GetLaunchConfiguration (updated) Link ¶
Changes (response)
{'recoveryMode': 'FAST | OPTIMAL'}

Gets a LaunchConfiguration, filtered by Source Server IDs.

See also: AWS API Documentation

Request Syntax

client.get_launch_configuration(
    sourceServerID='string'
)
type sourceServerID:

string

param sourceServerID:

[REQUIRED]

The ID of the Source Server that we want to retrieve a Launch Configuration for.

rtype:

dict

returns:

Response Syntax

{
    'sourceServerID': 'string',
    'name': 'string',
    'ec2LaunchTemplateID': 'string',
    'launchDisposition': 'STOPPED'|'STARTED',
    'targetInstanceTypeRightSizingMethod': 'NONE'|'BASIC'|'IN_AWS',
    'copyPrivateIp': True|False,
    'copyTags': True|False,
    'licensing': {
        'osByol': True|False
    },
    'postLaunchEnabled': True|False,
    'launchIntoInstanceProperties': {
        'launchIntoEC2InstanceID': 'string'
    },
    'recoveryMode': 'FAST'|'OPTIMAL'
}

Response Structure

  • (dict) --

    • sourceServerID (string) --

      The ID of the Source Server for this launch configuration.

    • name (string) --

      The name of the launch configuration.

    • ec2LaunchTemplateID (string) --

      The EC2 launch template ID of this launch configuration.

    • launchDisposition (string) --

      The state of the Recovery Instance in EC2 after the recovery operation.

    • targetInstanceTypeRightSizingMethod (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.

    • copyPrivateIp (boolean) --

      Whether we should copy the Private IP of the Source Server to the Recovery Instance.

    • copyTags (boolean) --

      Whether we want to copy the tags of the Source Server to the EC2 machine of the Recovery Instance.

    • licensing (dict) --

      The licensing configuration to be used for this launch configuration.

      • osByol (boolean) --

        Whether to enable "Bring your own license" or not.

    • postLaunchEnabled (boolean) --

      Whether we want to activate post-launch actions for the Source Server.

    • launchIntoInstanceProperties (dict) --

      Launch into existing instance properties.

      • launchIntoEC2InstanceID (string) --

        Optionally holds EC2 instance ID of an instance to launch into, instead of launching a new instance during drill, recovery or failback.

    • recoveryMode (string) --

      Recovery mode.

UpdateLaunchConfiguration (updated) Link ¶
Changes (both)
{'recoveryMode': 'FAST | OPTIMAL'}

Updates a LaunchConfiguration by Source Server ID.

See also: AWS API Documentation

Request Syntax

client.update_launch_configuration(
    sourceServerID='string',
    name='string',
    launchDisposition='STOPPED'|'STARTED',
    targetInstanceTypeRightSizingMethod='NONE'|'BASIC'|'IN_AWS',
    copyPrivateIp=True|False,
    copyTags=True|False,
    licensing={
        'osByol': True|False
    },
    postLaunchEnabled=True|False,
    launchIntoInstanceProperties={
        'launchIntoEC2InstanceID': 'string'
    },
    recoveryMode='FAST'|'OPTIMAL'
)
type sourceServerID:

string

param sourceServerID:

[REQUIRED]

The ID of the Source Server that we want to retrieve a Launch Configuration for.

type name:

string

param name:

The name of the launch configuration.

type launchDisposition:

string

param launchDisposition:

The state of the Recovery Instance in EC2 after the recovery operation.

type targetInstanceTypeRightSizingMethod:

string

param targetInstanceTypeRightSizingMethod:

Whether Elastic Disaster Recovery should try to automatically choose the instance type that best matches the OS, CPU, and RAM of your Source Server.

type copyPrivateIp:

boolean

param copyPrivateIp:

Whether we should copy the Private IP of the Source Server to the Recovery Instance.

type copyTags:

boolean

param copyTags:

Whether we want to copy the tags of the Source Server to the EC2 machine of the Recovery Instance.

type licensing:

dict

param licensing:

The licensing configuration to be used for this launch configuration.

  • osByol (boolean) --

    Whether to enable "Bring your own license" or not.

type postLaunchEnabled:

boolean

param postLaunchEnabled:

Whether we want to enable post-launch actions for the Source Server.

type launchIntoInstanceProperties:

dict

param launchIntoInstanceProperties:

Launch into existing instance properties.

  • launchIntoEC2InstanceID (string) --

    Optionally holds EC2 instance ID of an instance to launch into, instead of launching a new instance during drill, recovery or failback.

type recoveryMode:

string

param recoveryMode:

Recovery mode.

rtype:

dict

returns:

Response Syntax

{
    'sourceServerID': 'string',
    'name': 'string',
    'ec2LaunchTemplateID': 'string',
    'launchDisposition': 'STOPPED'|'STARTED',
    'targetInstanceTypeRightSizingMethod': 'NONE'|'BASIC'|'IN_AWS',
    'copyPrivateIp': True|False,
    'copyTags': True|False,
    'licensing': {
        'osByol': True|False
    },
    'postLaunchEnabled': True|False,
    'launchIntoInstanceProperties': {
        'launchIntoEC2InstanceID': 'string'
    },
    'recoveryMode': 'FAST'|'OPTIMAL'
}

Response Structure

  • (dict) --

    • sourceServerID (string) --

      The ID of the Source Server for this launch configuration.

    • name (string) --

      The name of the launch configuration.

    • ec2LaunchTemplateID (string) --

      The EC2 launch template ID of this launch configuration.

    • launchDisposition (string) --

      The state of the Recovery Instance in EC2 after the recovery operation.

    • targetInstanceTypeRightSizingMethod (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.

    • copyPrivateIp (boolean) --

      Whether we should copy the Private IP of the Source Server to the Recovery Instance.

    • copyTags (boolean) --

      Whether we want to copy the tags of the Source Server to the EC2 machine of the Recovery Instance.

    • licensing (dict) --

      The licensing configuration to be used for this launch configuration.

      • osByol (boolean) --

        Whether to enable "Bring your own license" or not.

    • postLaunchEnabled (boolean) --

      Whether we want to activate post-launch actions for the Source Server.

    • launchIntoInstanceProperties (dict) --

      Launch into existing instance properties.

      • launchIntoEC2InstanceID (string) --

        Optionally holds EC2 instance ID of an instance to launch into, instead of launching a new instance during drill, recovery or failback.

    • recoveryMode (string) --

      Recovery mode.

UpdateLaunchConfigurationTemplate (updated) Link ¶
Changes (request, response)
Request
{'recoveryMode': 'FAST | OPTIMAL'}
Response
{'launchConfigurationTemplate': {'recoveryMode': 'FAST | OPTIMAL'}}

Updates an existing Launch Configuration Template by ID.

See also: AWS API Documentation

Request Syntax

client.update_launch_configuration_template(
    launchConfigurationTemplateID='string',
    launchDisposition='STOPPED'|'STARTED',
    targetInstanceTypeRightSizingMethod='NONE'|'BASIC'|'IN_AWS',
    copyPrivateIp=True|False,
    copyTags=True|False,
    licensing={
        'osByol': True|False
    },
    exportBucketArn='string',
    postLaunchEnabled=True|False,
    launchIntoSourceInstance=True|False,
    recoveryMode='FAST'|'OPTIMAL'
)
type launchConfigurationTemplateID:

string

param launchConfigurationTemplateID:

[REQUIRED]

Launch Configuration Template ID.

type launchDisposition:

string

param launchDisposition:

Launch disposition.

type targetInstanceTypeRightSizingMethod:

string

param targetInstanceTypeRightSizingMethod:

Target instance type right-sizing method.

type copyPrivateIp:

boolean

param copyPrivateIp:

Copy private IP.

type copyTags:

boolean

param copyTags:

Copy tags.

type licensing:

dict

param licensing:

Licensing.

  • osByol (boolean) --

    Whether to enable "Bring your own license" or not.

type exportBucketArn:

string

param exportBucketArn:

S3 bucket ARN to export Source Network templates.

type postLaunchEnabled:

boolean

param postLaunchEnabled:

Whether we want to activate post-launch actions.

type launchIntoSourceInstance:

boolean

param launchIntoSourceInstance:

DRS will set the 'launch into instance ID' of any source server when performing a drill, recovery or failback to the previous region or availability zone, using the instance ID of the source instance.

type recoveryMode:

string

param recoveryMode:

Recovery mode.

rtype:

dict

returns:

Response Syntax

{
    'launchConfigurationTemplate': {
        'launchConfigurationTemplateID': 'string',
        'arn': 'string',
        'tags': {
            'string': 'string'
        },
        'launchDisposition': 'STOPPED'|'STARTED',
        'targetInstanceTypeRightSizingMethod': 'NONE'|'BASIC'|'IN_AWS',
        'copyPrivateIp': True|False,
        'copyTags': True|False,
        'licensing': {
            'osByol': True|False
        },
        'exportBucketArn': 'string',
        'postLaunchEnabled': True|False,
        'launchIntoSourceInstance': True|False,
        'recoveryMode': 'FAST'|'OPTIMAL'
    }
}

Response Structure

  • (dict) --

    • launchConfigurationTemplate (dict) --

      Updated Launch Configuration Template.

      • launchConfigurationTemplateID (string) --

        ID of the Launch Configuration Template.

      • arn (string) --

        ARN of the Launch Configuration Template.

      • tags (dict) --

        Tags of the Launch Configuration Template.

        • (string) --

          • (string) --

      • launchDisposition (string) --

        Launch disposition.

      • targetInstanceTypeRightSizingMethod (string) --

        Target instance type right-sizing method.

      • copyPrivateIp (boolean) --

        Copy private IP.

      • copyTags (boolean) --

        Copy tags.

      • licensing (dict) --

        Licensing.

        • osByol (boolean) --

          Whether to enable "Bring your own license" or not.

      • exportBucketArn (string) --

        S3 bucket ARN to export Source Network templates.

      • postLaunchEnabled (boolean) --

        Post-launch actions activated.

      • launchIntoSourceInstance (boolean) --

        DRS will set the 'launch into instance ID' of any source server when performing a drill, recovery or failback to the previous region or availability zone, using the instance ID of the source instance.

      • recoveryMode (string) --

        Recovery mode.