Class: Aws::RDS::Types::CreateEventSubscriptionMessage

Inherits:

Struct

• Object
• Struct
• Aws::RDS::Types::CreateEventSubscriptionMessage

Includes:

Structure

Defined in:

lib/aws-sdk-rds/types.rb

Overview

See Also:

• AWS API Documentation

Constant Summary

SENSITIVE =

[]

Instance Attribute Summary

• #enabled ⇒ Boolean

  Specifies whether to activate the subscription.

• #event_categories ⇒ Array<String>

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

• #sns_topic_arn ⇒ String

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

• #source_ids ⇒ Array<String>

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

• #source_type ⇒ String

  The type of source that is generating the events.

• #subscription_name ⇒ String

  The name of the subscription.

• #tags ⇒ Array<Types::Tag>

  A list of tags.

Instance Attribute Details

#enabled ⇒ Boolean

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

Returns:

• (Boolean)

# File 'lib/aws-sdk-rds/types.rb', line 6115

class CreateEventSubscriptionMessage < Struct.new(
  :subscription_name,
  :sns_topic_arn,
  :source_type,
  :event_categories,
  :source_ids,
  :enabled,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#event_categories ⇒ Array<String>

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* ][1] or the [ *Amazon Aurora User Guide* ][2]. You can also see this list by using the `DescribeEventCategories` operation.

[1]: docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.Messages.html [2]: docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Events.Messages.html

Returns:

• (Array<String>)

# File 'lib/aws-sdk-rds/types.rb', line 6115

class CreateEventSubscriptionMessage < Struct.new(
  :subscription_name,
  :sns_topic_arn,
  :source_type,
  :event_categories,
  :source_ids,
  :enabled,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#sns_topic_arn ⇒ String

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.

<note markdown=“1”> 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*.

</note>

[1]: docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html

Returns:

• (String)

# File 'lib/aws-sdk-rds/types.rb', line 6115

class CreateEventSubscriptionMessage < Struct.new(
  :subscription_name,
  :sns_topic_arn,
  :source_type,
  :event_categories,
  :source_ids,
  :enabled,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#source_ids ⇒ Array<String>

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.

Returns:

• (Array<String>)

# File 'lib/aws-sdk-rds/types.rb', line 6115

class CreateEventSubscriptionMessage < Struct.new(
  :subscription_name,
  :sns_topic_arn,
  :source_type,
  :event_categories,
  :source_ids,
  :enabled,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#source_type ⇒ String

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 `

Returns:

• (String)

# File 'lib/aws-sdk-rds/types.rb', line 6115

class CreateEventSubscriptionMessage < Struct.new(
  :subscription_name,
  :sns_topic_arn,
  :source_type,
  :event_categories,
  :source_ids,
  :enabled,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#subscription_name ⇒ String

The name of the subscription.

Constraints: The name must be less than 255 characters.

Returns:

• (String)

# File 'lib/aws-sdk-rds/types.rb', line 6115

class CreateEventSubscriptionMessage < Struct.new(
  :subscription_name,
  :sns_topic_arn,
  :source_type,
  :event_categories,
  :source_ids,
  :enabled,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#tags ⇒ Array<Types::Tag>

A list of tags. For more information, see [Tagging Amazon RDS Resources] in the *Amazon RDS User Guide.*

[1]: docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html

Returns:

• (Array<Types::Tag>)

# File 'lib/aws-sdk-rds/types.rb', line 6115

class CreateEventSubscriptionMessage < Struct.new(
  :subscription_name,
  :sns_topic_arn,
  :source_type,
  :event_categories,
  :source_ids,
  :enabled,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end