delete_event_subscription

RDS.Client.delete_event_subscription(**kwargs)

Deletes an RDS event notification subscription.

See also: AWS API Documentation

Request Syntax

response = client.delete_event_subscription(
    SubscriptionName='string'
)
Parameters
SubscriptionName (string) --

[REQUIRED]

The name of the RDS event notification subscription you want to delete.

Return type
dict
Returns
Response Syntax
{
    'EventSubscription': {
        'CustomerAwsId': 'string',
        'CustSubscriptionId': 'string',
        'SnsTopicArn': 'string',
        'Status': 'string',
        'SubscriptionCreationTime': 'string',
        'SourceType': 'string',
        'SourceIdsList': [
            'string',
        ],
        'EventCategoriesList': [
            'string',
        ],
        'Enabled': True|False,
        'EventSubscriptionArn': 'string'
    }
}

Response Structure

  • (dict) --
    • EventSubscription (dict) --

      Contains the results of a successful invocation of the DescribeEventSubscriptions action.

      • CustomerAwsId (string) --

        The Amazon Web Services customer account associated with the RDS event notification subscription.

      • CustSubscriptionId (string) --

        The RDS event notification subscription Id.

      • SnsTopicArn (string) --

        The topic ARN of the RDS event notification subscription.

      • Status (string) --

        The status of the RDS event notification subscription.

        Constraints:

        Can be one of the following: creating | modifying | deleting | active | no-permission | topic-not-exist

        The status "no-permission" indicates that RDS no longer has permission to post to the SNS topic. The status "topic-not-exist" indicates that the topic was deleted after the subscription was created.

      • SubscriptionCreationTime (string) --

        The time the RDS event notification subscription was created.

      • SourceType (string) --

        The source type for the RDS event notification subscription.

      • SourceIdsList (list) --

        A list of source IDs for the RDS event notification subscription.

        • (string) --
      • EventCategoriesList (list) --

        A list of event categories for the RDS event notification subscription.

        • (string) --
      • Enabled (boolean) --

        A Boolean value indicating if the subscription is enabled. True indicates the subscription is enabled.

      • EventSubscriptionArn (string) --

        The Amazon Resource Name (ARN) for the event subscription.

Exceptions

  • RDS.Client.exceptions.SubscriptionNotFoundFault
  • RDS.Client.exceptions.InvalidEventSubscriptionStateFault

Examples

This example deletes the specified DB event subscription.

response = client.delete_event_subscription(
    SubscriptionName='myeventsubscription',
)

print(response)

Expected Output:

{
    'EventSubscription': {
    },
    'ResponseMetadata': {
        '...': '...',
    },
}