UserNotifications / Client / create_event_rule

create_event_rule#

UserNotifications.Client.create_event_rule(**kwargs)#

Creates an EventRule that is associated with a specified NotificationConfiguration.

See also: AWS API Documentation

Request Syntax

response = client.create_event_rule(
    notificationConfigurationArn='string',
    source='string',
    eventType='string',
    eventPattern='string',
    regions=[
        'string',
    ]
)
Parameters:

  • notificationConfigurationArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the NotificationConfiguration associated with this EventRule.

  • source (string) –

    [REQUIRED]

    The matched event source.

    Must match one of the valid EventBridge sources. Only Amazon Web Services service sourced events are supported. For example, aws.ec2 and aws.cloudwatch. For more information, see Event delivery from Amazon Web Services services in the Amazon EventBridge User Guide.

  • eventType (string) –

    [REQUIRED]

    The event type to match.

    Must match one of the valid Amazon EventBridge event types. For example, EC2 Instance State-change Notification and Amazon CloudWatch Alarm State Change. For more information, see Event delivery from Amazon Web Services services in the Amazon EventBridge User Guide.

  • eventPattern (string) –

    An additional event pattern used to further filter the events this EventRule receives.

    For more information, see Amazon EventBridge event patterns in the Amazon EventBridge User Guide.

  • regions (list) –

    [REQUIRED]

    A list of Amazon Web Services Regions that send events to this EventRule.

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'arn': 'string',
    'notificationConfigurationArn': 'string',
    'statusSummaryByRegion': {
        'string': {
            'status': 'ACTIVE'|'INACTIVE'|'CREATING'|'UPDATING'|'DELETING',
            'reason': 'string'
        }
    }
}

Response Structure

  • (dict) –

    • arn (string) –

      The ARN of the resource.

    • notificationConfigurationArn (string) –

      The ARN of a NotificationConfiguration.

    • statusSummaryByRegion (dict) –

      A list of an EventRule’s status by Region. Regions are mapped to EventRuleStatusSummary.

      • (string) –

        • (dict) –

          Provides additional information about the current EventRule status.

          • status (string) –

            The status of the EventRule.

            • Values:

              • ACTIVE

                • The EventRule can process events.

              • INACTIVE

                • The EventRule may be unable to process events.

              • CREATING

                • The EventRule is being created. Only GET and LIST calls can be run.

              • UPDATING

                • The EventRule is being updated. Only GET and LIST calls can be run.

              • DELETING

                • The EventRule is being deleted. Only GET and LIST calls can be run.

          • reason (string) –

            A human-readable reason for EventRuleStatus.

Exceptions

  • UserNotifications.Client.exceptions.ServiceQuotaExceededException

  • UserNotifications.Client.exceptions.AccessDeniedException

  • UserNotifications.Client.exceptions.ValidationException

  • UserNotifications.Client.exceptions.InternalServerException

  • UserNotifications.Client.exceptions.ThrottlingException

  • UserNotifications.Client.exceptions.ConflictException

  • UserNotifications.Client.exceptions.ResourceNotFoundException