:doc:`VPCLattice <../../vpc-lattice>` / Client / delete_rule

***********
delete_rule
***********



.. py:method:: VPCLattice.Client.delete_rule(**kwargs)

  

  Deletes a listener rule. Each listener has a default rule for checking connection requests, but you can define additional rules. Each rule consists of a priority, one or more actions, and one or more conditions. You can delete additional listener rules, but you cannot delete the default rule.

   

  For more information, see `Listener rules <https://docs.aws.amazon.com/vpc-lattice/latest/ug/listeners.html#listener-rules>`__ in the *Amazon VPC Lattice User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/vpc-lattice-2022-11-30/DeleteRule>`_  


  **Request Syntax**
  ::

    response = client.delete_rule(
        serviceIdentifier='string',
        listenerIdentifier='string',
        ruleIdentifier='string'
    )
    
  :type serviceIdentifier: string
  :param serviceIdentifier: **[REQUIRED]** 

    The ID or ARN of the service.

    

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

    The ID or ARN of the listener.

    

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

    The ID or ARN of the rule.

    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`VPCLattice.Client.exceptions.ValidationException`

  
  *   :py:class:`VPCLattice.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`VPCLattice.Client.exceptions.ConflictException`

  
  *   :py:class:`VPCLattice.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`VPCLattice.Client.exceptions.ThrottlingException`

  
  *   :py:class:`VPCLattice.Client.exceptions.InternalServerException`

  