:doc:`EC2 <../../ec2>` / Client / disable_fast_launch

*******************
disable_fast_launch
*******************



.. py:method:: EC2.Client.disable_fast_launch(**kwargs)

  

  Discontinue Windows fast launch for a Windows AMI, and clean up existing pre-provisioned snapshots. After you disable Windows fast launch, the AMI uses the standard launch process for each new instance. Amazon EC2 must remove all pre-provisioned snapshots before you can enable Windows fast launch again.

   

  .. note::

    

    You can only change these settings for Windows AMIs that you own or that have been shared with you.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DisableFastLaunch>`_  


  **Request Syntax**
  ::

    response = client.disable_fast_launch(
        ImageId='string',
        Force=True|False,
        DryRun=True|False
    )
    
  :type ImageId: string
  :param ImageId: **[REQUIRED]** 

    Specify the ID of the image for which to disable Windows fast launch.

    

  
  :type Force: boolean
  :param Force: 

    Forces the image settings to turn off Windows fast launch for your Windows AMI. This parameter overrides any errors that are encountered while cleaning up resources in your account.

    

  
  :type DryRun: boolean
  :param DryRun: 

    Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is ``DryRunOperation``. Otherwise, it is ``UnauthorizedOperation``.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'ImageId': 'string',
          'ResourceType': 'snapshot',
          'SnapshotConfiguration': {
              'TargetResourceCount': 123
          },
          'LaunchTemplate': {
              'LaunchTemplateId': 'string',
              'LaunchTemplateName': 'string',
              'Version': 'string'
          },
          'MaxParallelLaunches': 123,
          'OwnerId': 'string',
          'State': 'enabling'|'enabling-failed'|'enabled'|'enabled-failed'|'disabling'|'disabling-failed',
          'StateTransitionReason': 'string',
          'StateTransitionTime': datetime(2015, 1, 1)
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ImageId** *(string) --* 

        The ID of the image for which Windows fast launch was disabled.

        
      

      - **ResourceType** *(string) --* 

        The pre-provisioning resource type that must be cleaned after turning off Windows fast launch for the Windows AMI. Supported values include: ``snapshot``.

        
      

      - **SnapshotConfiguration** *(dict) --* 

        Parameters that were used for Windows fast launch for the Windows AMI before Windows fast launch was disabled. This informs the clean-up process.

        
        

        - **TargetResourceCount** *(integer) --* 

          The number of pre-provisioned snapshots requested to keep on hand for a Windows fast launch enabled AMI.

          
    
      

      - **LaunchTemplate** *(dict) --* 

        The launch template that was used to launch Windows instances from pre-provisioned snapshots.

        
        

        - **LaunchTemplateId** *(string) --* 

          The ID of the launch template that the AMI uses for Windows fast launch.

          
        

        - **LaunchTemplateName** *(string) --* 

          The name of the launch template that the AMI uses for Windows fast launch.

          
        

        - **Version** *(string) --* 

          The version of the launch template that the AMI uses for Windows fast launch.

          
    
      

      - **MaxParallelLaunches** *(integer) --* 

        The maximum number of instances that Amazon EC2 can launch at the same time to create pre-provisioned snapshots for Windows fast launch.

        
      

      - **OwnerId** *(string) --* 

        The owner of the Windows AMI for which Windows fast launch was disabled.

        
      

      - **State** *(string) --* 

        The current state of Windows fast launch for the specified Windows AMI.

        
      

      - **StateTransitionReason** *(string) --* 

        The reason that the state changed for Windows fast launch for the Windows AMI.

        
      

      - **StateTransitionTime** *(datetime) --* 

        The time that the state changed for Windows fast launch for the Windows AMI.

        
  