drs / Client / update_launch_configuration

update_launch_configuration#

drs.Client.update_launch_configuration(**kwargs)#

Updates a LaunchConfiguration by Source Server ID.

See also: AWS API Documentation

Request Syntax

response = client.update_launch_configuration(
    copyPrivateIp=True|False,
    copyTags=True|False,
    launchDisposition='STOPPED'|'STARTED',
    launchIntoInstanceProperties={
        'launchIntoEC2InstanceID': 'string'
    },
    licensing={
        'osByol': True|False
    },
    name='string',
    postLaunchEnabled=True|False,
    sourceServerID='string',
    targetInstanceTypeRightSizingMethod='NONE'|'BASIC'|'IN_AWS'
)
Parameters:
  • 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.

  • launchDisposition (string) – The state of the Recovery Instance in EC2 after the recovery operation.

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

  • licensing (dict) –

    The licensing configuration to be used for this launch configuration.

    • osByol (boolean) –

      Whether to enable “Bring your own license” or not.

  • name (string) – The name of the launch configuration.

  • postLaunchEnabled (boolean) – Whether we want to enable post-launch actions for the Source Server.

  • sourceServerID (string) –

    [REQUIRED]

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

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

Return type:

dict

Returns:

Response Syntax

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

Response Structure

  • (dict) –

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

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

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

    • licensing (dict) –

      The licensing configuration to be used for this launch configuration.

      • osByol (boolean) –

        Whether to enable “Bring your own license” or not.

    • name (string) –

      The name of the launch configuration.

    • postLaunchEnabled (boolean) –

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

    • sourceServerID (string) –

      The ID of the Source Server for this launch configuration.

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

Exceptions

  • drs.Client.exceptions.ResourceNotFoundException

  • drs.Client.exceptions.InternalServerException

  • drs.Client.exceptions.ConflictException

  • drs.Client.exceptions.ThrottlingException

  • drs.Client.exceptions.ValidationException

  • drs.Client.exceptions.UninitializedAccountException