SDK for PHP 3.x

Client: Aws\Notifications\NotificationsClient
Service ID: notifications
Version: 2018-05-10

This page describes the parameters and results for the operations of the AWS User Notifications (2018-05-10), and shows how to use the Aws\Notifications\NotificationsClient object to call the described operations. This documentation is specific to the 2018-05-10 API version of the service.

Operation Summary

Each of the following operations can be created from a client using $client->getCommand('CommandName'), where "CommandName" is the name of one of the following operations. Note: a command is a value that encapsulates an operation and the parameters used to create an HTTP request.

You can also create and send a command immediately using the magic methods available on a client object: $client->commandName(/* parameters */). You can send the command asynchronously (returning a promise) by appending the word "Async" to the operation name: $client->commandNameAsync(/* parameters */).

AssociateChannel ( array $params = [] )
Associates a delivery Channel with a particular NotificationConfiguration.
AssociateManagedNotificationAccountContact ( array $params = [] )
Associates an Account Contact with a particular ManagedNotificationConfiguration.
AssociateManagedNotificationAdditionalChannel ( array $params = [] )
Associates an additional Channel with a particular ManagedNotificationConfiguration.
CreateEventRule ( array $params = [] )
Creates an EventRule that is associated with a specified NotificationConfiguration.
CreateNotificationConfiguration ( array $params = [] )
Creates a new NotificationConfiguration.
DeleteEventRule ( array $params = [] )
Deletes an EventRule.
DeleteNotificationConfiguration ( array $params = [] )
Deletes a NotificationConfiguration.
DeregisterNotificationHub ( array $params = [] )
Deregisters a NotificationConfiguration in the specified Region.
DisableNotificationsAccessForOrganization ( array $params = [] )
Disables service trust between User Notifications and Amazon Web Services Organizations.
DisassociateChannel ( array $params = [] )
Disassociates a Channel from a specified NotificationConfiguration.
DisassociateManagedNotificationAccountContact ( array $params = [] )
Disassociates an Account Contact with a particular ManagedNotificationConfiguration.
DisassociateManagedNotificationAdditionalChannel ( array $params = [] )
Disassociates an additional Channel from a particular ManagedNotificationConfiguration.
EnableNotificationsAccessForOrganization ( array $params = [] )
Enables service trust between User Notifications and Amazon Web Services Organizations.
GetEventRule ( array $params = [] )
Returns a specified EventRule.
GetManagedNotificationChildEvent ( array $params = [] )
Returns the child event of a specific given ManagedNotificationEvent.
GetManagedNotificationConfiguration ( array $params = [] )
Returns a specified ManagedNotificationConfiguration.
GetManagedNotificationEvent ( array $params = [] )
Returns a specified ManagedNotificationEvent.
GetNotificationConfiguration ( array $params = [] )
Returns a specified NotificationConfiguration.
GetNotificationEvent ( array $params = [] )
Returns a specified NotificationEvent.
GetNotificationsAccessForOrganization ( array $params = [] )
Returns the AccessStatus of Service Trust Enablement for User Notifications and Amazon Web Services Organizations.
ListChannels ( array $params = [] )
Returns a list of Channels for a NotificationConfiguration.
ListEventRules ( array $params = [] )
Returns a list of EventRules according to specified filters, in reverse chronological order (newest first).
ListManagedNotificationChannelAssociations ( array $params = [] )
Returns a list of Account contacts and Channels associated with a ManagedNotificationConfiguration, in paginated format.
ListManagedNotificationChildEvents ( array $params = [] )
Returns a list of ManagedNotificationChildEvents for a specified aggregate ManagedNotificationEvent, ordered by creation time in reverse chronological order (newest first).
ListManagedNotificationConfigurations ( array $params = [] )
Returns a list of Managed Notification Configurations according to specified filters, ordered by creation time in reverse chronological order (newest first).
ListManagedNotificationEvents ( array $params = [] )
Returns a list of Managed Notification Events according to specified filters, ordered by creation time in reverse chronological order (newest first).
ListNotificationConfigurations ( array $params = [] )
Returns a list of abbreviated NotificationConfigurations according to specified filters, in reverse chronological order (newest first).
ListNotificationEvents ( array $params = [] )
Returns a list of NotificationEvents according to specified filters, in reverse chronological order (newest first).
ListNotificationHubs ( array $params = [] )
Returns a list of NotificationHubs.
ListTagsForResource ( array $params = [] )
Returns a list of tags for a specified Amazon Resource Name (ARN).
RegisterNotificationHub ( array $params = [] )
Registers a NotificationConfiguration in the specified Region.
TagResource ( array $params = [] )
Tags the resource with a tag key and value.
UntagResource ( array $params = [] )
Untags a resource with a specified Amazon Resource Name (ARN).
UpdateEventRule ( array $params = [] )
Updates an existing EventRule.
UpdateNotificationConfiguration ( array $params = [] )
Updates a NotificationConfiguration.

Paginators

Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:

ListChannels
ListEventRules
ListManagedNotificationChannelAssociations
ListManagedNotificationChildEvents
ListManagedNotificationConfigurations
ListManagedNotificationEvents
ListNotificationConfigurations
ListNotificationEvents
ListNotificationHubs

Operations

AssociateChannel

$result = $client->associateChannel([/* ... */]);
$promise = $client->associateChannelAsync([/* ... */]);

Associates a delivery Channel with a particular NotificationConfiguration. Supported Channels include Chatbot, the Console Mobile Application, and emails (notifications-contacts).

Parameter Syntax

