UserNotifications / Client / get_event_rule

get_event_rule#

UserNotifications.Client.get_event_rule(**kwargs)#

Returns a specified EventRule.

See also: AWS API Documentation

Request Syntax

response = client.get_event_rule(
    arn='string'
)
Parameters:

arn (string) –

[REQUIRED]

The Amazon Resource Name (ARN) of the EventRule to return.

Return type:

dict

Returns:

Response Syntax

{
    'arn': 'string',
    'notificationConfigurationArn': 'string',
    'creationTime': datetime(2015, 1, 1),
    'source': 'string',
    'eventType': 'string',
    'eventPattern': 'string',
    'regions': [
        'string',
    ],
    'managedRules': [
        '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.

    • creationTime (datetime) –

      The date when the EventRule was created.

    • source (string) –

      The matched event source.

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

    • eventType (string) –

      The event type to match.

      Must match one of the valid Amazon EventBridge event types. For example, EC2 Instance State-change Notification and AWS CloudWatch Alarm State Change. For more information, see Event delivery from AWS 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) –

      A list of AWS Regions that send events to this EventRule.

      • (string) –

    • managedRules (list) –

      A list of managed rules from EventBridge that are are associated with this EventRule.

      Note

      These are created by AWS User Notifications within your account so this EventRule functions.

      • (string) –

    • statusSummaryByRegion (dict) –

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

      • (string) –

        • (dict) –

          Describes EventRule status information.

          • 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.AccessDeniedException

  • UserNotifications.Client.exceptions.ValidationException

  • UserNotifications.Client.exceptions.InternalServerException

  • UserNotifications.Client.exceptions.ThrottlingException

  • UserNotifications.Client.exceptions.ResourceNotFoundException