AWS User Notifications 2018-05-10
- 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
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
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
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 thisEventRule
. - 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
andaws.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 toEventRuleStatusSummary
.
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
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
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
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
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
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
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
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
andaws.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 toEventRuleStatusSummary
.
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 Englishen_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 theManagedNotificationChildEvent
.
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 Englishen_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
andaws.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
areACTIVE
and any call can be run.
-
-
PARTIALLY_ACTIVE
-
Some
EventRules
areACTIVE
and some areINACTIVE
. Any call can be run. -
Any call can be run.
-
-
INACTIVE
-
All
EventRules
areINACTIVE
and any call can be run.
-
-
DELETING
-
This
NotificationConfiguration
is being deleted. -
Only
GET
andLIST
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
andaws.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
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
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
-
- Type: SummarizationDimensionOverview structure
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
andLIST
calls can be run.
-
-
UPDATING
-
The
EventRule
is being updated.Only
GET
andLIST
calls can be run.
-
-
DELETING
-
The
EventRule
is being deleted.Only
GET
andLIST
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 theNotificationConfiguration
. - 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 thisEventRule
. - 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
andaws.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 toEventRuleStatusSummary
.
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
areACTIVE
.
-
-
UNHEALTHY
-
Some
EventRules
areACTIVE
and some areINACTIVE
.
-
-
- 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 areINACTIVE
. 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 areINACTIVE
. 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
areACTIVE
and some areINACTIVE
. 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
areACTIVE
.
-
-
UNHEALTHY
-
Some
EventRules
areACTIVE
and some areINACTIVE
.
-
-
- 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
andaws.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 notNONE
, 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
areACTIVE
and some areINACTIVE
. 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
areACTIVE
and any call can be run.
-
-
UNHEALTHY
-
Some
EventRules
areACTIVE
and some areINACTIVE
. 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
areACTIVE
and some areINACTIVE
. 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 theGetNotificationEvent
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
areACTIVE
.
-
-
UNHEALTHY
-
Some
EventRules
areACTIVE
and some areINACTIVE
.
-
-
- 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 anACTIVE
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 thisNotificationHub
.
-
-
REGISTERING
-
The
NotificationConfiguration
is initializing. ANotificationConfiguration
with this status can't be deregistered.
-
-
DEREGISTERING
-
The
NotificationConfiguration
is being deleted. You can't register additionalNotificationHubs
in the same Region as aNotificationConfiguration
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
andaws.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.