UserNotifications / Client / deregister_notification_hub

deregister_notification_hub#

UserNotifications.Client.deregister_notification_hub(**kwargs)#

Deregisters a NotificationHub in the specified Region.

Note

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

See also: AWS API Documentation

Request Syntax

response = client.deregister_notification_hub(
    notificationHubRegion='string'
)
Parameters:

notificationHubRegion (string) –

[REQUIRED]

The NotificationHub Region.

Return type:

dict

Returns:

Response Syntax

{
    'notificationHubRegion': 'string',
    'statusSummary': {
        'status': 'ACTIVE'|'REGISTERING'|'DEREGISTERING'|'INACTIVE',
        'reason': 'string'
    }
}

Response Structure

  • (dict) –

    • notificationHubRegion (string) –

      The NotificationHub Region.

    • statusSummary (dict) –

      NotificationHub status information.

      • status (string) –

        Status information about the NotificationHub.

        • Values:

          • ACTIVE

            • Incoming NotificationEvents are replicated to this NotificationHub.

          • REGISTERING

            • The NotificationHub is initializing. A NotificationHub with this status can’t be deregistered.

          • DEREGISTERING

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

      • reason (string) –

        An Explanation for the current status.

Exceptions

  • UserNotifications.Client.exceptions.AccessDeniedException

  • UserNotifications.Client.exceptions.ValidationException

  • UserNotifications.Client.exceptions.InternalServerException

  • UserNotifications.Client.exceptions.ThrottlingException

  • UserNotifications.Client.exceptions.ConflictException

  • UserNotifications.Client.exceptions.ResourceNotFoundException