Class: Aws::SES::Types::SNSAction

Inherits:
Struct
  • Object
show all
Includes:
Aws::Structure
Defined in:
lib/aws-sdk-ses/types.rb

Overview

Note:

When making an API call, you may pass SNSAction data as a hash:

{
  topic_arn: "AmazonResourceName", # required
  encoding: "UTF-8", # accepts UTF-8, Base64
}

When included in a receipt rule, this action publishes a notification to Amazon Simple Notification Service (Amazon SNS). This action includes a complete copy of the email content in the Amazon SNS notifications. Amazon SNS notifications for all other actions simply provide information about the email. They do not include the email content itself.

If you own the Amazon SNS topic, you don’t need to do anything to give Amazon SES permission to publish emails to it. However, if you don’t own the Amazon SNS topic, you need to attach a policy to the topic to give Amazon SES permissions to access it. For information about giving permissions, see the [Amazon SES Developer Guide].

You can only publish emails that are 150 KB or less (including the header) to Amazon SNS. Larger emails will bounce. If you anticipate emails larger than 150 KB, use the S3 action instead.

For information about using a receipt rule to publish an Amazon SNS notification, see the [Amazon SES Developer Guide].

[1]: docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-permissions.html [2]: docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-action-sns.html

Instance Attribute Summary collapse

Instance Attribute Details

#encodingString

The encoding to use for the email within the Amazon SNS notification. UTF-8 is easier to use, but may not preserve all special characters when a message was encoded with a different encoding format. Base64 preserves all special characters. The default value is UTF-8.

Returns:

  • (String)


3713
3714
3715
3716
3717
# File 'lib/aws-sdk-ses/types.rb', line 3713

class SNSAction < Struct.new(
  :topic_arn,
  :encoding)
  include Aws::Structure
end

#topic_arnString

The Amazon Resource Name (ARN) of the Amazon SNS topic to notify. An example of an Amazon SNS topic ARN is ‘arn:aws:sns:us-west-2:123456789012:MyTopic`. For more information about Amazon SNS topics, see the [Amazon SNS Developer Guide].

[1]: docs.aws.amazon.com/sns/latest/dg/CreateTopic.html

Returns:

  • (String)


3713
3714
3715
3716
3717
# File 'lib/aws-sdk-ses/types.rb', line 3713

class SNSAction < Struct.new(
  :topic_arn,
  :encoding)
  include Aws::Structure
end