:doc:`CloudFront <../../cloudfront>` / Client / delete_response_headers_policy

******************************
delete_response_headers_policy
******************************



.. py:method:: CloudFront.Client.delete_response_headers_policy(**kwargs)

  

  Deletes a response headers policy.

   

  You cannot delete a response headers policy if it's attached to a cache behavior. First update your distributions to remove the response headers policy from all cache behaviors, then delete the response headers policy.

   

  To delete a response headers policy, you must provide the policy's identifier and version. To get these values, you can use ``ListResponseHeadersPolicies`` or ``GetResponseHeadersPolicy``.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/DeleteResponseHeadersPolicy>`_  


  **Request Syntax**
  ::

    response = client.delete_response_headers_policy(
        Id='string',
        IfMatch='string'
    )
    
  :type Id: string
  :param Id: **[REQUIRED]** 

    The identifier for the response headers policy that you are deleting.

     

    To get the identifier, you can use ``ListResponseHeadersPolicies``.

    

  
  :type IfMatch: string
  :param IfMatch: 

    The version of the response headers policy that you are deleting.

     

    The version is the response headers policy's ``ETag`` value, which you can get using ``ListResponseHeadersPolicies``, ``GetResponseHeadersPolicy``, or ``GetResponseHeadersPolicyConfig``.

    

  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`CloudFront.Client.exceptions.PreconditionFailed`

  
  *   :py:class:`CloudFront.Client.exceptions.ResponseHeadersPolicyInUse`

  
  *   :py:class:`CloudFront.Client.exceptions.AccessDenied`

  
  *   :py:class:`CloudFront.Client.exceptions.IllegalDelete`

  
  *   :py:class:`CloudFront.Client.exceptions.NoSuchResponseHeadersPolicy`

  
  *   :py:class:`CloudFront.Client.exceptions.InvalidIfMatchVersion`

  