:doc:`EventBridge <../../events>` / Client / test_event_pattern

******************
test_event_pattern
******************



.. py:method:: EventBridge.Client.test_event_pattern(**kwargs)

  

  Tests whether the specified event pattern matches the provided event.

   

  Most services in Amazon Web Services treat : or / as the same character in Amazon Resource Names (ARNs). However, EventBridge uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event patterns so that they match the ARN syntax in the event you want to match.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/TestEventPattern>`_  


  **Request Syntax**
  ::

    response = client.test_event_pattern(
        EventPattern='string',
        Event='string'
    )
    
  :type EventPattern: string
  :param EventPattern: **[REQUIRED]** 

    The event pattern. For more information, see `Events and Event Patterns <https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html>`__ in the *Amazon EventBridge User Guide* .

    

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

    The event, in JSON format, to test against the event pattern. The JSON must follow the format specified in `Amazon Web Services Events <https://docs.aws.amazon.com/eventbridge/latest/userguide/aws-events.html>`__, and the following fields are mandatory:

     

    
    * ``id``
     
    * ``account``
     
    * ``source``
     
    * ``time``
     
    * ``region``
     
    * ``resources``
     
    * ``detail-type``
    

    

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

    
    ::

      {
          'Result': True|False
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Result** *(boolean) --* 

        Indicates whether the event matches the event pattern.

        
  
  **Exceptions**
  
  *   :py:class:`EventBridge.Client.exceptions.InvalidEventPatternException`

  
  *   :py:class:`EventBridge.Client.exceptions.InternalException`

  