:doc:`WAFRegional <../../waf-regional>` / Client / delete_geo_match_set

********************
delete_geo_match_set
********************



.. py:method:: WAFRegional.Client.delete_geo_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  GeoMatchSet. You can't delete a ``GeoMatchSet`` if it's still used in any ``Rules`` or if it still includes any countries.

   

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

   

  To permanently delete a ``GeoMatchSet`` from AWS WAF, perform the following steps:

   

   
  * Update the ``GeoMatchSet`` to remove any countries. For more information, see  UpdateGeoMatchSet.
   
  * Use  GetChangeToken to get the change token that you provide in the ``ChangeToken`` parameter of a ``DeleteGeoMatchSet`` request.
   
  * Submit a ``DeleteGeoMatchSet`` request.
  

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/waf-regional-2016-11-28/DeleteGeoMatchSet>`_  


  **Request Syntax**
  ::

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

    The ``GeoMatchSetID`` of the  GeoMatchSet that you want to delete. ``GeoMatchSetId`` is returned by  CreateGeoMatchSet and by  ListGeoMatchSets.

    

  
  :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 ``DeleteGeoMatchSet`` request. You can also use this value to query the status of the request. For more information, see  GetChangeTokenStatus.

        
  
  **Exceptions**
  
  *   :py:class:`WAFRegional.Client.exceptions.WAFStaleDataException`

  
  *   :py:class:`WAFRegional.Client.exceptions.WAFInternalErrorException`

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

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

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

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

  