$result = $client->associateChannel([
    'arn' => '<string>', // REQUIRED
    'notificationConfigurationArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the Channel to associate with the NotificationConfiguration.

Supported ARNs include Chatbot, the Console Mobile Application, and notifications-contacts.

notificationConfigurationArn
Required: Yes
Type: string

The ARN of the NotificationConfiguration to associate with the Channel.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ServiceQuotaExceededException:

Request would cause a service quota to be exceeded.

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

AssociateManagedNotificationAccountContact

$result = $client->associateManagedNotificationAccountContact([/* ... */]);
$promise = $client->associateManagedNotificationAccountContactAsync([/* ... */]);

Associates an Account Contact with a particular ManagedNotificationConfiguration.

Parameter Syntax

$result = $client->associateManagedNotificationAccountContact([
    'contactIdentifier' => 'ACCOUNT_PRIMARY|ACCOUNT_ALTERNATE_BILLING|ACCOUNT_ALTERNATE_OPERATIONS|ACCOUNT_ALTERNATE_SECURITY', // REQUIRED
    'managedNotificationConfigurationArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
contactIdentifier
Required: Yes
Type: string

A unique value of an Account Contact Type to associate with the ManagedNotificationConfiguration.

managedNotificationConfigurationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationConfiguration to associate with the Account Contact.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ServiceQuotaExceededException:

Request would cause a service quota to be exceeded.

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

AssociateManagedNotificationAdditionalChannel

$result = $client->associateManagedNotificationAdditionalChannel([/* ... */]);
$promise = $client->associateManagedNotificationAdditionalChannelAsync([/* ... */]);

Associates an additional Channel with a particular ManagedNotificationConfiguration.

Supported Channels include Chatbot, the Console Mobile Application, and emails (notifications-contacts).

Parameter Syntax

$result = $client->associateManagedNotificationAdditionalChannel([
    'channelArn' => '<string>', // REQUIRED
    'managedNotificationConfigurationArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
channelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the Channel to associate with the ManagedNotificationConfiguration.

Supported ARNs include Chatbot, the Console Mobile Application, and email (notifications-contacts).

managedNotificationConfigurationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationConfiguration to associate with the additional Channel.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ServiceQuotaExceededException:

Request would cause a service quota to be exceeded.

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

CreateEventRule

$result = $client->createEventRule([/* ... */]);
$promise = $client->createEventRuleAsync([/* ... */]);

Creates an EventRule that is associated with a specified NotificationConfiguration.

Parameter Syntax

$result = $client->createEventRule([
    'eventPattern' => '<string>',
    'eventType' => '<string>', // REQUIRED
    'notificationConfigurationArn' => '<string>', // REQUIRED
    'regions' => ['<string>', ...], // REQUIRED
    'source' => '<string>', // REQUIRED
]);

Parameter Details

Members
eventPattern
Type: 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.

eventType
Required: Yes
Type: string

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.

notificationConfigurationArn
Required: Yes
Type: string

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

regions
Required: Yes
Type: Array of strings

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

source
Required: Yes
Type: string

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.

Result Syntax

[
    'arn' => '<string>',
    'notificationConfigurationArn' => '<string>',
    'statusSummaryByRegion' => [
        '<Region>' => [
            'reason' => '<string>',
            'status' => 'ACTIVE|INACTIVE|CREATING|UPDATING|DELETING',
        ],
        // ...
    ],
]

Result Details

Members
arn
Required: Yes
Type: string

The ARN of the resource.

notificationConfigurationArn
Required: Yes
Type: string

The ARN of a NotificationConfiguration.

statusSummaryByRegion
Required: Yes
Type: Associative array of custom strings keys (Region) to EventRuleStatusSummary structures

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

Errors

ServiceQuotaExceededException:

Request would cause a service quota to be exceeded.

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

CreateNotificationConfiguration

$result = $client->createNotificationConfiguration([/* ... */]);
$promise = $client->createNotificationConfigurationAsync([/* ... */]);

Creates a new NotificationConfiguration.

Parameter Syntax

$result = $client->createNotificationConfiguration([
    'aggregationDuration' => 'LONG|SHORT|NONE',
    'description' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'tags' => ['<string>', ...],
]);

Parameter Details

Members
aggregationDuration
Type: string

The aggregation preference of the NotificationConfiguration.

  • Values:

    • LONG

      • Aggregate notifications for long periods of time (12 hours).

    • SHORT

      • Aggregate notifications for short periods of time (5 minutes).

    • NONE

      • Don't aggregate notifications.

description
Required: Yes
Type: string

The description of the NotificationConfiguration.

name
Required: Yes
Type: string

The name of the NotificationConfiguration. Supports RFC 3986's unreserved characters.

tags
Type: Associative array of custom strings keys (TagKey) to strings

A map of tags assigned to a resource. A tag is a string-to-string map of key-value pairs.

Result Syntax

[
    'arn' => '<string>',
    'status' => 'ACTIVE|PARTIALLY_ACTIVE|INACTIVE|DELETING',
]

Result Details

Members
arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the NotificationConfiguration.

status
Required: Yes
Type: string

The current status of this NotificationConfiguration.

Errors

ServiceQuotaExceededException:

Request would cause a service quota to be exceeded.

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

DeleteEventRule

$result = $client->deleteEventRule([/* ... */]);
$promise = $client->deleteEventRuleAsync([/* ... */]);

Deletes an EventRule.

Parameter Syntax

$result = $client->deleteEventRule([
    'arn' => '<string>', // REQUIRED
]);

Parameter Details

Members
arn
Required: Yes
Type: string

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

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

DeleteNotificationConfiguration

$result = $client->deleteNotificationConfiguration([/* ... */]);
$promise = $client->deleteNotificationConfigurationAsync([/* ... */]);

Deletes a NotificationConfiguration.

Parameter Syntax

$result = $client->deleteNotificationConfiguration([
    'arn' => '<string>', // REQUIRED
]);

Parameter Details

Members
arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the NotificationConfiguration to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

DeregisterNotificationHub

$result = $client->deregisterNotificationHub([/* ... */]);
$promise = $client->deregisterNotificationHubAsync([/* ... */]);

Deregisters a NotificationConfiguration in the specified Region.

You can't deregister the last NotificationHub in the account. NotificationEvents stored in the deregistered NotificationConfiguration are no longer be visible. Recreating a new NotificationConfiguration in the same Region restores access to those NotificationEvents.

Parameter Syntax

$result = $client->deregisterNotificationHub([
    'notificationHubRegion' => '<string>', // REQUIRED
]);

Parameter Details

Members
notificationHubRegion
Required: Yes
Type: string

The NotificationConfiguration Region.

Result Syntax

[
    'notificationHubRegion' => '<string>',
    'statusSummary' => [
        'reason' => '<string>',
        'status' => 'ACTIVE|REGISTERING|DEREGISTERING|INACTIVE',
    ],
]

Result Details

Members
notificationHubRegion
Required: Yes
Type: string

The NotificationConfiguration Region.

statusSummary
Required: Yes
Type: NotificationHubStatusSummary structure

NotificationConfiguration status information.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

DisableNotificationsAccessForOrganization

$result = $client->disableNotificationsAccessForOrganization([/* ... */]);
$promise = $client->disableNotificationsAccessForOrganizationAsync([/* ... */]);

Disables service trust between User Notifications and Amazon Web Services Organizations.

Parameter Syntax

$result = $client->disableNotificationsAccessForOrganization([
]);

Parameter Details

Members

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ServiceQuotaExceededException:

Request would cause a service quota to be exceeded.

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

DisassociateChannel

$result = $client->disassociateChannel([/* ... */]);
$promise = $client->disassociateChannelAsync([/* ... */]);

Disassociates a Channel from a specified NotificationConfiguration. Supported Channels include Chatbot, the Console Mobile Application, and emails (notifications-contacts).

Parameter Syntax

$result = $client->disassociateChannel([
    'arn' => '<string>', // REQUIRED
    'notificationConfigurationArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the Channel to disassociate.

notificationConfigurationArn
Required: Yes
Type: string

The ARN of the NotificationConfiguration to disassociate.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

DisassociateManagedNotificationAccountContact

$result = $client->disassociateManagedNotificationAccountContact([/* ... */]);
$promise = $client->disassociateManagedNotificationAccountContactAsync([/* ... */]);

Disassociates an Account Contact with a particular ManagedNotificationConfiguration.

Parameter Syntax

$result = $client->disassociateManagedNotificationAccountContact([
    'contactIdentifier' => 'ACCOUNT_PRIMARY|ACCOUNT_ALTERNATE_BILLING|ACCOUNT_ALTERNATE_OPERATIONS|ACCOUNT_ALTERNATE_SECURITY', // REQUIRED
    'managedNotificationConfigurationArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
contactIdentifier
Required: Yes
Type: string

The unique value of an Account Contact Type to associate with the ManagedNotificationConfiguration.

managedNotificationConfigurationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationConfiguration to associate with the Account Contact.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

DisassociateManagedNotificationAdditionalChannel

$result = $client->disassociateManagedNotificationAdditionalChannel([/* ... */]);
$promise = $client->disassociateManagedNotificationAdditionalChannelAsync([/* ... */]);

Disassociates an additional Channel from a particular ManagedNotificationConfiguration.

Supported Channels include Chatbot, the Console Mobile Application, and emails (notifications-contacts).

Parameter Syntax

$result = $client->disassociateManagedNotificationAdditionalChannel([
    'channelArn' => '<string>', // REQUIRED
    'managedNotificationConfigurationArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
channelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the Channel to associate with the ManagedNotificationConfiguration.

managedNotificationConfigurationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the Managed Notification Configuration to associate with the additional Channel.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

EnableNotificationsAccessForOrganization

$result = $client->enableNotificationsAccessForOrganization([/* ... */]);
$promise = $client->enableNotificationsAccessForOrganizationAsync([/* ... */]);

Enables service trust between User Notifications and Amazon Web Services Organizations.

Parameter Syntax

$result = $client->enableNotificationsAccessForOrganization([
]);

Parameter Details

Members

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ServiceQuotaExceededException:

Request would cause a service quota to be exceeded.

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

GetEventRule

$result = $client->getEventRule([/* ... */]);
$promise = $client->getEventRuleAsync([/* ... */]);

Returns a specified EventRule.

Parameter Syntax

$result = $client->getEventRule([
    'arn' => '<string>', // REQUIRED
]);

Parameter Details

Members
arn
Required: Yes
Type: string

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

Result Syntax

[
    'arn' => '<string>',
    'creationTime' => <DateTime>,
    'eventPattern' => '<string>',
    'eventType' => '<string>',
    'managedRules' => ['<string>', ...],
    'notificationConfigurationArn' => '<string>',
    'regions' => ['<string>', ...],
    'source' => '<string>',
    'statusSummaryByRegion' => [
        '<Region>' => [
            'reason' => '<string>',
            'status' => 'ACTIVE|INACTIVE|CREATING|UPDATING|DELETING',
        ],
        // ...
    ],
]

Result Details

Members
arn
Required: Yes
Type: string

The ARN of the resource.

creationTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date when the EventRule was created.

eventPattern
Required: Yes
Type: 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.

eventType
Required: Yes
Type: string

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.

managedRules
Required: Yes
Type: Array of strings

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

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

notificationConfigurationArn
Required: Yes
Type: string

The ARN of a NotificationConfiguration.

regions
Required: Yes
Type: Array of strings

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

source
Required: Yes
Type: string

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.

statusSummaryByRegion
Required: Yes
Type: Associative array of custom strings keys (Region) to EventRuleStatusSummary structures

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

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

GetManagedNotificationChildEvent

$result = $client->getManagedNotificationChildEvent([/* ... */]);
$promise = $client->getManagedNotificationChildEventAsync([/* ... */]);

Returns the child event of a specific given ManagedNotificationEvent.

Parameter Syntax

$result = $client->getManagedNotificationChildEvent([
    'arn' => '<string>', // REQUIRED
    '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',
]);

Parameter Details

Members
arn
Required: Yes
Type: string

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

locale
Type: string

The locale code of the language used for the retrieved ManagedNotificationChildEvent. The default locale is English en_US.

Result Syntax

[
    'arn' => '<string>',
    'content' => [
        'aggregateManagedNotificationEventArn' => '<string>',
        'aggregationDetail' => [
            'summarizationDimensions' => [
                [
                    'name' => '<string>',
                    'value' => '<string>',
                ],
                // ...
            ],
        ],
        'endTime' => <DateTime>,
        'eventStatus' => 'HEALTHY|UNHEALTHY',
        'id' => '<string>',
        'messageComponents' => [
            'completeDescription' => '<string>',
            'dimensions' => [
                [
                    'name' => '<string>',
                    'value' => '<string>',
                ],
                // ...
            ],
            'headline' => '<string>',
            'paragraphSummary' => '<string>',
        ],
        'notificationType' => 'ALERT|WARNING|ANNOUNCEMENT|INFORMATIONAL',
        'organizationalUnitId' => '<string>',
        'schemaVersion' => 'v1.0',
        'sourceEventDetailUrl' => '<string>',
        'sourceEventDetailUrlDisplayText' => '<string>',
        'startTime' => <DateTime>,
        'textParts' => [
            '<TextPartId>' => [
                'displayText' => '<string>',
                'textByLocale' => ['<string>', ...],
                'type' => 'LOCALIZED_TEXT|PLAIN_TEXT|URL',
                'url' => '<string>',
            ],
            // ...
        ],
    ],
    'creationTime' => <DateTime>,
    'managedNotificationConfigurationArn' => '<string>',
]

Result Details

Members
arn
Required: Yes
Type: string

The ARN of the resource.

content
Required: Yes
Type: ManagedNotificationChildEvent structure

The content of the ManagedNotificationChildEvent.

creationTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The creation time of the ManagedNotificationChildEvent.

managedNotificationConfigurationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationConfiguration associated with the ManagedNotificationChildEvent.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

GetManagedNotificationConfiguration

$result = $client->getManagedNotificationConfiguration([/* ... */]);
$promise = $client->getManagedNotificationConfigurationAsync([/* ... */]);

Returns a specified ManagedNotificationConfiguration.

Parameter Syntax

$result = $client->getManagedNotificationConfiguration([
    'arn' => '<string>', // REQUIRED
]);

Parameter Details

Members
arn
Required: Yes
Type: string

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

Result Syntax

[
    'arn' => '<string>',
    'category' => '<string>',
    'description' => '<string>',
    'name' => '<string>',
    'subCategory' => '<string>',
]

Result Details

Members
arn
Required: Yes
Type: string

The ARN of the ManagedNotificationConfiguration resource.

category
Required: Yes
Type: string

The category of the ManagedNotificationConfiguration.

description
Required: Yes
Type: string

The description of the ManagedNotificationConfiguration.

name
Required: Yes
Type: string

The name of the ManagedNotificationConfiguration.

subCategory
Required: Yes
Type: string

The subCategory of the ManagedNotificationConfiguration.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

GetManagedNotificationEvent

$result = $client->getManagedNotificationEvent([/* ... */]);
$promise = $client->getManagedNotificationEventAsync([/* ... */]);

Returns a specified ManagedNotificationEvent.

Parameter Syntax

$result = $client->getManagedNotificationEvent([
    'arn' => '<string>', // REQUIRED
    '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',
]);

Parameter Details

Members
arn
Required: Yes
Type: string

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

locale
Type: string

The locale code of the language used for the retrieved ManagedNotificationEvent. The default locale is English (en_US).

Result Syntax

[
    'arn' => '<string>',
    'content' => [
        'aggregationEventType' => 'AGGREGATE|CHILD|NONE',
        'aggregationSummary' => [
            'additionalSummarizationDimensions' => [
                [
                    'count' => <integer>,
                    'name' => '<string>',
                    'sampleValues' => ['<string>', ...],
                ],
                // ...
            ],
            'aggregatedAccounts' => [
                'count' => <integer>,
                'name' => '<string>',
                'sampleValues' => ['<string>', ...],
            ],
            'aggregatedBy' => [
                [
                    'name' => '<string>',
                    'value' => '<string>',
                ],
                // ...
            ],
            'aggregatedOrganizationalUnits' => [
                'count' => <integer>,
                'name' => '<string>',
                'sampleValues' => ['<string>', ...],
            ],
            'aggregatedRegions' => [
                'count' => <integer>,
                'name' => '<string>',
                'sampleValues' => ['<string>', ...],
            ],
            'eventCount' => <integer>,
        ],
        'endTime' => <DateTime>,
        'eventStatus' => 'HEALTHY|UNHEALTHY',
        'id' => '<string>',
        'messageComponents' => [
            'completeDescription' => '<string>',
            'dimensions' => [
                [
                    'name' => '<string>',
                    'value' => '<string>',
                ],
                // ...
            ],
            'headline' => '<string>',
            'paragraphSummary' => '<string>',
        ],
        'notificationType' => 'ALERT|WARNING|ANNOUNCEMENT|INFORMATIONAL',
        'organizationalUnitId' => '<string>',
        'schemaVersion' => 'v1.0',
        'sourceEventDetailUrl' => '<string>',
        'sourceEventDetailUrlDisplayText' => '<string>',
        'startTime' => <DateTime>,
        'textParts' => [
            '<TextPartId>' => [
                'displayText' => '<string>',
                'textByLocale' => ['<string>', ...],
                'type' => 'LOCALIZED_TEXT|PLAIN_TEXT|URL',
                'url' => '<string>',
            ],
            // ...
        ],
    ],
    'creationTime' => <DateTime>,
    'managedNotificationConfigurationArn' => '<string>',
]

Result Details

Members
arn
Required: Yes
Type: string

The ARN of the resource.

content
Required: Yes
Type: ManagedNotificationEvent structure

The content of the ManagedNotificationEvent.

creationTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The creation time of the ManagedNotificationEvent.

managedNotificationConfigurationArn
Required: Yes
Type: string

The ARN of the ManagedNotificationConfiguration.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

GetNotificationConfiguration

$result = $client->getNotificationConfiguration([/* ... */]);
$promise = $client->getNotificationConfigurationAsync([/* ... */]);

Returns a specified NotificationConfiguration.

Parameter Syntax

$result = $client->getNotificationConfiguration([
    'arn' => '<string>', // REQUIRED
]);

Parameter Details

Members
arn
Required: Yes
Type: string

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

Result Syntax

[
    'aggregationDuration' => 'LONG|SHORT|NONE',
    'arn' => '<string>',
    'creationTime' => <DateTime>,
    'description' => '<string>',
    'name' => '<string>',
    'status' => 'ACTIVE|PARTIALLY_ACTIVE|INACTIVE|DELETING',
]

Result Details

Members
aggregationDuration
Type: string

The aggregation preference of the NotificationConfiguration.

  • Values:

    • LONG

      • Aggregate notifications for long periods of time (12 hours).

    • SHORT

      • Aggregate notifications for short periods of time (5 minutes).

    • NONE

      • Don't aggregate notifications.

arn
Required: Yes
Type: string

The ARN of the resource.

creationTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The creation time of the NotificationConfiguration.

description
Required: Yes
Type: string

The description of the NotificationConfiguration.

name
Required: Yes
Type: string

The name of the NotificationConfiguration.

status
Required: Yes
Type: string

The status of this NotificationConfiguration.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

GetNotificationEvent

$result = $client->getNotificationEvent([/* ... */]);
$promise = $client->getNotificationEventAsync([/* ... */]);

Returns a specified NotificationEvent.

User Notifications stores notifications in the individual Regions you register as notification hubs and the Region of the source event rule. GetNotificationEvent only returns notifications stored in the same Region in which the action is called. User Notifications doesn't backfill notifications to new Regions selected as notification hubs. For this reason, we recommend that you make calls in your oldest registered notification hub. For more information, see Notification hubs in the Amazon Web Services User Notifications User Guide.

Parameter Syntax

$result = $client->getNotificationEvent([
    'arn' => '<string>', // REQUIRED
    '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',
]);

Parameter Details

Members
arn
Required: Yes
Type: string

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

locale
Type: string

The locale code of the language used for the retrieved NotificationEvent. The default locale is English en_US.

Result Syntax

[
    'arn' => '<string>',
    'content' => [
        'aggregateNotificationEventArn' => '<string>',
        'aggregationEventType' => 'AGGREGATE|CHILD|NONE',
        'aggregationSummary' => [
            'additionalSummarizationDimensions' => [
                [
                    'count' => <integer>,
                    'name' => '<string>',
                    'sampleValues' => ['<string>', ...],
                ],
                // ...
            ],
            'aggregatedAccounts' => [
                'count' => <integer>,
                'name' => '<string>',
                'sampleValues' => ['<string>', ...],
            ],
            'aggregatedBy' => [
                [
                    'name' => '<string>',
                    'value' => '<string>',
                ],
                // ...
            ],
            'aggregatedOrganizationalUnits' => [
                'count' => <integer>,
                'name' => '<string>',
                'sampleValues' => ['<string>', ...],
            ],
            'aggregatedRegions' => [
                'count' => <integer>,
                'name' => '<string>',
                'sampleValues' => ['<string>', ...],
            ],
            'eventCount' => <integer>,
        ],
        'endTime' => <DateTime>,
        'eventStatus' => 'HEALTHY|UNHEALTHY',
        'id' => '<string>',
        'media' => [
            [
                'caption' => '<string>',
                'mediaId' => '<string>',
                'type' => 'IMAGE',
                'url' => '<string>',
            ],
            // ...
        ],
        'messageComponents' => [
            'completeDescription' => '<string>',
            'dimensions' => [
                [
                    'name' => '<string>',
                    'value' => '<string>',
                ],
                // ...
            ],
            'headline' => '<string>',
            'paragraphSummary' => '<string>',
        ],
        'notificationType' => 'ALERT|WARNING|ANNOUNCEMENT|INFORMATIONAL',
        'schemaVersion' => 'v1.0',
        'sourceEventDetailUrl' => '<string>',
        'sourceEventDetailUrlDisplayText' => '<string>',
        'sourceEventMetadata' => [
            'eventOccurrenceTime' => <DateTime>,
            'eventOriginRegion' => '<string>',
            'eventType' => '<string>',
            'eventTypeVersion' => '<string>',
            'relatedAccount' => '<string>',
            'relatedResources' => [
                [
                    'arn' => '<string>',
                    'detailUrl' => '<string>',
                    'id' => '<string>',
                    'tags' => ['<string>', ...],
                ],
                // ...
            ],
            'source' => '<string>',
            'sourceEventId' => '<string>',
        ],
        'startTime' => <DateTime>,
        'textParts' => [
            '<TextPartId>' => [
                'displayText' => '<string>',
                'textByLocale' => ['<string>', ...],
                'type' => 'LOCALIZED_TEXT|PLAIN_TEXT|URL',
                'url' => '<string>',
            ],
            // ...
        ],
    ],
    'creationTime' => <DateTime>,
    'notificationConfigurationArn' => '<string>',
]

Result Details

Members
arn
Required: Yes
Type: string

The ARN of the resource.

content
Required: Yes
Type: NotificationEvent structure

The content of the NotificationEvent.

creationTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The creation time of the NotificationEvent.

notificationConfigurationArn
Required: Yes
Type: string

The ARN of the NotificationConfiguration.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

GetNotificationsAccessForOrganization

$result = $client->getNotificationsAccessForOrganization([/* ... */]);
$promise = $client->getNotificationsAccessForOrganizationAsync([/* ... */]);

Returns the AccessStatus of Service Trust Enablement for User Notifications and Amazon Web Services Organizations.

Parameter Syntax

$result = $client->getNotificationsAccessForOrganization([
]);

Parameter Details

Members

Result Syntax

[
    'notificationsAccessForOrganization' => [
        'accessStatus' => 'ENABLED|DISABLED|PENDING',
    ],
]

Result Details

Members
notificationsAccessForOrganization
Required: Yes
Type: NotificationsAccessForOrganization structure

The AccessStatus of Service Trust Enablement for User Notifications to Amazon Web Services Organizations.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ListChannels

$result = $client->listChannels([/* ... */]);
$promise = $client->listChannelsAsync([/* ... */]);

Returns a list of Channels for a NotificationConfiguration.

Parameter Syntax

$result = $client->listChannels([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'notificationConfigurationArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
maxResults
Type: int

The maximum number of results to be returned in this call. The default value is 20.

nextToken
Type: string

The start token for paginated calls. Retrieved from the response of a previous ListNotificationEvents call. NextToken uses Base64 encoding.

notificationConfigurationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the NotificationConfiguration.

Result Syntax

[
    'channels' => ['<string>', ...],
    'nextToken' => '<string>',
]

Result Details

Members
channels
Required: Yes
Type: Array of strings

A list of Channels.

nextToken
Type: 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.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

ListEventRules

$result = $client->listEventRules([/* ... */]);
$promise = $client->listEventRulesAsync([/* ... */]);

Returns a list of EventRules according to specified filters, in reverse chronological order (newest first).

Parameter Syntax

$result = $client->listEventRules([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'notificationConfigurationArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
maxResults
Type: int

The maximum number of results to be returned in this call. The default value is 20.

nextToken
Type: string

The start token for paginated calls. Retrieved from the response of a previous ListEventRules call. Next token uses Base64 encoding.

notificationConfigurationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the NotificationConfiguration.

Result Syntax

[
    'eventRules' => [
        [
            'arn' => '<string>',
            'creationTime' => <DateTime>,
            'eventPattern' => '<string>',
            'eventType' => '<string>',
            'managedRules' => ['<string>', ...],
            'notificationConfigurationArn' => '<string>',
            'regions' => ['<string>', ...],
            'source' => '<string>',
            'statusSummaryByRegion' => [
                '<Region>' => [
                    'reason' => '<string>',
                    'status' => 'ACTIVE|INACTIVE|CREATING|UPDATING|DELETING',
                ],
                // ...
            ],
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
eventRules
Required: Yes
Type: Array of EventRuleStructure structures

A list of EventRules.

nextToken
Type: 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.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

ListManagedNotificationChannelAssociations

$result = $client->listManagedNotificationChannelAssociations([/* ... */]);
$promise = $client->listManagedNotificationChannelAssociationsAsync([/* ... */]);

Returns a list of Account contacts and Channels associated with a ManagedNotificationConfiguration, in paginated format.

Parameter Syntax

$result = $client->listManagedNotificationChannelAssociations([
    'managedNotificationConfigurationArn' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
managedNotificationConfigurationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationConfiguration to match.

maxResults
Type: int

The maximum number of results to be returned in this call. Defaults to 20.

nextToken
Type: string

The start token for paginated calls. Retrieved from the response of a previous ListManagedNotificationChannelAssociations call.

Result Syntax

[
    'channelAssociations' => [
        [
            'channelIdentifier' => '<string>',
            'channelType' => 'MOBILE|CHATBOT|EMAIL|ACCOUNT_CONTACT',
            'overrideOption' => 'ENABLED|DISABLED',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
channelAssociations
Required: Yes
Type: Array of ManagedNotificationChannelAssociationSummary structures

A list that contains the following information about a channel association.

nextToken
Type: 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.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

ListManagedNotificationChildEvents

$result = $client->listManagedNotificationChildEvents([/* ... */]);
$promise = $client->listManagedNotificationChildEventsAsync([/* ... */]);

Returns a list of ManagedNotificationChildEvents for a specified aggregate ManagedNotificationEvent, ordered by creation time in reverse chronological order (newest first).

Parameter Syntax

$result = $client->listManagedNotificationChildEvents([
    'aggregateManagedNotificationEventArn' => '<string>', // REQUIRED
    'endTime' => <integer || string || DateTime>,
    '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',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'organizationalUnitId' => '<string>',
    'relatedAccount' => '<string>',
    'startTime' => <integer || string || DateTime>,
]);

Parameter Details

Members
aggregateManagedNotificationEventArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationEvent.

endTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

Latest time of events to return from this call.

locale
Type: string

The locale code of the language used for the retrieved NotificationEvent. The default locale is English.en_US.

maxResults
Type: int

The maximum number of results to be returned in this call. Defaults to 20.

nextToken
Type: string

The start token for paginated calls. Retrieved from the response of a previous ListManagedNotificationChannelAssociations call. Next token uses Base64 encoding.

organizationalUnitId
Type: string

The identifier of the Amazon Web Services Organizations organizational unit (OU) associated with the Managed Notification Child Events.

relatedAccount
Type: string

The Amazon Web Services account ID associated with the Managed Notification Child Events.

startTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The earliest time of events to return from this call.

Result Syntax

[
    'managedNotificationChildEvents' => [
        [
            'aggregateManagedNotificationEventArn' => '<string>',
            'arn' => '<string>',
            'childEvent' => [
                'aggregationDetail' => [
                    'summarizationDimensions' => [
                        [
                            'name' => '<string>',
                            'value' => '<string>',
                        ],
                        // ...
                    ],
                ],
                'eventStatus' => 'HEALTHY|UNHEALTHY',
                'messageComponents' => [
                    'headline' => '<string>',
                ],
                'notificationType' => 'ALERT|WARNING|ANNOUNCEMENT|INFORMATIONAL',
                'schemaVersion' => 'v1.0',
                'sourceEventMetadata' => [
                    'eventOriginRegion' => '<string>',
                    'eventType' => '<string>',
                    'source' => '<string>',
                ],
            ],
            'creationTime' => <DateTime>,
            'managedNotificationConfigurationArn' => '<string>',
            'organizationalUnitId' => '<string>',
            'relatedAccount' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
managedNotificationChildEvents
Required: Yes
Type: Array of ManagedNotificationChildEventOverview structures

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

nextToken
Type: 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.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ListManagedNotificationConfigurations

$result = $client->listManagedNotificationConfigurations([/* ... */]);
$promise = $client->listManagedNotificationConfigurationsAsync([/* ... */]);

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

Parameter Syntax

$result = $client->listManagedNotificationConfigurations([
    'channelIdentifier' => '<string>',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
channelIdentifier
Type: string

The identifier or ARN of the notification channel to filter configurations by.

maxResults
Type: int

The maximum number of results to be returned in this call. Defaults to 20.

nextToken
Type: string

The start token for paginated calls. Retrieved from the response of a previous ListManagedNotificationChannelAssociations call. Next token uses Base64 encoding.

Result Syntax

[
    'managedNotificationConfigurations' => [
        [
            'arn' => '<string>',
            'description' => '<string>',
            'name' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
managedNotificationConfigurations
Required: Yes
Type: Array of ManagedNotificationConfigurationStructure structures

A list of Managed Notification Configurations matching the request criteria.

nextToken
Type: 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.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ListManagedNotificationEvents

$result = $client->listManagedNotificationEvents([/* ... */]);
$promise = $client->listManagedNotificationEventsAsync([/* ... */]);

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

Parameter Syntax

$result = $client->listManagedNotificationEvents([
    'endTime' => <integer || string || DateTime>,
    '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',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'organizationalUnitId' => '<string>',
    'relatedAccount' => '<string>',
    'source' => '<string>',
    'startTime' => <integer || string || DateTime>,
]);

Parameter Details

Members
endTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

Latest time of events to return from this call.

locale
Type: string

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

maxResults
Type: int

The maximum number of results to be returned in this call. Defaults to 20.

nextToken
Type: string

The start token for paginated calls. Retrieved from the response of a previous ListManagedNotificationChannelAssociations call. Next token uses Base64 encoding.

organizationalUnitId
Type: string

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

relatedAccount
Type: string

The Amazon Web Services account ID associated with the Managed Notification Events.

source
Type: string

The Amazon Web Services service the event originates from. For example aws.cloudwatch.

startTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The earliest time of events to return from this call.

Result Syntax

[
    'managedNotificationEvents' => [
        [
            'aggregatedNotificationRegions' => ['<string>', ...],
            'aggregationEventType' => 'AGGREGATE|CHILD|NONE',
            'aggregationSummary' => [
                'additionalSummarizationDimensions' => [
                    [
                        'count' => <integer>,
                        'name' => '<string>',
                        'sampleValues' => ['<string>', ...],
                    ],
                    // ...
                ],
                'aggregatedAccounts' => [
                    'count' => <integer>,
                    'name' => '<string>',
                    'sampleValues' => ['<string>', ...],
                ],
                'aggregatedBy' => [
                    [
                        'name' => '<string>',
                        'value' => '<string>',
                    ],
                    // ...
                ],
                'aggregatedOrganizationalUnits' => [
                    'count' => <integer>,
                    'name' => '<string>',
                    'sampleValues' => ['<string>', ...],
                ],
                'aggregatedRegions' => [
                    'count' => <integer>,
                    'name' => '<string>',
                    'sampleValues' => ['<string>', ...],
                ],
                'eventCount' => <integer>,
            ],
            'arn' => '<string>',
            'creationTime' => <DateTime>,
            'managedNotificationConfigurationArn' => '<string>',
            'notificationEvent' => [
                'eventStatus' => 'HEALTHY|UNHEALTHY',
                'messageComponents' => [
                    'headline' => '<string>',
                ],
                'notificationType' => 'ALERT|WARNING|ANNOUNCEMENT|INFORMATIONAL',
                'schemaVersion' => 'v1.0',
                'sourceEventMetadata' => [
                    'eventOriginRegion' => '<string>',
                    'eventType' => '<string>',
                    'source' => '<string>',
                ],
            ],
            'organizationalUnitId' => '<string>',
            'relatedAccount' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
managedNotificationEvents
Required: Yes
Type: Array of ManagedNotificationEventOverview structures

A list of Managed Notification Events matching the request criteria.

nextToken
Type: 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.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ListNotificationConfigurations

$result = $client->listNotificationConfigurations([/* ... */]);
$promise = $client->listNotificationConfigurationsAsync([/* ... */]);

Returns a list of abbreviated NotificationConfigurations according to specified filters, in reverse chronological order (newest first).

Parameter Syntax

$result = $client->listNotificationConfigurations([
    'channelArn' => '<string>',
    'eventRuleSource' => '<string>',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'status' => 'ACTIVE|PARTIALLY_ACTIVE|INACTIVE|DELETING',
]);

Parameter Details

Members
channelArn
Type: string

The Amazon Resource Name (ARN) of the Channel to match.

eventRuleSource
Type: string

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.

maxResults
Type: int

The maximum number of results to be returned in this call. Defaults to 20.

nextToken
Type: string

The start token for paginated calls. Retrieved from the response of a previous ListEventRules call. Next token uses Base64 encoding.

status
Type: string

The NotificationConfiguration status to match.

  • Values:

    • ACTIVE

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

    • PARTIALLY_ACTIVE

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

      • Any call can be run.

    • INACTIVE

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

    • DELETING

      • This NotificationConfiguration is being deleted.

      • Only GET and LIST calls can be run.

Result Syntax

[
    'nextToken' => '<string>',
    'notificationConfigurations' => [
        [
            'aggregationDuration' => 'LONG|SHORT|NONE',
            'arn' => '<string>',
            'creationTime' => <DateTime>,
            'description' => '<string>',
            'name' => '<string>',
            'status' => 'ACTIVE|PARTIALLY_ACTIVE|INACTIVE|DELETING',
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: 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.

notificationConfigurations
Required: Yes
Type: Array of NotificationConfigurationStructure structures

The NotificationConfigurations in the account.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ListNotificationEvents

$result = $client->listNotificationEvents([/* ... */]);
$promise = $client->listNotificationEventsAsync([/* ... */]);

Returns a list of NotificationEvents according to specified filters, in reverse chronological order (newest first).

User Notifications stores notifications in the individual Regions you register as notification hubs and the Region of the source event rule. ListNotificationEvents only returns notifications stored in the same Region in which the action is called. User Notifications doesn't backfill notifications to new Regions selected as notification hubs. For this reason, we recommend that you make calls in your oldest registered notification hub. For more information, see Notification hubs in the Amazon Web Services User Notifications User Guide.

Parameter Syntax

$result = $client->listNotificationEvents([
    'aggregateNotificationEventArn' => '<string>',
    'endTime' => <integer || string || DateTime>,
    'includeChildEvents' => true || false,
    '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',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'source' => '<string>',
    'startTime' => <integer || string || DateTime>,
]);

Parameter Details

Members
aggregateNotificationEventArn
Type: string

The Amazon Resource Name (ARN) of the aggregatedNotificationEventArn to match.

endTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

Latest time of events to return from this call.

includeChildEvents
Type: boolean

Include aggregated child events in the result.

locale
Type: string

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

maxResults
Type: int

The maximum number of results to be returned in this call. Defaults to 20.

nextToken
Type: string

The start token for paginated calls. Retrieved from the response of a previous ListEventRules call. Next token uses Base64 encoding.

source
Type: string

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.

startTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The earliest time of events to return from this call.

Result Syntax

[
    'nextToken' => '<string>',
    'notificationEvents' => [
        [
            'aggregateNotificationEventArn' => '<string>',
            'aggregationEventType' => 'AGGREGATE|CHILD|NONE',
            'aggregationSummary' => [
                'additionalSummarizationDimensions' => [
                    [
                        'count' => <integer>,
                        'name' => '<string>',
                        'sampleValues' => ['<string>', ...],
                    ],
                    // ...
                ],
                'aggregatedAccounts' => [
                    'count' => <integer>,
                    'name' => '<string>',
                    'sampleValues' => ['<string>', ...],
                ],
                'aggregatedBy' => [
                    [
                        'name' => '<string>',
                        'value' => '<string>',
                    ],
                    // ...
                ],
                'aggregatedOrganizationalUnits' => [
                    'count' => <integer>,
                    'name' => '<string>',
                    'sampleValues' => ['<string>', ...],
                ],
                'aggregatedRegions' => [
                    'count' => <integer>,
                    'name' => '<string>',
                    'sampleValues' => ['<string>', ...],
                ],
                'eventCount' => <integer>,
            ],
            'arn' => '<string>',
            'creationTime' => <DateTime>,
            'notificationConfigurationArn' => '<string>',
            'notificationEvent' => [
                'eventStatus' => 'HEALTHY|UNHEALTHY',
                'messageComponents' => [
                    'headline' => '<string>',
                ],
                'notificationType' => 'ALERT|WARNING|ANNOUNCEMENT|INFORMATIONAL',
                'schemaVersion' => 'v1.0',
                'sourceEventMetadata' => [
                    'eventOriginRegion' => '<string>',
                    'eventType' => '<string>',
                    'source' => '<string>',
                ],
            ],
            'relatedAccount' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: 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.

notificationEvents
Required: Yes
Type: Array of NotificationEventOverview structures

The list of notification events.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ListNotificationHubs

$result = $client->listNotificationHubs([/* ... */]);
$promise = $client->listNotificationHubsAsync([/* ... */]);

Returns a list of NotificationHubs.

Parameter Syntax

$result = $client->listNotificationHubs([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

The maximum number of records to list in a single response.

nextToken
Type: string

A pagination token. Set to null to start listing notification hubs from the start.

Result Syntax

[
    'nextToken' => '<string>',
    'notificationHubs' => [
        [
            'creationTime' => <DateTime>,
            'lastActivationTime' => <DateTime>,
            'notificationHubRegion' => '<string>',
            'statusSummary' => [
                'reason' => '<string>',
                'status' => 'ACTIVE|REGISTERING|DEREGISTERING|INACTIVE',
            ],
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: 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.

notificationHubs
Required: Yes
Type: Array of NotificationHubOverview structures

The NotificationHubs in the account.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ListTagsForResource

$result = $client->listTagsForResource([/* ... */]);
$promise = $client->listTagsForResourceAsync([/* ... */]);

Returns a list of tags for a specified Amazon Resource Name (ARN).

For more information, see Tagging your Amazon Web Services resources in the Tagging Amazon Web Services Resources User Guide.

This is only supported for NotificationConfigurations.

Parameter Syntax

$result = $client->listTagsForResource([
    'arn' => '<string>', // REQUIRED
]);

Parameter Details

Members
arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) to use to list tags.

Result Syntax

[
    'tags' => ['<string>', ...],
]

Result Details

Members
tags
Type: Associative array of custom strings keys (TagKey) to strings

A list of tags for the specified ARN.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

RegisterNotificationHub

$result = $client->registerNotificationHub([/* ... */]);
$promise = $client->registerNotificationHubAsync([/* ... */]);

Registers a NotificationConfiguration in the specified Region.

There is a maximum of one NotificationConfiguration per Region. You can have a maximum of 3 NotificationHub resources at a time.

Parameter Syntax

$result = $client->registerNotificationHub([
    'notificationHubRegion' => '<string>', // REQUIRED
]);

Parameter Details

Members
notificationHubRegion
Required: Yes
Type: string

The Region of the NotificationHub.

Result Syntax

[
    'creationTime' => <DateTime>,
    'lastActivationTime' => <DateTime>,
    'notificationHubRegion' => '<string>',
    'statusSummary' => [
        'reason' => '<string>',
        'status' => 'ACTIVE|REGISTERING|DEREGISTERING|INACTIVE',
    ],
]

Result Details

Members
creationTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date the resource was created.

lastActivationTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date the resource was last activated.

notificationHubRegion
Required: Yes
Type: string

The Region of the NotificationHub.

statusSummary
Required: Yes
Type: NotificationHubStatusSummary structure

Provides additional information about the current NotificationConfiguration status information.

Errors

ServiceQuotaExceededException:

Request would cause a service quota to be exceeded.

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

TagResource

$result = $client->tagResource([/* ... */]);
$promise = $client->tagResourceAsync([/* ... */]);

Tags the resource with a tag key and value.

For more information, see Tagging your Amazon Web Services resources in the Tagging Amazon Web Services Resources User Guide.

This is only supported for NotificationConfigurations.

Parameter Syntax

$result = $client->tagResource([
    'arn' => '<string>', // REQUIRED
    'tags' => ['<string>', ...], // REQUIRED
]);

Parameter Details

Members
arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) to use to tag a resource.

tags
Required: Yes
Type: Associative array of custom strings keys (TagKey) to strings

A map of tags assigned to a resource. A tag is a string-to-string map of key-value pairs.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

UntagResource

$result = $client->untagResource([/* ... */]);
$promise = $client->untagResourceAsync([/* ... */]);

Untags a resource with a specified Amazon Resource Name (ARN).

For more information, see Tagging your Amazon Web Services resources in the Tagging Amazon Web Services Resources User Guide.

Parameter Syntax

$result = $client->untagResource([
    'arn' => '<string>', // REQUIRED
    'tagKeys' => ['<string>', ...], // REQUIRED
]);

Parameter Details

Members
arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) to use to untag a resource.

tagKeys
Required: Yes
Type: Array of strings

The tag keys to use to untag a resource.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ResourceNotFoundException:

Request references a resource which does not exist.

UpdateEventRule

$result = $client->updateEventRule([/* ... */]);
$promise = $client->updateEventRuleAsync([/* ... */]);

Updates an existing EventRule.

Parameter Syntax

$result = $client->updateEventRule([
    'arn' => '<string>', // REQUIRED
    'eventPattern' => '<string>',
    'regions' => ['<string>', ...],
]);

Parameter Details

Members
arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) to use to update the EventRule.

eventPattern
Type: 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
Type: Array of strings

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

Result Syntax

[
    'arn' => '<string>',
    'notificationConfigurationArn' => '<string>',
    'statusSummaryByRegion' => [
        '<Region>' => [
            'reason' => '<string>',
            'status' => 'ACTIVE|INACTIVE|CREATING|UPDATING|DELETING',
        ],
        // ...
    ],
]

Result Details

Members
arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) to use to update the EventRule.

notificationConfigurationArn
Required: Yes
Type: string

The ARN of the NotificationConfiguration.

statusSummaryByRegion
Required: Yes
Type: Associative array of custom strings keys (Region) to EventRuleStatusSummary structures

The status of the action by Region.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

UpdateNotificationConfiguration

$result = $client->updateNotificationConfiguration([/* ... */]);
$promise = $client->updateNotificationConfigurationAsync([/* ... */]);

Updates a NotificationConfiguration.

Parameter Syntax

$result = $client->updateNotificationConfiguration([
    'aggregationDuration' => 'LONG|SHORT|NONE',
    'arn' => '<string>', // REQUIRED
    'description' => '<string>',
    'name' => '<string>',
]);

Parameter Details

Members
aggregationDuration
Type: string

The aggregation preference of the NotificationConfiguration.

  • Values:

    • LONG

      • Aggregate notifications for long periods of time (12 hours).

    • SHORT

      • Aggregate notifications for short periods of time (5 minutes).

    • NONE

      • Don't aggregate notifications.

arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) used to update the NotificationConfiguration.

description
Type: string

The description of the NotificationConfiguration.

name
Type: string

The name of the NotificationConfiguration.

Result Syntax

[
    'arn' => '<string>',
]

Result Details

Members
arn
Required: Yes
Type: string

The ARN used to update the NotificationConfiguration.

Errors

AccessDeniedException:

User does not have sufficient access to perform this action.

ValidationException:

This exception is thrown when the notification event fails validation.

InternalServerException:

Unexpected error during processing of request.

ThrottlingException:

Request was denied due to request throttling.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

Shapes

AccessDeniedException

Description

User does not have sufficient access to perform this action.

Members
message
Required: Yes
Type: string

AggregationDetail

Description

Provides detailed information about the dimensions used for aggregation.

Members
summarizationDimensions
Type: Array of SummarizationDimensionDetail structures

Properties used to summarize aggregated events.

AggregationKey

Description

Key-value collection that indicate how notifications are grouped.

Members
name
Required: Yes
Type: string

Indicates the type of aggregation key.

value
Required: Yes
Type: string

Indicates the value associated with the aggregation key name.

AggregationSummary

Description

Provides additional information about the aggregation key.

Members
additionalSummarizationDimensions
Type: Array of SummarizationDimensionOverview structures

List of additional dimensions used to group and summarize data.

aggregatedAccounts
Required: Yes
Type: SummarizationDimensionOverview structure

Indicates the Amazon Web Services accounts in the aggregation key.

aggregatedBy
Required: Yes
Type: Array of AggregationKey structures

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

aggregatedOrganizationalUnits

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

aggregatedRegions
Required: Yes
Type: SummarizationDimensionOverview structure

Indicates the Amazon Web Services Regions in the aggregation key.

eventCount
Required: Yes
Type: int

Indicates the number of events associated with the aggregation key.

ConflictException

Description

Updating or deleting a resource can cause an inconsistent state.

Members
message
Required: Yes
Type: string
resourceId
Required: Yes
Type: string

The resource ID that prompted the conflict error.

Dimension

Description

The key-value pair of properties for an event.

Members
name
Required: Yes
Type: string

The name of the dimension

value
Required: Yes
Type: string

The value of the dimension.

EventRuleStatusSummary

Description

Provides additional information about the current EventRule status.

Members
reason
Required: Yes
Type: string

A human-readable reason for EventRuleStatus.

status
Required: Yes
Type: 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.

EventRuleStructure

Description

Contains a complete list of fields related to an EventRule.

Members
arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the EventRule. CloudFormation stack generates this ARN and then uses this ARN to associate with the NotificationConfiguration.

creationTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The creation time of the EventRule.

eventPattern
Required: Yes
Type: 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.

eventType
Required: Yes
Type: string

The event type this rule should match with the EventBridge events. It must match with atleast one of the valid EventBridge event types. For example, Amazon EC2 Instance State change Notification and Amazon CloudWatch State Change. For more information, see Event delivery from Amazon Web Services services in the Amazon EventBridge User Guide.

managedRules
Required: Yes
Type: Array of strings

A list of Amazon EventBridge Managed Rule ARNs associated with this EventRule.

These are created by User Notifications within your account so your EventRules can function.

notificationConfigurationArn
Required: Yes
Type: string

The ARN for the NotificationConfiguration associated with this EventRule.

regions
Required: Yes
Type: Array of strings

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

source
Required: Yes
Type: string

The event source this rule should match with the EventBridge event sources. It must match with atleast one of the valid EventBridge event 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.

statusSummaryByRegion
Required: Yes
Type: Associative array of custom strings keys (Region) to EventRuleStatusSummary structures

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

InternalServerException

Description

Unexpected error during processing of request.

Members
message
Required: Yes
Type: string

ManagedNotificationChannelAssociationSummary

Description

Provides a summary of channel associations for a managed notification configuration.

Members
channelIdentifier
Required: Yes
Type: string

The unique identifier for the notification channel.

channelType
Required: Yes
Type: string

The type of notification channel used for message delivery.

  • Values:

    • ACCOUNT_CONTACT

      • Delivers notifications to Account Managed contacts through the User Notification Service.

    • MOBILE

      • Delivers notifications through the Amazon Web Services Console Mobile Application to mobile devices.

    • CHATBOT

      • Delivers notifications through Chatbot to collaboration platforms (Slack, Chime).

    • EMAIL

      • Delivers notifications to email addresses.

overrideOption
Type: string

Controls whether users can modify channel associations for a notification configuration.

  • Values:

    • ENABLED

      • Users can associate or disassociate channels with the notification configuration.

    • DISABLED

      • Users cannot associate or disassociate channels with the notification configuration.

ManagedNotificationChildEvent

Description

A ManagedNotificationChildEvent is a notification-focused representation of an event. They contain semantic information used to create aggregated or non-aggregated end-user notifications.

Members
aggregateManagedNotificationEventArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationEvent that is associated with this Managed Notification Child Event.

aggregationDetail
Type: AggregationDetail structure

Provides detailed information about the dimensions used for event summarization and aggregation.

endTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The end time of the event.

eventStatus
Type: string

The assesed nature of the event.

  • Values:

    • HEALTHY

      • All EventRules are ACTIVE.

    • UNHEALTHY

      • Some EventRules are ACTIVE and some are INACTIVE.

id
Required: Yes
Type: string

The unique identifier for a Managed Notification Child Event.

messageComponents
Required: Yes
Type: MessageComponents structure

Describes the components of a notification message.

notificationType
Required: Yes
Type: 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.

organizationalUnitId
Type: string

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

schemaVersion
Required: Yes
Type: string

The schema version of the Managed Notification Child Event.

sourceEventDetailUrl
Type: string

The source event URL.

sourceEventDetailUrlDisplayText
Type: string

The detailed URL for the source event.

startTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The notification event start time.

textParts
Required: Yes
Type: Associative array of custom strings keys (TextPartId) to TextPartValue structures

A list of text values.

ManagedNotificationChildEventOverview

Description

Describes an overview and metadata for a ManagedNotificationChildEvent.

Members
aggregateManagedNotificationEventArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationEvent that is associated with this ManagedNotificationChildEvent.

arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationChildEvent.

childEvent
Required: Yes
Type: ManagedNotificationChildEventSummary structure

The content of the ManagedNotificationChildEvent.

creationTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The creation time of the ManagedNotificationChildEvent.

managedNotificationConfigurationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationConfiguration.

organizationalUnitId
Type: string

The Organizational Unit Id that an AWS account belongs to.

relatedAccount
Required: Yes
Type: string

The account that related to the ManagedNotificationChildEvent.

ManagedNotificationChildEventSummary

Description

Describes a short summary and metadata for a ManagedNotificationChildEvent.

Members
aggregationDetail
Required: Yes
Type: AggregationDetail structure

Provides detailed information about the dimensions used for event summarization and aggregation.

eventStatus
Required: Yes
Type: string

The perceived nature of the event.

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

messageComponents
Required: Yes
Type: MessageComponentsSummary structure

Contains the headline message component.

notificationType
Required: Yes
Type: string

The Type of the event causing this 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.

schemaVersion
Required: Yes
Type: string

The schema version of the ManagedNotificationChildEvent.

sourceEventMetadata
Required: Yes
Type: ManagedSourceEventMetadataSummary structure

Contains all event metadata present identically across all NotificationEvents. All fields are present in Source Events via Eventbridge.

ManagedNotificationConfigurationStructure

Description

Describes the basic structure and properties of a ManagedNotificationConfiguration.

Members
arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationConfiguration.

description
Required: Yes
Type: string

The description of the ManagedNotificationConfiguration.

name
Required: Yes
Type: string

The name of the ManagedNotificationConfiguration.

ManagedNotificationEvent

Description

A notification-focused representation of an event. They contain semantic information used by AccountContacts or Additional Channels to create end-user notifications.

Members
aggregationEventType
Type: string

The notifications aggregation type.

aggregationSummary
Type: AggregationSummary structure

Provides additional information about the aggregation key.

endTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The end time of the notification event.

eventStatus
Type: string

The status of an event.

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

id
Required: Yes
Type: string

Unique identifier for a ManagedNotificationEvent.

messageComponents
Required: Yes
Type: MessageComponents structure

Describes the components of a notification message.

notificationType
Required: Yes
Type: string

The nature of the event causing this 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.

organizationalUnitId
Type: string

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

schemaVersion
Required: Yes
Type: string

Version of the ManagedNotificationEvent schema.

sourceEventDetailUrl
Type: string

URL defined by Source Service to be used by notification consumers to get additional information about event.

sourceEventDetailUrlDisplayText
Type: string

Text that needs to be hyperlinked with the sourceEventDetailUrl. For example, the description of the sourceEventDetailUrl.

startTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The earliest time of events to return from this call.

textParts
Required: Yes
Type: Associative array of custom strings keys (TextPartId) to TextPartValue structures

A list of text values.

ManagedNotificationEventOverview

Description

Describes an overview and metadata for a ManagedNotificationEvent.

Members
aggregatedNotificationRegions
Type: Array of strings

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

aggregationEventType
Type: 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.

aggregationSummary
Type: AggregationSummary structure

Provides additional information about the aggregation key.

arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationEvent.

creationTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The creation time of the ManagedNotificationEvent.

managedNotificationConfigurationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ManagedNotificationConfiguration.

notificationEvent
Required: Yes
Type: ManagedNotificationEventSummary structure

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

organizationalUnitId
Type: string

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

relatedAccount
Required: Yes
Type: string

The account that related to the ManagedNotificationEvent.

ManagedNotificationEventSummary

Description

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

Members
eventStatus
Required: Yes
Type: string

The managed notification event status.

  • Values:

    • HEALTHY

      • All EventRules are ACTIVE.

    • UNHEALTHY

      • Some EventRules are ACTIVE and some are INACTIVE.

messageComponents
Required: Yes
Type: MessageComponentsSummary structure

Contains the headline message component.

notificationType
Required: Yes
Type: 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.

schemaVersion
Required: Yes
Type: string

The schema version of the ManagedNotificationEvent.

sourceEventMetadata
Required: Yes
Type: ManagedSourceEventMetadataSummary structure

Contains metadata about the event that caused the ManagedNotificationEvent.

ManagedSourceEventMetadataSummary

Description

A short summary and metadata for a managed notification event.

Members
eventOriginRegion
Type: string

The Region where the notification originated.

eventType
Required: Yes
Type: string

The event Type of the notification.

source
Required: Yes
Type: 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.

MediaElement

Description

Describes a media element.

Members
caption
Required: Yes
Type: string

The caption of the media.

mediaId
Required: Yes
Type: string

The unique ID for the media.

type
Required: Yes
Type: string

The type of media.

url
Required: Yes
Type: string

The URL of the media.

MessageComponents

Description

Describes the components of a notification message.

Members
completeDescription
Type: string

A complete summary with all possible relevant information.

dimensions
Type: Array of Dimension structures

A list of properties in key-value pairs. Pairs are shown in order of importance from most important to least important. Channels may limit the number of dimensions shown to the notification viewer.

Included dimensions, keys, and values are subject to change.

headline
Type: string

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

paragraphSummary
Type: string

A paragraph long or multiple sentence summary. For example, Chatbot notifications.

MessageComponentsSummary

Description

Contains the headline message component.

Members
headline
Required: Yes
Type: string

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

NotificationConfigurationStructure

Description

Contains the complete list of fields for a NotificationConfiguration.

Members
aggregationDuration
Type: string

The aggregation preference of the NotificationConfiguration.

  • Values:

    • LONG

      • Aggregate notifications for long periods of time (12 hours).

    • SHORT

      • Aggregate notifications for short periods of time (5 minutes).

    • NONE

      • Don't aggregate notifications.

arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the NotificationConfiguration resource.

creationTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The creation time of the NotificationConfiguration.

description
Required: Yes
Type: string

The description of the NotificationConfiguration.

name
Required: Yes
Type: string

The name of the NotificationConfiguration. Supports RFC 3986's unreserved characters.

status
Required: Yes
Type: string

The current status of the NotificationConfiguration.

NotificationEvent

Description

A NotificationEvent is a notification-focused representation of an event. They contain semantic information used by Channels to create end-user notifications.

Members
aggregateNotificationEventArn
Type: string

If the value of aggregationEventType is not NONE, this is the Amazon Resource Event (ARN) of the parent aggregate notification.

This is omitted if notification isn't aggregated.

aggregationEventType
Type: string

The aggregation type of the NotificationConfiguration.

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

aggregationSummary
Type: AggregationSummary structure

Provides additional information about how multiple notifications are grouped.

endTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The end time of the event.

eventStatus
Type: string

The assessed nature of the event.

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

id
Required: Yes
Type: string

The unique identifier for a NotificationEvent.

media
Required: Yes
Type: Array of MediaElement structures

A list of media elements.

messageComponents
Required: Yes
Type: MessageComponents structure

Describes the components of a notification message.

notificationType
Required: Yes
Type: 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.

schemaVersion
Required: Yes
Type: string

The schema version of the Notification Event.

sourceEventDetailUrl
Type: string

The source event URL.

sourceEventDetailUrlDisplayText
Type: string

The detailed URL for the source event.

sourceEventMetadata
Required: Yes
Type: SourceEventMetadata structure

The source event metadata.

startTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The notification event start time.

textParts
Required: Yes
Type: Associative array of custom strings keys (TextPartId) to TextPartValue structures

A list of text values.

NotificationEventOverview

Description

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

Members
aggregateNotificationEventArn
Type: string

The ARN of the aggregatedNotificationEventArn to match.

aggregationEventType
Type: 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.

aggregationSummary
Type: AggregationSummary structure

Provides an aggregated summary data for notification events.

arn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the resource.

creationTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The creation time of the NotificationEvent.

notificationConfigurationArn
Required: Yes
Type: string

The ARN of the NotificationConfiguration.

notificationEvent
Required: Yes
Type: NotificationEventSummary structure

Refers to a NotificationEventSummary object.

Similar in structure to content in the GetNotificationEvent response.

relatedAccount
Required: Yes
Type: string

The account name containing the NotificationHub.

NotificationEventSummary

Description

Describes a short summary and metadata for a NotificationEvent.

Members
eventStatus
Required: Yes
Type: string

Provides additional information about the current status of the NotificationEvent.

  • Values:

    • HEALTHY

      • All EventRules are ACTIVE.

    • UNHEALTHY

      • Some EventRules are ACTIVE and some are INACTIVE.

messageComponents
Required: Yes
Type: MessageComponentsSummary structure

The message components of a notification event.

notificationType
Required: Yes
Type: 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.

schemaVersion
Required: Yes
Type: string

The schema version of the Notification Event.

sourceEventMetadata
Required: Yes
Type: SourceEventMetadataSummary structure

The source event metadata.

NotificationHubOverview

Description

Describes an overview of a NotificationHub.

A NotificationConfiguration is an account-level setting used to select the Regions where you want to store, process and replicate your notifications.

Members
creationTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time the NotificationHubOverview was created.

lastActivationTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time this NotificationHub had an ACTIVE status.

notificationHubRegion
Required: Yes
Type: string

The Region of the resource.

statusSummary
Required: Yes
Type: NotificationHubStatusSummary structure

The status summary of the resource.

NotificationHubStatusSummary

Description

Provides additional information about the current NotificationHub status.

Members
reason
Required: Yes
Type: string

An explanation for the current status.

status
Required: Yes
Type: string

Status information about the NotificationHub.

  • Values:

    • ACTIVE

      • Incoming NotificationEvents are replicated to this NotificationHub.

    • REGISTERING

      • The NotificationConfiguration is initializing. A NotificationConfiguration with this status can't be deregistered.

    • DEREGISTERING

      • The NotificationConfiguration is being deleted. You can't register additional NotificationHubs in the same Region as a NotificationConfiguration with this status.

NotificationsAccessForOrganization

Description

Orgs Service trust for User Notifications.

Members
accessStatus
Required: Yes
Type: string

Access Status for the Orgs Service.

Resource

Description

A resource affected by or closely linked to an event.

Members
arn
Type: string

The Amazon Resource Name (ARN) of the resource. At least one id or ARN is required.

detailUrl
Type: string

The URL to the resource's detail page. If a detail page URL is unavailable, it is the URL to an informational page that describes the resource's type.

id
Type: string

The unique identifier for the resource.

At least one id or ARN is required.

tags
Type: Array of strings

A map of tags assigned to a resource. A tag is a string-to-string map of key-value pairs.

ResourceNotFoundException

Description

Request references a resource which does not exist.

Members
message
Required: Yes
Type: string
resourceId
Required: Yes
Type: string

The ID of the resource that wasn't found.

ServiceQuotaExceededException

Description

Request would cause a service quota to be exceeded.

Members
message
Required: Yes
Type: string
quotaCode
Type: string

The code for the service quota in Service Quotas.

resourceId
Type: string

The ID of the resource that exceeds the service quota.

resourceType
Required: Yes
Type: string

The type of the resource that exceeds the service quota.

serviceCode
Type: string

The code for the service quota exceeded in Service Quotas.

SourceEventMetadata

Description

Describes the metadata for a source event.

For more information, see Event structure reference in the Amazon EventBridge User Guide.

Members
eventOccurrenceTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time the source event occurred. This is based on the Source Event.

eventOriginRegion
Type: string

The Region the event originated from.

eventType
Required: Yes
Type: string

The type of event. For example, an Amazon CloudWatch state change.

eventTypeVersion
Required: Yes
Type: string

The version of the type of event.

relatedAccount
Required: Yes
Type: string

The primary Amazon Web Services account of SourceEvent.

relatedResources
Required: Yes
Type: Array of Resource structures

A list of resources related to this NotificationEvent.

source
Required: Yes
Type: string

The Amazon Web Services service the event originates from. For example aws.cloudwatch.

sourceEventId
Required: Yes
Type: string

The source event id.

SourceEventMetadataSummary

Description

Contains metadata about the event that caused the NotificationEvent. For other specific values, see sourceEventMetadata.

Members
eventOriginRegion
Type: string

The Region where the notification originated.

Unavailable for aggregated notifications.

eventType
Required: Yes
Type: string

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.

source
Required: Yes
Type: string

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.

SummarizationDimensionDetail

Description

Provides detailed information about the dimensions used for event summarization and aggregation.

Members
name
Required: Yes
Type: string

The name of the SummarizationDimensionDetail.

value
Required: Yes
Type: string

Value of the property used to summarize aggregated events.

SummarizationDimensionOverview

Description

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

Members
count
Required: Yes
Type: int

Total number of occurrences for this dimension.

name
Required: Yes
Type: string

Name of the summarization dimension.

sampleValues
Type: Array of strings

Indicates the sample values found within the dimension.

TextPartValue

Description

Describes text information objects containing fields that determine how text part objects are composed.

Members
displayText
Type: string

A short single line description of the link. Must be hyper-linked with the URL itself.

Used for text parts with the type URL.

textByLocale
Type: Associative array of custom strings keys (LocaleCode) to strings

A map of locales to the text in that locale.

type
Required: Yes
Type: string

The type of text part. Determines the usage of all other fields and whether or not they're required.

url
Type: string

The URL itself.

ThrottlingException

Description

Request was denied due to request throttling.

Members
message
Required: Yes
Type: string
quotaCode
Type: string

Identifies the quota that is being throttled.

retryAfterSeconds
Type: int

The number of seconds a client should wait before retrying the request.

serviceCode
Type: string

Identifies the service being throttled.

ValidationException

Description

This exception is thrown when the notification event fails validation.

Members
fieldList
Type: Array of ValidationExceptionField structures

The list of input fields that are invalid.

message
Required: Yes
Type: string
reason
Type: string

The reason why your input is considered invalid.

ValidationExceptionField

Description

Stores information about a field passed inside a request that resulted in an exception.

Members
message
Required: Yes
Type: string

A message with the reason for the validation exception error.

name
Required: Yes
Type: string

The field name where the invalid entry was detected.