CfnEventSubscriptionProps

class aws_cdk.aws_rds.CfnEventSubscriptionProps(*, sns_topic_arn, enabled=None, event_categories=None, source_ids=None, source_type=None, subscription_name=None, tags=None)

Bases: object

Properties for defining a CfnEventSubscription.

Parameters:

sns_topic_arn (str) – The Amazon Resource Name (ARN) of the SNS topic created for event notification. SNS automatically creates the ARN when you create a topic and subscribe to it. .. epigraph:: RDS doesn’t support FIFO (first in, first out) topics. For more information, see Message ordering and deduplication (FIFO topics) in the Amazon Simple Notification Service Developer Guide .
enabled (Union[bool, IResolvable, None]) – Specifies whether to activate the subscription. If the event notification subscription isn’t activated, the subscription is created but not active. Default: - true
event_categories (Optional[Sequence[str]]) – A list of event categories for a particular source type ( SourceType ) that you want to subscribe to. You can see a list of the categories for a given source type in the “Amazon RDS event categories and event messages” section of the *Amazon RDS User Guide* or the *Amazon Aurora User Guide* . You can also see this list by using the DescribeEventCategories operation.
source_ids (Optional[Sequence[str]]) – The list of identifiers of the event sources for which events are returned. If not specified, then all sources are included in the response. An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens. It can’t end with a hyphen or contain two consecutive hyphens. Constraints: - If SourceIds are supplied, SourceType must also be provided. - If the source type is a DB instance, a DBInstanceIdentifier value must be supplied. - If the source type is a DB cluster, a DBClusterIdentifier value must be supplied. - If the source type is a DB parameter group, a DBParameterGroupName value must be supplied. - If the source type is a DB security group, a DBSecurityGroupName value must be supplied. - If the source type is a DB snapshot, a DBSnapshotIdentifier value must be supplied. - If the source type is a DB cluster snapshot, a DBClusterSnapshotIdentifier value must be supplied. - If the source type is an RDS Proxy, a DBProxyName value must be supplied.
source_type (Optional[str]) – The type of source that is generating the events. For example, if you want to be notified of events generated by a DB instance, you set this parameter to db-instance . For RDS Proxy events, specify db-proxy . If this value isn’t specified, all events are returned. Valid Values: db-instance | db-cluster | db-parameter-group | db-security-group | db-snapshot | db-cluster-snapshot | db-proxy | zero-etl | custom-engine-version | blue-green-deployment
subscription_name (Optional[str]) – The name of the subscription. Constraints: The name must be less than 255 characters.
tags (Optional[Sequence[Union[CfnTag, Dict[str, Any]]]]) – An optional array of key-value pairs to apply to this subscription.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-eventsubscription.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_rds as rds

cfn_event_subscription_props = rds.CfnEventSubscriptionProps(
    sns_topic_arn="snsTopicArn",

    # the properties below are optional
    enabled=False,
    event_categories=["eventCategories"],
    source_ids=["sourceIds"],
    source_type="sourceType",
    subscription_name="subscriptionName",
    tags=[CfnTag(
        key="key",
        value="value"
    )]
)

Attributes

enabled

Specifies whether to activate the subscription.

If the event notification subscription isn’t activated, the subscription is created but not active.

Default:

true

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-eventsubscription.html#cfn-rds-eventsubscription-enabled

event_categories

A list of event categories for a particular source type ( SourceType ) that you want to subscribe to.

You can see a list of the categories for a given source type in the “Amazon RDS event categories and event messages” section of the *Amazon RDS User Guide* or the *Amazon Aurora User Guide* . You can also see this list by using the DescribeEventCategories operation.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-eventsubscription.html#cfn-rds-eventsubscription-eventcategories

sns_topic_arn

The Amazon Resource Name (ARN) of the SNS topic created for event notification.

SNS automatically creates the ARN when you create a topic and subscribe to it. .. epigraph:

RDS doesn't support FIFO (first in, first out) topics. For more information, see `Message ordering and deduplication (FIFO topics) <https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html>`_ in the *Amazon Simple Notification Service Developer Guide* .

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-eventsubscription.html#cfn-rds-eventsubscription-snstopicarn

source_ids

The list of identifiers of the event sources for which events are returned.

If not specified, then all sources are included in the response. An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens. It can’t end with a hyphen or contain two consecutive hyphens.

Constraints:

If SourceIds are supplied, SourceType must also be provided.
If the source type is a DB instance, a DBInstanceIdentifier value must be supplied.
If the source type is a DB cluster, a DBClusterIdentifier value must be supplied.
If the source type is a DB parameter group, a DBParameterGroupName value must be supplied.
If the source type is a DB security group, a DBSecurityGroupName value must be supplied.
If the source type is a DB snapshot, a DBSnapshotIdentifier value must be supplied.
If the source type is a DB cluster snapshot, a DBClusterSnapshotIdentifier value must be supplied.
If the source type is an RDS Proxy, a DBProxyName value must be supplied.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-eventsubscription.html#cfn-rds-eventsubscription-sourceids

source_type

The type of source that is generating the events.

For example, if you want to be notified of events generated by a DB instance, you set this parameter to db-instance . For RDS Proxy events, specify db-proxy . If this value isn’t specified, all events are returned.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-eventsubscription.html#cfn-rds-eventsubscription-sourcetype

subscription_name

The name of the subscription.

Constraints: The name must be less than 255 characters.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-eventsubscription.html#cfn-rds-eventsubscription-subscriptionname

tags

An optional array of key-value pairs to apply to this subscription.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-eventsubscription.html#cfn-rds-eventsubscription-tags