aws-sdk-mailmanager 1.23.0 → 1.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86c0ea7c9a97c17b79cec8fa8426ae7be7c6f09352577d63f0f0b8fc8b2f235b
-  data.tar.gz: f0a2c6b7cde7b923b43f39a9e374be6c291377a4f55f5fc72cf16d40674ee382
+  metadata.gz: 9aeb764542156ce410da78470791763fcd21729b5cb829d23190ada7baa1e37c
+  data.tar.gz: d705a58e28d3aa29cbd74a4144bbba6b764931bea78fd1ae08e122fe8cd39826
 SHA512:
-  metadata.gz: 4aa3b203aa2bf190912b15b9d0dd754ce428068dc6a93c4ba48e405575762f20067c1c7002f34c7ab297f3c90a172a6b4f0562445934965e19f3ece0604a8ad7
-  data.tar.gz: 94655f3fa769574a69bce3f8e1b02a3bb89a7ef50b1296ff48881827acd0e8bfe0f657879d861324527ed7b99d071b42789b4df76de1b040b8fa4945ab03a273
+  metadata.gz: db51290d53ca44a6299c9f9fae881f754b446e6f1d9edfac076c5a5d01bf8e55731f4834f359339dfbac361bbc4e3d38a8dea21dab680f45da2120525544fbc4
+  data.tar.gz: 2a2d1417448a6138acad0e853d6373ea8b71a64b5acf97fff6a12cce362b8141c26087273fb20273372d147de44badc5264267a7ba661cc507caf83fdc7df7b2

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.24.0 (2025-04-30)
+------------------
+
+* Feature - Introducing new RuleSet rule PublishToSns action, which allows customers to publish email notifications to an Amazon SNS topic. New PublishToSns action enables customers to easily integrate their email workflows via Amazon SNS, allowing them to notify other systems about important email events.
+
 1.23.0 (2025-04-03)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.23.0
+1.24.0

data/lib/aws-sdk-mailmanager/client.rb

@@ -932,6 +932,13 @@ module Aws::MailManager
     #             },
     #             drop: {
     #             },
+    #             publish_to_sns: {
+    #               action_failure_policy: "CONTINUE", # accepts CONTINUE, DROP
+    #               encoding: "UTF-8", # accepts UTF-8, BASE64
+    #               payload_type: "HEADERS", # accepts HEADERS, CONTENT
+    #               role_arn: "IamRoleArn", # required
+    #               topic_arn: "SnsTopicArn", # required
+    #             },
     #             relay: {
     #               action_failure_policy: "CONTINUE", # accepts CONTINUE, DROP
     #               mail_from: "REPLACE", # accepts REPLACE, PRESERVE
@@ -2026,6 +2033,11 @@ module Aws::MailManager
     #   resp.rules[0].actions[0].deliver_to_q_business.application_id #=> String
     #   resp.rules[0].actions[0].deliver_to_q_business.index_id #=> String
     #   resp.rules[0].actions[0].deliver_to_q_business.role_arn #=> String
+    #   resp.rules[0].actions[0].publish_to_sns.action_failure_policy #=> String, one of "CONTINUE", "DROP"
+    #   resp.rules[0].actions[0].publish_to_sns.encoding #=> String, one of "UTF-8", "BASE64"
+    #   resp.rules[0].actions[0].publish_to_sns.payload_type #=> String, one of "HEADERS", "CONTENT"
+    #   resp.rules[0].actions[0].publish_to_sns.role_arn #=> String
+    #   resp.rules[0].actions[0].publish_to_sns.topic_arn #=> String
     #   resp.rules[0].actions[0].relay.action_failure_policy #=> String, one of "CONTINUE", "DROP"
     #   resp.rules[0].actions[0].relay.mail_from #=> String, one of "REPLACE", "PRESERVE"
     #   resp.rules[0].actions[0].relay.relay #=> String
@@ -3266,6 +3278,13 @@ module Aws::MailManager
     #             },
     #             drop: {
     #             },
