UserNotifications / Paginator / ListNotificationEvents

ListNotificationEvents

class UserNotifications.Paginator.ListNotificationEvents

paginator = client.get_paginator('list_notification_events')

paginate(**kwargs)

Creates an iterator that will paginate through responses from UserNotifications.Client.list_notification_events().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    startTime=datetime(2015, 1, 1),
    endTime=datetime(2015, 1, 1),
    locale='de_DE'|'en_CA'|'en_US'|'en_UK'|'es_ES'|'fr_CA'|'fr_FR'|'id_ID'|'it_IT'|'ja_JP'|'ko_KR'|'pt_BR'|'tr_TR'|'zh_CN'|'zh_TW',
    source='string',
    includeChildEvents=True|False,
    aggregateNotificationEventArn='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• startTime (datetime) – The earliest time of events to return from this call.

• endTime (datetime) – Latest time of events to return from this call.

• locale (string) – The locale code of the language used for the retrieved NotificationEvent. The default locale is English (en_US).

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

• includeChildEvents (boolean) – Include aggregated child events in the result.

• aggregateNotificationEventArn (string) – The Amazon Resource Name (ARN) of the aggregatedNotificationEventArn to match.

• PaginationConfig (dict) –

  A dictionary that provides parameters to control pagination.

  • MaxItems (integer) –

    The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

  • PageSize (integer) –

    The size of each page.

  • StartingToken (string) –

    A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'notificationEvents': [
        {
            'arn': 'string',
            'notificationConfigurationArn': 'string',
            'relatedAccount': 'string',
            'creationTime': datetime(2015, 1, 1),
            'notificationEvent': {
                'schemaVersion': 'v1.0',
                'sourceEventMetadata': {
                    'eventOriginRegion': 'string',
                    'source': 'string',
                    'eventType': 'string'
                },
                'messageComponents': {
                    'headline': 'string'
                },
                'eventStatus': 'HEALTHY'|'UNHEALTHY',
                'notificationType': 'ALERT'|'WARNING'|'ANNOUNCEMENT'|'INFORMATIONAL'
            },
            'aggregationEventType': 'AGGREGATE'|'CHILD'|'NONE',
            'aggregateNotificationEventArn': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) –

  • notificationEvents (list) –

    The list of notification events.

    • (dict) –

      Describes a short summary of a NotificationEvent. This is only used when listing notification events.

      • arn (string) –

        The Amazon Resource Name (ARN) of the resource.

      • notificationConfigurationArn (string) –

        The ARN of the NotificationConfiguration.

      • relatedAccount (string) –

        The account name containing the NotificationHub.

      • creationTime (datetime) –

        The creation time of the NotificationEvent.

      • notificationEvent (dict) –

        Refers to a NotificationEventSummary object.

        Similar in structure to content in the GetNotificationEvent response.

        • schemaVersion (string) –

          The schema version of the Notification Event.

        • sourceEventMetadata (dict) –

          The source event metadata.

          • eventOriginRegion (string) –

            The Region where the notification originated.

            Unavailable for aggregated notifications.

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

        • messageComponents (dict) –

          The message components of a notification event.

          • headline (string) –

            A sentence long summary. For example, titles or an email subject line.

        • eventStatus (string) –

          The notification event status.

          • Values:

            • HEALTHY

              • All EventRules are ACTIVE and any call can be run.

            • UNHEALTHY

              • Some EventRules are ACTIVE and some are INACTIVE. Any call can be run.

        • notificationType (string) –

          The type of event causing the notification.

          • Values:

            • ALERT

              • A notification about an event where something was triggered, initiated, reopened, deployed, or a threshold was breached.

            • WARNING

              • A notification about an event where an issue is about to arise. For example, something is approaching a threshold.

            • ANNOUNCEMENT

              • A notification about an important event. For example, a step in a workflow or escalation path or that a workflow was updated.

            • INFORMATIONAL

              • A notification about informational messages. For example, recommendations, service announcements, or reminders.

      • aggregationEventType (string) –

        The NotificationConfiguration’s aggregation type.

        • Values:

          • AGGREGATE

            • The notification event is an aggregate notification. Aggregate notifications summarize grouped events over a specified time period.

          • CHILD

            • Some EventRules are ACTIVE and some are INACTIVE. Any call can be run.

          • NONE

            • The notification isn’t aggregated.

      • aggregateNotificationEventArn (string) –

        The ARN of the aggregatedNotificationEventArn to match.

  • NextToken (string) –

    A token to resume pagination.