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

**********************
cancel_conversion_task
**********************



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

  

  Cancels an active conversion task. The task can be the import of an instance or volume. The action removes all artifacts of the conversion, including a partially uploaded volume or instance. If the conversion is complete or is in the process of transferring the final disk image, the command fails and returns an exception.

  

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


  **Request Syntax**
  ::

    response = client.cancel_conversion_task(
        DryRun=True|False,
        ConversionTaskId='string',
        ReasonMessage='string'
    )
    
  :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``.

    

  
  :type ConversionTaskId: string
  :param ConversionTaskId: **[REQUIRED]** 

    The ID of the conversion task.

    

  
  :type ReasonMessage: string
  :param ReasonMessage: 

    The reason for canceling the conversion task.

    

  
  
  :returns: None