+    #             publish_to_sns: {
+    #               action_failure_policy: "CONTINUE", # accepts CONTINUE, DROP
+    #               encoding: "UTF-8", # accepts UTF-8, BASE64
+    #               payload_type: "HEADERS", # accepts HEADERS, CONTENT
+    #               role_arn: "IamRoleArn", # required
+    #               topic_arn: "SnsTopicArn", # required
+    #             },
     #             relay: {
     #               action_failure_policy: "CONTINUE", # accepts CONTINUE, DROP
     #               mail_from: "REPLACE", # accepts REPLACE, PRESERVE
@@ -3531,7 +3550,7 @@ module Aws::MailManager
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-mailmanager'
-      context[:gem_version] = '1.23.0'
+      context[:gem_version] = '1.24.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-mailmanager/client_api.rb

@@ -325,6 +325,10 @@ module Aws::MailManager
     SenderIpAddress = Shapes::StringShape.new(name: 'SenderIpAddress')
     ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
     SmtpPassword = Shapes::StringShape.new(name: 'SmtpPassword')
+    SnsAction = Shapes::StructureShape.new(name: 'SnsAction')
+    SnsNotificationEncoding = Shapes::StringShape.new(name: 'SnsNotificationEncoding')
+    SnsNotificationPayloadType = Shapes::StringShape.new(name: 'SnsNotificationPayloadType')
+    SnsTopicArn = Shapes::StringShape.new(name: 'SnsTopicArn')
     StartAddressListImportJobRequest = Shapes::StructureShape.new(name: 'StartAddressListImportJobRequest')
     StartAddressListImportJobResponse = Shapes::StructureShape.new(name: 'StartAddressListImportJobResponse')
     StartArchiveExportRequest = Shapes::StructureShape.new(name: 'StartArchiveExportRequest')
@@ -1151,6 +1155,7 @@ module Aws::MailManager
     RuleAction.add_member(:deliver_to_mailbox, Shapes::ShapeRef.new(shape: DeliverToMailboxAction, location_name: "DeliverToMailbox"))
     RuleAction.add_member(:deliver_to_q_business, Shapes::ShapeRef.new(shape: DeliverToQBusinessAction, location_name: "DeliverToQBusiness"))
     RuleAction.add_member(:drop, Shapes::ShapeRef.new(shape: DropAction, location_name: "Drop"))
+    RuleAction.add_member(:publish_to_sns, Shapes::ShapeRef.new(shape: SnsAction, location_name: "PublishToSns"))
     RuleAction.add_member(:relay, Shapes::ShapeRef.new(shape: RelayAction, location_name: "Relay"))
     RuleAction.add_member(:replace_recipient, Shapes::ShapeRef.new(shape: ReplaceRecipientAction, location_name: "ReplaceRecipient"))
     RuleAction.add_member(:send, Shapes::ShapeRef.new(shape: SendAction, location_name: "Send"))
@@ -1161,6 +1166,7 @@ module Aws::MailManager
     RuleAction.add_member_subclass(:deliver_to_mailbox, Types::RuleAction::DeliverToMailbox)
     RuleAction.add_member_subclass(:deliver_to_q_business, Types::RuleAction::DeliverToQBusiness)
     RuleAction.add_member_subclass(:drop, Types::RuleAction::Drop)
+    RuleAction.add_member_subclass(:publish_to_sns, Types::RuleAction::PublishToSns)
     RuleAction.add_member_subclass(:relay, Types::RuleAction::Relay)
     RuleAction.add_member_subclass(:replace_recipient, Types::RuleAction::ReplaceRecipient)
     RuleAction.add_member_subclass(:send, Types::RuleAction::Send)
@@ -1314,6 +1320,13 @@ module Aws::MailManager
     ServiceQuotaExceededException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
     ServiceQuotaExceededException.struct_class = Types::ServiceQuotaExceededException
 
