AssociateChannel

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

Associates a delivery Channel with a particular NotificationConfiguration. Supported Channels include Amazon Q Developer in chat applications, the Console Mobile Application, and emails (notifications-contacts).

Parameter Syntax

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

Parameter Details

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

AssociateManagedNotificationAdditionalChannel

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

Associates an additional Channel with a particular ManagedNotificationConfiguration.

Supported Channels include Amazon Q Developer in chat applications, the Console Mobile Application, and emails (notifications-contacts).

Parameter Syntax

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

Parameter Details

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

AssociateOrganizationalUnit

$result = $client->associateOrganizationalUnit([/* ... */]);
$promise = $client->associateOrganizationalUnitAsync([/* ... */]);

Associates an organizational unit with a notification configuration.

Parameter Syntax

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

Parameter Details

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

Result Syntax

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

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

Result Syntax

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

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ThrottlingException:

Request was denied due to request throttling.

DeleteEventRule

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

Deletes an EventRule.

Parameter Syntax

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

Parameter Details

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

DeleteNotificationConfiguration

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

Deletes a NotificationConfiguration.

Parameter Syntax

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

Parameter Details

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

DeregisterNotificationHub

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

Deregisters a NotificationConfiguration in the specified Region.

Parameter Syntax

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

Parameter Details

Result Syntax

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

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

DisassociateChannel

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

Disassociates a Channel from a specified NotificationConfiguration. Supported Channels include Amazon Q Developer in chat applications, the Console Mobile Application, and emails (notifications-contacts).

Parameter Syntax

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

Parameter Details

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

DisassociateManagedNotificationAdditionalChannel

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

Disassociates an additional Channel from a particular ManagedNotificationConfiguration.

Supported Channels include Amazon Q Developer in chat applications, the Console Mobile Application, and emails (notifications-contacts).

Parameter Syntax

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

Parameter Details

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

DisassociateOrganizationalUnit

$result = $client->disassociateOrganizationalUnit([/* ... */]);
$promise = $client->disassociateOrganizationalUnitAsync([/* ... */]);

Removes the association between an organizational unit and a notification configuration.

Parameter Syntax

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

Parameter Details

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

GetEventRule

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

Returns a specified EventRule.

Parameter Syntax

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

Parameter Details

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

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

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

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

GetManagedNotificationConfiguration

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

Returns a specified ManagedNotificationConfiguration.

Parameter Syntax

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

Parameter Details

Result Syntax

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

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

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

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

GetNotificationConfiguration

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

Returns a specified NotificationConfiguration.

Parameter Syntax

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

Parameter Details

Result Syntax

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

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

GetNotificationEvent

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

Returns a specified NotificationEvent.

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

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',
        'organizationalUnitId' => '<string>',
        '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

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

Result Syntax

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

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.

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

Result Syntax

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

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

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

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

Result Syntax

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

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

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

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

Result Syntax

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

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.

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

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

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.

ListMemberAccounts

$result = $client->listMemberAccounts([/* ... */]);
$promise = $client->listMemberAccountsAsync([/* ... */]);

Returns a list of member accounts associated with a notification configuration.

Parameter Syntax

$result = $client->listMemberAccounts([
    'maxResults' => <integer>,
    'memberAccount' => '<string>',
    'nextToken' => '<string>',
    'notificationConfigurationArn' => '<string>', // REQUIRED
    'organizationalUnitId' => '<string>',
    'status' => 'ACTIVE|PENDING|INACTIVE|CREATING|DELETING',
]);

Parameter Details

Result Syntax

[
    'memberAccounts' => [
        [
            'accountId' => '<string>',
            'notificationConfigurationArn' => '<string>',
            'organizationalUnitId' => '<string>',
            'status' => 'ACTIVE|PENDING|INACTIVE|CREATING|DELETING',
            'statusReason' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

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.

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',
    'subtype' => 'ACCOUNT|ADMIN_MANAGED',
]);

Parameter Details

Result Syntax

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

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.

ListNotificationEvents

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

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

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>',
    'organizationalUnitId' => '<string>',
    'source' => '<string>',
    'startTime' => <integer || string || DateTime>,
]);

Parameter Details

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>',
                ],
            ],
            'organizationalUnitId' => '<string>',
            'relatedAccount' => '<string>',
        ],
        // ...
    ],
]

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.

ListNotificationHubs

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

Returns a list of NotificationHubs.

Parameter Syntax

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

Parameter Details

Result Syntax

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

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.

ListOrganizationalUnits

$result = $client->listOrganizationalUnits([/* ... */]);
$promise = $client->listOrganizationalUnitsAsync([/* ... */]);

Returns a list of organizational units associated with a notification configuration.

Parameter Syntax

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

Parameter Details

Result Syntax

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

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.

ResourceNotFoundException:

Request references a resource which does not exist.

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.

Parameter Syntax

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

Parameter Details

Result Syntax

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

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

Result Syntax

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

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ThrottlingException:

Request was denied due to request throttling.

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.

Parameter Syntax

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

Parameter Details

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

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.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

Result Syntax

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

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.

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

Result Syntax

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

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.

ConflictException:

Updating or deleting a resource can cause an inconsistent state.

ResourceNotFoundException:

Request references a resource which does not exist.

ThrottlingException:

Request was denied due to request throttling.