:doc:`drs <../../drs>` / Client / get_launch_configuration

************************
get_launch_configuration
************************



.. py:method:: drs.Client.get_launch_configuration(**kwargs)

  

  Gets a LaunchConfiguration, filtered by Source Server IDs.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/drs-2020-02-26/GetLaunchConfiguration>`_  


  **Request Syntax**
  ::

    response = 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**

    
    ::

      {
          '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**
  
  *   :py:class:`drs.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`drs.Client.exceptions.InternalServerException`

  
  *   :py:class:`drs.Client.exceptions.ThrottlingException`

  
  *   :py:class:`drs.Client.exceptions.UninitializedAccountException`

  