+    SnsAction.add_member(:action_failure_policy, Shapes::ShapeRef.new(shape: ActionFailurePolicy, location_name: "ActionFailurePolicy"))
+    SnsAction.add_member(:encoding, Shapes::ShapeRef.new(shape: SnsNotificationEncoding, location_name: "Encoding"))
+    SnsAction.add_member(:payload_type, Shapes::ShapeRef.new(shape: SnsNotificationPayloadType, location_name: "PayloadType"))
+    SnsAction.add_member(:role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, required: true, location_name: "RoleArn"))
+    SnsAction.add_member(:topic_arn, Shapes::ShapeRef.new(shape: SnsTopicArn, required: true, location_name: "TopicArn"))
+    SnsAction.struct_class = Types::SnsAction
+
     StartAddressListImportJobRequest.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, required: true, location_name: "JobId"))
     StartAddressListImportJobRequest.struct_class = Types::StartAddressListImportJobRequest
 

data/lib/aws-sdk-mailmanager/types.rb

@@ -1044,7 +1044,7 @@ module Aws::MailManager
     #   A policy that states what to do in the case of failure. The action
     #   will fail if there are configuration errors. For example, the
     #   specified application has been deleted or the role lacks necessary
-    #   permissions to call the qbusiness:BatchPutDocument API.
+    #   permissions to call the `qbusiness:BatchPutDocument` API.
     #   @return [String]
     #
     # @!attribute [rw] application_id
@@ -1061,7 +1061,8 @@ module Aws::MailManager
     # @!attribute [rw] role_arn
     #   The Amazon Resource Name (ARN) of the IAM Role to use while
     #   delivering to Amazon Q Business. This role must have access to the
-    #   qbusiness:BatchPutDocument API for the given application and index.
+    #   `qbusiness:BatchPutDocument` API for the given application and
+    #   index.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/mailmanager-2023-10-17/DeliverToQBusinessAction AWS API Documentation
@@ -3575,6 +3576,10 @@ module Aws::MailManager
     #   This action terminates the evaluation of rules in the rule set.
     #   @return [Types::DropAction]
     #
+    # @!attribute [rw] publish_to_sns
+    #   This action publishes the email content to an Amazon SNS topic.
+    #   @return [Types::SnsAction]
+    #
     # @!attribute [rw] relay
     #   This action relays the email to another SMTP server.
     #   @return [Types::RelayAction]
@@ -3600,6 +3605,7 @@ module Aws::MailManager
       :deliver_to_mailbox,
       :deliver_to_q_business,
       :drop,
+      :publish_to_sns,
       :relay,
       :replace_recipient,
       :send,
@@ -3614,6 +3620,7 @@ module Aws::MailManager
       class DeliverToMailbox < RuleAction; end
       class DeliverToQBusiness < RuleAction; end
       class Drop < RuleAction; end
+      class PublishToSns < RuleAction; end
       class Relay < RuleAction; end
       class ReplaceRecipient < RuleAction; end
       class Send < RuleAction; end
@@ -4191,6 +4198,55 @@ module Aws::MailManager
       include Aws::Structure
     end
 
+    # The action to publish the email content to an Amazon SNS topic. When
+    # executed, this action will send the email as a notification to the
+    # specified SNS topic.
+    #
+    # @!attribute [rw] action_failure_policy
+    #   A policy that states what to do in the case of failure. The action
+    #   will fail if there are configuration errors. For example, specified
+    #   SNS topic has been deleted or the role lacks necessary permissions
+    #   to call the `sns:Publish` API.
+    #   @return [String]
+    #
+    # @!attribute [rw] encoding
+    #   The encoding to use for the email within the Amazon SNS
+    #   notification. The default value is `UTF-8`. Use `BASE64` if you need
+    #   to preserve all special characters, especially when the original
+    #   message uses a different encoding format.
+    #   @return [String]
+    #
+    # @!attribute [rw] payload_type
+    #   The expected payload type within the Amazon SNS notification.
+    #   `CONTENT` attempts to publish the full email content with 20KB of
+    #   headers content. `HEADERS` extracts up to 100KB of header content to
+    #   include in the notification, email content will not be included to
+    #   the notification. The default value is `CONTENT`.
+    #   @return [String]
+    #
+    # @!attribute [rw] role_arn
+    #   The Amazon Resource Name (ARN) of the IAM Role to use while writing
+    #   to Amazon SNS. This role must have access to the `sns:Publish` API
+    #   for the given topic.
+    #   @return [String]
+    #
+    # @!attribute [rw] topic_arn
+    #   The Amazon Resource Name (ARN) of the Amazon SNS Topic to which
+    #   notification for the email received will be published.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/mailmanager-2023-10-17/SnsAction AWS API Documentation
+    #
+    class SnsAction < Struct.new(
+      :action_failure_policy,
+      :encoding,
+      :payload_type,
+      :role_arn,
+      :topic_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] job_id
     #   The identifier of the import job that needs to be started.
     #   @return [String]

