CfnEventSubscriptionProps

class aws_cdk.aws_rds.CfnEventSubscriptionProps(*, sns_topic_arn, enabled=None, event_categories=None, source_ids=None, source_type=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. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

  • enabled (Union[bool, IResolvable, None]) – A Boolean value; set to true to activate the subscription, set to false to create the subscription but not active it.

  • event_categories (Optional[Sequence[str]]) – A list of event categories for a SourceType that you want to subscribe to. You can see a list of the categories for a given SourceType in the Events topic in the Amazon RDS User Guide or by using the DescribeEventCategories action.

  • 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 a SourceIds value is 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.

  • 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, set this parameter to db-instance . 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

Link

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.
import aws_cdk.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"
)

Attributes

enabled

A Boolean value;

set to true to activate the subscription, set to false to create the subscription but not active it.

Link

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

Return type

Union[bool, IResolvable, None]

event_categories

A list of event categories for a SourceType that you want to subscribe to.

You can see a list of the categories for a given SourceType in the Events topic in the Amazon RDS User Guide or by using the DescribeEventCategories action.

Link

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

Return type

Optional[List[str]]

sns_topic_arn

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

The ARN is created by Amazon SNS when you create a topic and subscribe to it.

Link

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

Return type

str

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 a SourceIds value is 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.

Link

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

Return type

Optional[List[str]]

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, set this parameter to db-instance . 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

Link

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

Return type

Optional[str]