UserNotifications / Client / list_managed_notification_events

list_managed_notification_events#

UserNotifications.Client.list_managed_notification_events(**kwargs)#

Returns a list of Managed Notification Events according to specified filters, ordered by creation time in reverse chronological order (newest first).

See also: AWS API Documentation

Request Syntax

response = client.list_managed_notification_events(
    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',
    maxResults=123,
    nextToken='string',
    organizationalUnitId='string',
    relatedAccount='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 Amazon Web Services service the event originates from. For example aws.cloudwatch.

  • maxResults (integer) – The maximum number of results to be returned in this call. Defaults to 20.

  • nextToken (string) – The start token for paginated calls. Retrieved from the response of a previous ListManagedNotificationChannelAssociations call. Next token uses Base64 encoding.

  • organizationalUnitId (string) – The Organizational Unit Id that an Amazon Web Services account belongs to.

  • relatedAccount (string) – The Amazon Web Services account ID associated with the Managed Notification Events.

Return type:

dict

Returns:

Response Syntax

{
    'nextToken': 'string',
    'managedNotificationEvents': [
        {
            'arn': 'string',
            'managedNotificationConfigurationArn': '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',
            'organizationalUnitId': 'string',
            'aggregationSummary': {
                'eventCount': 123,
                'aggregatedBy': [
                    {
                        'name': 'string',
                        'value': 'string'
                    },
                ],
                'aggregatedAccounts': {
                    'name': 'string',
                    'count': 123,
                    'sampleValues': [
                        'string',
                    ]
                },
                'aggregatedRegions': {
                    'name': 'string',
                    'count': 123,
                    'sampleValues': [
                        'string',
                    ]
                },
                'aggregatedOrganizationalUnits': {
                    'name': 'string',
                    'count': 123,
                    'sampleValues': [
                        'string',
                    ]
                },
                'additionalSummarizationDimensions': [
                    {
                        'name': 'string',
                        'count': 123,
                        'sampleValues': [
                            'string',
                        ]
                    },
                ]
            },
            'aggregatedNotificationRegions': [
                'string',
            ]
        },
    ]
}

Response Structure

  • (dict) –

    • nextToken (string) –

      A pagination token. If a non-null pagination token is returned in a result, pass its value in another request to retrieve more entries.

    • managedNotificationEvents (list) –

      A list of Managed Notification Events matching the request criteria.

      • (dict) –

        Describes an overview and metadata for a ManagedNotificationEvent.

        • arn (string) –

          The Amazon Resource Name (ARN) of the ManagedNotificationEvent.

        • managedNotificationConfigurationArn (string) –

          The Amazon Resource Name (ARN) of the ManagedNotificationConfiguration.

        • relatedAccount (string) –

          The account that related to the ManagedNotificationEvent.

        • creationTime (datetime) –

          The creation time of the ManagedNotificationEvent.

        • notificationEvent (dict) –

          A short summary of a ManagedNotificationEvent. This is only used when listing managed notification events.

          • schemaVersion (string) –

            The schema version of the ManagedNotificationEvent.

          • sourceEventMetadata (dict) –

            Contains metadata about the event that caused the ManagedNotificationEvent.

            • eventOriginRegion (string) –

              The Region where the notification originated.

            • source (string) –

              The source service of the notification.

              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) –

              The event Type of the notification.

          • messageComponents (dict) –

            Contains the headline message component.

            • headline (string) –

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

          • eventStatus (string) –

            The managed notification event status.

            • Values:

              • HEALTHY

                • All EventRules are ACTIVE.

              • UNHEALTHY

                • Some EventRules are ACTIVE and some are INACTIVE.

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

        • organizationalUnitId (string) –

          The Organizational Unit Id that an Amazon Web Services account belongs to.

        • aggregationSummary (dict) –

          Provides additional information about the aggregation key.

          • eventCount (integer) –

            Indicates the number of events associated with the aggregation key.

          • aggregatedBy (list) –

            Indicates the criteria or rules by which notifications have been grouped together.

            • (dict) –

              Key-value collection that indicate how notifications are grouped.

              • name (string) –

                Indicates the type of aggregation key.

              • value (string) –

                Indicates the value associated with the aggregation key name.

          • aggregatedAccounts (dict) –

            Indicates the Amazon Web Services accounts in the aggregation key.

            • name (string) –

              Name of the summarization dimension.

            • count (integer) –

              Total number of occurrences for this dimension.

            • sampleValues (list) –

              Indicates the sample values found within the dimension.

              • (string) –

          • aggregatedRegions (dict) –

            Indicates the Amazon Web Services Regions in the aggregation key.

            • name (string) –

              Name of the summarization dimension.

            • count (integer) –

              Total number of occurrences for this dimension.

            • sampleValues (list) –

              Indicates the sample values found within the dimension.

              • (string) –

          • aggregatedOrganizationalUnits (dict) –

            Indicates the collection of organizational units that are involved in the aggregation key.

            • name (string) –

              Name of the summarization dimension.

            • count (integer) –

              Total number of occurrences for this dimension.

            • sampleValues (list) –

              Indicates the sample values found within the dimension.

              • (string) –

          • additionalSummarizationDimensions (list) –

            List of additional dimensions used to group and summarize data.

            • (dict) –

              Provides an overview of how data is summarized across different dimensions.

              • name (string) –

                Name of the summarization dimension.

              • count (integer) –

                Total number of occurrences for this dimension.

              • sampleValues (list) –

                Indicates the sample values found within the dimension.

                • (string) –

        • aggregatedNotificationRegions (list) –

          The list of the regions where the aggregated notifications in this NotificationEvent originated.

          • (string) –

Exceptions