data/lib/aws-sdk-mailmanager.rb

@@ -54,7 +54,7 @@ module Aws::MailManager
   autoload :EndpointProvider, 'aws-sdk-mailmanager/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-mailmanager/endpoints'
 
-  GEM_VERSION = '1.23.0'
+  GEM_VERSION = '1.24.0'
 
 end
 

data/sig/client.rbs

@@ -255,6 +255,13 @@ module Aws
                                      }?,
                                      drop: {
                                      }?,
+                                     publish_to_sns: {
+                                       action_failure_policy: ("CONTINUE" | "DROP")?,
+                                       encoding: ("UTF-8" | "BASE64")?,
+                                       payload_type: ("HEADERS" | "CONTENT")?,
+                                       role_arn: ::String,
+                                       topic_arn: ::String
+                                     }?,
                                      relay: {
                                        action_failure_policy: ("CONTINUE" | "DROP")?,
                                        mail_from: ("REPLACE" | "PRESERVE")?,
@@ -1197,6 +1204,13 @@ module Aws
                                      }?,
                                      drop: {
                                      }?,
+                                     publish_to_sns: {
+                                       action_failure_policy: ("CONTINUE" | "DROP")?,
+                                       encoding: ("UTF-8" | "BASE64")?,
+                                       payload_type: ("HEADERS" | "CONTENT")?,
+                                       role_arn: ::String,
+                                       topic_arn: ::String
+                                     }?,
                                      relay: {
                                        action_failure_policy: ("CONTINUE" | "DROP")?,
                                        mail_from: ("REPLACE" | "PRESERVE")?,

data/sig/types.rbs

@@ -1097,6 +1097,7 @@ module Aws::MailManager
       attr_accessor deliver_to_mailbox: Types::DeliverToMailboxAction
       attr_accessor deliver_to_q_business: Types::DeliverToQBusinessAction
       attr_accessor drop: Types::DropAction
+      attr_accessor publish_to_sns: Types::SnsAction
       attr_accessor relay: Types::RelayAction
       attr_accessor replace_recipient: Types::ReplaceRecipientAction
       attr_accessor send: Types::SendAction
@@ -1114,6 +1115,8 @@ module Aws::MailManager
       end
       class Drop < RuleAction
       end
+      class PublishToSns < RuleAction
+      end
       class Relay < RuleAction
       end
       class ReplaceRecipient < RuleAction
@@ -1320,6 +1323,15 @@ module Aws::MailManager
       SENSITIVE: []
     end
 
+    class SnsAction
+      attr_accessor action_failure_policy: ("CONTINUE" | "DROP")
+      attr_accessor encoding: ("UTF-8" | "BASE64")
+      attr_accessor payload_type: ("HEADERS" | "CONTENT")
+      attr_accessor role_arn: ::String
+      attr_accessor topic_arn: ::String
+      SENSITIVE: []
+    end
+
     class StartAddressListImportJobRequest
       attr_accessor job_id: ::String
       SENSITIVE: []

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-mailmanager
 version: !ruby/object:Gem::Version
-  version: 1.23.0
+  version: 1.24.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-03 00:00:00.000000000 Z
+date: 2025-04-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core