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

**************************************
enable_image_deregistration_protection
**************************************



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

  

  Enables deregistration protection for an AMI. When deregistration protection is enabled, the AMI can't be deregistered.

   

  To allow the AMI to be deregistered, you must first disable deregistration protection.

   

  For more information, see `Protect an Amazon EC2 AMI from deregistration <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deregistration-protection.html>`__ in the *Amazon EC2 User Guide*.

  

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


  **Request Syntax**
  ::

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

    The ID of the AMI.

    

  
  :type WithCooldown: boolean
  :param WithCooldown: 

    If ``true``, enforces deregistration protection for 24 hours after deregistration protection is disabled.

    

  
  :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**

    
    ::

      {
          'Return': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Return** *(string) --* 

        Returns ``true`` if the request succeeds; otherwise, it returns an error.

        
  