:doc:`WAF <../../waf>` / Client / delete_regex_match_set

**********************
delete_regex_match_set
**********************



.. py:method:: WAF.Client.delete_regex_match_set(**kwargs)

  

  .. note::

    

    This is **AWS WAF Classic** documentation. For more information, see `AWS WAF Classic <https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html>`__ in the developer guide.

     

    **For the latest version of AWS WAF**, use the AWS WAFV2 API and see the `AWS WAF Developer Guide <https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html>`__. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

    

   

  Permanently deletes a  RegexMatchSet. You can't delete a ``RegexMatchSet`` if it's still used in any ``Rules`` or if it still includes any ``RegexMatchTuples`` objects (any filters).

   

  If you just want to remove a ``RegexMatchSet`` from a ``Rule``, use  UpdateRule.

   

  To permanently delete a ``RegexMatchSet``, perform the following steps:

   

   
  * Update the ``RegexMatchSet`` to remove filters, if any. For more information, see  UpdateRegexMatchSet.
   
  * Use  GetChangeToken to get the change token that you provide in the ``ChangeToken`` parameter of a ``DeleteRegexMatchSet`` request.
   
  * Submit a ``DeleteRegexMatchSet`` request.
  

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/waf-2015-08-24/DeleteRegexMatchSet>`_  


  **Request Syntax**
  ::

    response = client.delete_regex_match_set(
        RegexMatchSetId='string',
        ChangeToken='string'
    )
    
  :type RegexMatchSetId: string
  :param RegexMatchSetId: **[REQUIRED]** 

    The ``RegexMatchSetId`` of the  RegexMatchSet that you want to delete. ``RegexMatchSetId`` is returned by  CreateRegexMatchSet and by  ListRegexMatchSets.

    

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

    The value returned by the most recent call to  GetChangeToken.

    

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

    
    ::

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

    

    - *(dict) --* 
      

      - **ChangeToken** *(string) --* 

        The ``ChangeToken`` that you used to submit the ``DeleteRegexMatchSet`` request. You can also use this value to query the status of the request. For more information, see  GetChangeTokenStatus.

        
  
  **Exceptions**
  
  *   :py:class:`WAF.Client.exceptions.WAFInternalErrorException`

  
  *   :py:class:`WAF.Client.exceptions.WAFInvalidAccountException`

  
  *   :py:class:`WAF.Client.exceptions.WAFNonexistentItemException`

  
  *   :py:class:`WAF.Client.exceptions.WAFReferencedItemException`

  
  *   :py:class:`WAF.Client.exceptions.WAFStaleDataException`

  
  *   :py:class:`WAF.Client.exceptions.WAFNonEmptyEntityException`

  