aws-sdk-sns 1.120.0 → 1.121.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63f5c4bcca42e996520618baf213d3a3f37a9ec3cebf73e2ff52f8ce6d0136e2
-  data.tar.gz: 5d28ff5cf8cac2f6367f6fac2af985c140ccce2abea8bbc90ba13a97af61c347
+  metadata.gz: dcc3f84cf75b5bcf5a5feced240bcb8c2ac8e8ff53faba126e9139cbe39ffc3e
+  data.tar.gz: c8fdde77bf7ca2644e68f157298ffc208b935c964ea0d5a8dd43718570285170
 SHA512:
-  metadata.gz: 946eb51e08e2b5bfc694f70cd547bc29189bf0acfde1cf526772a729d80a3ea777a2c07f5d4b860379fcd0637f1455c274d1827ccf91e1e287261209b5240b3d
-  data.tar.gz: 86eeed9e20ef3693ccac8a01f8ab96ab95b30a92eeee9cb027f0b8ec13e0122a668ca3613e2f8f5df99698809d24a90f6507808744753e9eab215c7b89c3f3ad
+  metadata.gz: e8f6f7c19978d2693d44fb244867ad26f7dc1fb0a6b2320d2a26deea9c781d6d4ba1a3af26a4b1f830c9e4fb2c141a205deb9071831162cda82a84c2b670214a
+  data.tar.gz: 1538bdf0980014f592eb0ce369ce2072ab46670e413968bb170f2cc4ea07dd36e0a1478616f71aa24bf157ccc3681b5bed753c15a8cd06faa086f8d032296587

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.121.0 (2026-09-17)
+------------------
+
+* Feature - SNS API reference documentation update
+
 1.120.0 (2026-09-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.120.0
+1.121.0

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

@@ -833,8 +833,20 @@ module Aws::SNS
     #   * `DeliveryPolicy` – The policy that defines how Amazon SNS retries
     #     failed deliveries to HTTP/S endpoints.
     #
-    #   * `DisplayName` – The display name to use for a topic with SMS
-    #     subscriptions.
+    #   * `DisplayName` – The display name to use for a topic with SMS,
+    #     `email`, and `email-json` subscriptions. For `email` and
+    #     `email-json` subscriptions, the display name is used as the sender
+    #     name for regular notification messages. Subscription confirmation
+    #     and unsubscribe confirmation emails always use "Amazon Web Services
+    #     Notifications" as the sender name.
+    #
+    #   * `MaximumMessageSize` – The maximum size, in bytes, of a message that
+    #     can be published to the topic. Valid values are `1024` to `1048576`
+    #     (1 MiB). The default is `262144` (256 KiB).
+    #
+    #     A topic with a `MaximumMessageSize` above 256 KiB must have 100 or
+    #     fewer subscriptions, and each subscription must be an Amazon SQS,
+    #     Amazon Data Firehose, or Lambda subscription.
     #
     #   * `Policy` – The policy that defines who can access your topic. By
     #     default, only the topic owner can publish or subscribe to the topic.
@@ -999,6 +1011,10 @@ module Aws::SNS
     #    </note>
     #
     # @option params [String] :data_protection_policy
+    #   Amazon SNS message data protection is no longer available to new
+    #   customers. For more information and guidance on alternatives, see
+    #   [Amazon SNS message data protection availability change][1].
+    #
     #   The body of the policy document you want to use for this topic.
     #
     #   You can only add one policy per topic.
@@ -1007,6 +1023,10 @@ module Aws::SNS
     #
     #   Length Constraints: Maximum length of 30,720.
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-message-data-protection-availability-change.html
+    #
     # @return [Types::CreateTopicResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateTopicResponse#topic_arn #topic_arn} => String
@@ -1162,9 +1182,17 @@ module Aws::SNS
       req.send_request(options)
     end
 
+    # Amazon SNS message data protection is no longer available to new
+    # customers. For more information and guidance on alternatives, see
+    # [Amazon SNS message data protection availability change][1].
+    #
     # Retrieves the specified inline `DataProtectionPolicy` document that is
     # stored in the specified Amazon SNS topic.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-message-data-protection-availability-change.html
+    #
     # @option params [required, String] :resource_arn
     #   The ARN of the topic whose `DataProtectionPolicy` you want to get.
     #
@@ -1908,8 +1936,18 @@ module Aws::SNS
     #
     #   Constraints:
     #
-    #   * With the exception of SMS, messages must be UTF-8 encoded strings
-    #     and at most 256 KB in size (262,144 bytes, not 262,144 characters).
+    #   * With the exception of SMS, messages must be UTF-8 encoded strings.
+    #     By default, a message can be at most 256 KiB in size (262,144 bytes,
+    #     not 262,144 characters).
+    #
+    #     When you publish to a topic, the maximum size is determined by the
+    #     topic's `MaximumMessageSize` attribute, which supports values up to
+    #     1 MiB (1,048,576 bytes). Amazon SNS validates the combined size of
+    #     the message body and message attributes against this value and
+    #     returns an `InvalidParameter` error if the limit is exceeded.
+    #
+    #     For more information, see [Large message payloads][1] in the *Amazon
+    #     SNS Developer Guide.*
     #
     #   * For SMS, each message can contain up to 140 characters. This
     #     character limit depends on the encoding schema. For example, an SMS
@@ -1951,6 +1989,10 @@ module Aws::SNS
     #   * Failure to parse or validate any key or value in the message will
     #     cause the `Publish` call to return an error (no partial delivery).
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html
+    #
     # @option params [String] :subject
     #   Optional parameter to be used as the "Subject" line when the message
     #   is delivered to email endpoints. This field will also be included, if
@@ -2099,9 +2141,16 @@ module Aws::SNS
     # successful and unsuccessful actions, you should check for batch errors
     # even when the call returns an HTTP status code of 200.
     #
-    # The maximum allowed individual message size and the maximum total
-    # payload size (the sum of the individual lengths of all of the batched
-    # messages) are both 256 KB (262,144 bytes).
+    # By default, the maximum allowed individual message size and the
+    # maximum total payload size (the sum of the individual lengths of all
+    # of the batched messages) are both 256 KiB (262,144 bytes). To publish
+    # larger batches, set the topic's `MaximumMessageSize` attribute, which
+    # supports values up to 1 MiB (1,048,576 bytes). The combined size of
+    # all messages in the batch, including each message's body and
+    # attributes, must not exceed the topic's `MaximumMessageSize`.
+    #
+    # For more information, see [Large message payloads][1] in the *Amazon
+    # SNS Developer Guide.*
     #
     # The `PublishBatch` API can send up to 10 messages at a time. If you
     # attempt to send more than 10 messages in one request, you will
@@ -2126,6 +2175,10 @@ module Aws::SNS
     # When a `messageId` is returned, the batch message is saved, and Amazon
     # SNS immediately delivers the message to subscribers.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html
+    #
     # @option params [required, String] :topic_arn
     #   The Amazon resource name (ARN) of the topic you want to batch publish
     #   to.
@@ -2182,9 +2235,17 @@ module Aws::SNS
       req.send_request(options)
     end
 
+    # Amazon SNS message data protection is no longer available to new
+    # customers. For more information and guidance on alternatives, see
+    # [Amazon SNS message data protection availability change][1].
+    #
     # Adds or updates an inline policy document that is stored in the
     # specified Amazon SNS topic.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-message-data-protection-availability-change.html
+    #
     # @option params [required, String] :resource_arn
     #   The ARN of the topic whose `DataProtectionPolicy` you want to add or
     #   update.
@@ -2631,8 +2692,26 @@ module Aws::SNS
     #   * `DeliveryPolicy` – The policy that defines how Amazon SNS retries
     #     failed deliveries to HTTP/S endpoints.
     #
-    #   * `DisplayName` – The display name to use for a topic with SMS
-    #     subscriptions.
+    #   * `DisplayName` – The display name to use for a topic with SMS,
+    #     `email`, and `email-json` subscriptions. For `email` and
+    #     `email-json` subscriptions, the display name is used as the sender
+    #     name for regular notification messages. Subscription confirmation
+    #     and unsubscribe confirmation emails always use "Amazon Web Services
+    #     Notifications" as the sender name.
+    #
+    #   * `MaximumMessageSize` – The maximum size, in bytes, of a message that
+    #     can be published to the topic. Valid values are `1024` to `1048576`
+    #     (1 MiB). The default is `262144` (256 KiB).
+    #
+    #     A topic with a `MaximumMessageSize` above 256 KiB must have 100 or
+    #     fewer subscriptions, and each subscription must be an Amazon SQS,
+    #     Amazon Data Firehose, or Lambda subscription.
+    #
+    #     You can increase or decrease this value at any time. If the topic
+    #     doesn't meet these requirements when you set a value above 256 KiB,
+    #     Amazon SNS returns an `InvalidParameter` error. For more
+    #     information, see [Large message payloads][1] in the *Amazon SNS
+    #     Developer Guide.*
     #
     #   * `Policy` – The policy that defines who can access your topic. By
     #     default, only the topic owner can publish or subscribe to the topic.
@@ -2703,7 +2782,7 @@ module Aws::SNS
     #     notification services.
     #
     #      For example, For more information, see [Using Amazon SNS Application
-    #     Attributes for Message Delivery Status][1].
+    #     Attributes for Message Delivery Status][2].
     #
     #      </note>
     #
@@ -2732,11 +2811,11 @@ module Aws::SNS
     #
     #    </note>
     #
-    #   The following attribute applies only to [server-side-encryption][2]:
+    #   The following attribute applies only to [server-side-encryption][3]:
     #
     #   * `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer
     #     master key (CMK) for Amazon SNS or a custom CMK. For more
-    #     information, see [Key Terms][3]. For more examples, see [KeyId][4]
+    #     information, see [Key Terms][4]. For more examples, see [KeyId][5]
     #     in the *Key Management Service API Reference*.
     #
     #   * `SignatureVersion` – The signature version corresponds to the
@@ -2745,7 +2824,7 @@ module Aws::SNS
     #     confirmation messages sent by Amazon SNS. By default,
     #     `SignatureVersion` is set to `1`.
     #
-    #   The following attribute applies only to [FIFO topics][5]:
+    #   The following attribute applies only to [FIFO topics][6]:
     #
     #   * `ArchivePolicy` – The policy that sets the retention period for
     #     messages stored in the message archive of an Amazon SNS FIFO topic.
@@ -2756,7 +2835,7 @@ module Aws::SNS
     #     * By default, `ContentBasedDeduplication` is set to `false`. If you
     #       create a FIFO topic and this attribute is `false`, you must
     #       specify a value for the `MessageDeduplicationId` parameter for the
-    #       [Publish][6] action.
+    #       [Publish][7] action.
     #
     #     * When you set `ContentBasedDeduplication` to `true`, Amazon SNS
     #       uses a SHA-256 hash to generate the `MessageDeduplicationId` using
@@ -2779,18 +2858,19 @@ module Aws::SNS
     #     * `MessageGroup` – The scope of deduplication is within each
     #       individual message group, which enables higher throughput per
     #       topic subject to regional quotas. For more information on quotas
-    #       or to request an increase, see [Amazon SNS service quotas][7] in
+    #       or to request an increase, see [Amazon SNS service quotas][8] in
     #       the Amazon Web Services General Reference.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html
-    #   [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
-    #   [3]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
-    #   [4]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
-    #   [5]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
-    #   [6]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
-    #   [7]: https://docs.aws.amazon.com/general/latest/gr/sns.html
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html
+    #   [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html
+    #   [3]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
+    #   [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
+    #   [5]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
+    #   [6]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
+    #   [7]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
+    #   [8]: https://docs.aws.amazon.com/general/latest/gr/sns.html
     #
     # @option params [String] :attribute_value
     #   The new value for the attribute.
@@ -3169,7 +3249,7 @@ module Aws::SNS
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-sns'
-      context[:gem_version] = '1.120.0'
+      context[:gem_version] = '1.121.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-sns/platform_endpoint.rb

@@ -153,8 +153,18 @@ module Aws::SNS
     #
     #   Constraints:
     #
-    #   * With the exception of SMS, messages must be UTF-8 encoded strings
-    #     and at most 256 KB in size (262,144 bytes, not 262,144 characters).
+    #   * With the exception of SMS, messages must be UTF-8 encoded strings.
+    #     By default, a message can be at most 256 KiB in size (262,144 bytes,
+    #     not 262,144 characters).
+    #
+    #     When you publish to a topic, the maximum size is determined by the
+    #     topic's `MaximumMessageSize` attribute, which supports values up to
+    #     1 MiB (1,048,576 bytes). Amazon SNS validates the combined size of
+    #     the message body and message attributes against this value and
+    #     returns an `InvalidParameter` error if the limit is exceeded.
+    #
+    #     For more information, see [Large message payloads][1] in the *Amazon
+    #     SNS Developer Guide.*
     #
     #   * For SMS, each message can contain up to 140 characters. This
     #     character limit depends on the encoding schema. For example, an SMS
@@ -195,6 +205,10 @@ module Aws::SNS
     #
     #   * Failure to parse or validate any key or value in the message will
     #     cause the `Publish` call to return an error (no partial delivery).
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html
     # @option options [String] :subject
     #   Optional parameter to be used as the "Subject" line when the message
     #   is delivered to email endpoints. This field will also be included, if

data/lib/aws-sdk-sns/resource.rb

@@ -105,8 +105,20 @@ module Aws::SNS
     #   * `DeliveryPolicy` – The policy that defines how Amazon SNS retries
     #     failed deliveries to HTTP/S endpoints.
     #
-    #   * `DisplayName` – The display name to use for a topic with SMS
-    #     subscriptions.
+    #   * `DisplayName` – The display name to use for a topic with SMS,
+    #     `email`, and `email-json` subscriptions. For `email` and
+    #     `email-json` subscriptions, the display name is used as the sender
+    #     name for regular notification messages. Subscription confirmation
+    #     and unsubscribe confirmation emails always use "Amazon Web Services
+    #     Notifications" as the sender name.
+    #
+    #   * `MaximumMessageSize` – The maximum size, in bytes, of a message that
+    #     can be published to the topic. Valid values are `1024` to `1048576`
+    #     (1 MiB). The default is `262144` (256 KiB).
+    #
+    #     A topic with a `MaximumMessageSize` above 256 KiB must have 100 or
+    #     fewer subscriptions, and each subscription must be an Amazon SQS,
+    #     Amazon Data Firehose, or Lambda subscription.
     #
     #   * `Policy` – The policy that defines who can access your topic. By
     #     default, only the topic owner can publish or subscribe to the topic.
@@ -269,6 +281,10 @@ module Aws::SNS
     #
     #    </note>
     # @option options [String] :data_protection_policy
+    #   Amazon SNS message data protection is no longer available to new
+    #   customers. For more information and guidance on alternatives, see
+    #   [Amazon SNS message data protection availability change][1].
+    #
     #   The body of the policy document you want to use for this topic.
     #
     #   You can only add one policy per topic.
@@ -276,6 +292,10 @@ module Aws::SNS
     #   The policy must be in JSON string format.
     #
     #   Length Constraints: Maximum length of 30,720.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-message-data-protection-availability-change.html
     # @return [Topic]
     def create_topic(options = {})
       resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do

data/lib/aws-sdk-sns/topic.rb

@@ -41,11 +41,19 @@ module Aws::SNS
     #   policy.
     #
     # * `DisplayName` – The human-readable name used in the `From` field for
-    #   notifications to `email` and `email-json` endpoints.
+    #   notifications to `email` and `email-json` endpoints. For
+    #   subscription confirmation and unsubscribe confirmation emails, the
+    #   sender name is always "Amazon Web Services Notifications"
+    #   regardless of this attribute.
     #
     # * `EffectiveDeliveryPolicy` – The JSON serialization of the effective
     #   delivery policy, taking system defaults into account.
     #
+    # * `MaximumMessageSize` – The maximum size, in bytes, of a message that
+    #   can be published to the topic. Amazon SNS returns this attribute
+    #   only if you explicitly set it. If Amazon SNS doesn't return it, the
+    #   topic uses the default of `262144` (256 KiB).
+    #
     # * `Owner` – The Amazon Web Services account ID of the topic's owner.
     #
     # * `Policy` – The JSON serialization of the topic's access control
@@ -281,8 +289,18 @@ module Aws::SNS
     #
     #   Constraints:
     #
-    #   * With the exception of SMS, messages must be UTF-8 encoded strings
-    #     and at most 256 KB in size (262,144 bytes, not 262,144 characters).
+    #   * With the exception of SMS, messages must be UTF-8 encoded strings.
+    #     By default, a message can be at most 256 KiB in size (262,144 bytes,
+    #     not 262,144 characters).
+    #
+    #     When you publish to a topic, the maximum size is determined by the
+    #     topic's `MaximumMessageSize` attribute, which supports values up to
+    #     1 MiB (1,048,576 bytes). Amazon SNS validates the combined size of
+    #     the message body and message attributes against this value and
+    #     returns an `InvalidParameter` error if the limit is exceeded.
+    #
+    #     For more information, see [Large message payloads][1] in the *Amazon
+    #     SNS Developer Guide.*
     #
     #   * For SMS, each message can contain up to 140 characters. This
     #     character limit depends on the encoding schema. For example, an SMS
@@ -323,6 +341,10 @@ module Aws::SNS
     #
     #   * Failure to parse or validate any key or value in the message will
     #     cause the `Publish` call to return an error (no partial delivery).
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html
     # @option options [String] :subject
     #   Optional parameter to be used as the "Subject" line when the message
     #   is delivered to email endpoints. This field will also be included, if
@@ -455,8 +477,26 @@ module Aws::SNS
     #   * `DeliveryPolicy` – The policy that defines how Amazon SNS retries
     #     failed deliveries to HTTP/S endpoints.
     #
-    #   * `DisplayName` – The display name to use for a topic with SMS
-    #     subscriptions.
+    #   * `DisplayName` – The display name to use for a topic with SMS,
+    #     `email`, and `email-json` subscriptions. For `email` and
+    #     `email-json` subscriptions, the display name is used as the sender
+    #     name for regular notification messages. Subscription confirmation
+    #     and unsubscribe confirmation emails always use "Amazon Web Services
+    #     Notifications" as the sender name.
+    #
+    #   * `MaximumMessageSize` – The maximum size, in bytes, of a message that
+    #     can be published to the topic. Valid values are `1024` to `1048576`
+    #     (1 MiB). The default is `262144` (256 KiB).
+    #
+    #     A topic with a `MaximumMessageSize` above 256 KiB must have 100 or
+    #     fewer subscriptions, and each subscription must be an Amazon SQS,
+    #     Amazon Data Firehose, or Lambda subscription.
+    #
+    #     You can increase or decrease this value at any time. If the topic
+    #     doesn't meet these requirements when you set a value above 256 KiB,
+    #     Amazon SNS returns an `InvalidParameter` error. For more
+    #     information, see [Large message payloads][1] in the *Amazon SNS
+    #     Developer Guide.*
     #
     #   * `Policy` – The policy that defines who can access your topic. By
     #     default, only the topic owner can publish or subscribe to the topic.
@@ -527,7 +567,7 @@ module Aws::SNS
     #     notification services.
     #
     #      For example, For more information, see [Using Amazon SNS Application
-    #     Attributes for Message Delivery Status][1].
+    #     Attributes for Message Delivery Status][2].
     #
     #      </note>
     #
@@ -556,11 +596,11 @@ module Aws::SNS
     #
     #    </note>
     #
-    #   The following attribute applies only to [server-side-encryption][2]:
+    #   The following attribute applies only to [server-side-encryption][3]:
     #
     #   * `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer
     #     master key (CMK) for Amazon SNS or a custom CMK. For more
-    #     information, see [Key Terms][3]. For more examples, see [KeyId][4]
+    #     information, see [Key Terms][4]. For more examples, see [KeyId][5]
     #     in the *Key Management Service API Reference*.
     #
     #   * `SignatureVersion` – The signature version corresponds to the
@@ -569,7 +609,7 @@ module Aws::SNS
     #     confirmation messages sent by Amazon SNS. By default,
     #     `SignatureVersion` is set to `1`.
     #
-    #   The following attribute applies only to [FIFO topics][5]:
+    #   The following attribute applies only to [FIFO topics][6]:
     #
     #   * `ArchivePolicy` – The policy that sets the retention period for
     #     messages stored in the message archive of an Amazon SNS FIFO topic.
@@ -580,7 +620,7 @@ module Aws::SNS
     #     * By default, `ContentBasedDeduplication` is set to `false`. If you
     #       create a FIFO topic and this attribute is `false`, you must
     #       specify a value for the `MessageDeduplicationId` parameter for the
-    #       [Publish][6] action.
+    #       [Publish][7] action.
     #
     #     * When you set `ContentBasedDeduplication` to `true`, Amazon SNS
     #       uses a SHA-256 hash to generate the `MessageDeduplicationId` using
@@ -603,18 +643,19 @@ module Aws::SNS
     #     * `MessageGroup` – The scope of deduplication is within each
     #       individual message group, which enables higher throughput per
     #       topic subject to regional quotas. For more information on quotas
-    #       or to request an increase, see [Amazon SNS service quotas][7] in
+    #       or to request an increase, see [Amazon SNS service quotas][8] in
     #       the Amazon Web Services General Reference.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html
-    #   [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
-    #   [3]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
-    #   [4]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
-    #   [5]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
-    #   [6]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
-    #   [7]: https://docs.aws.amazon.com/general/latest/gr/sns.html
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html
+    #   [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html
+    #   [3]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
+    #   [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
+    #   [5]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
+    #   [6]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
+    #   [7]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
+    #   [8]: https://docs.aws.amazon.com/general/latest/gr/sns.html
     # @option options [String] :attribute_value
     #   The new value for the attribute.
     # @return [EmptyStructure]

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

@@ -351,8 +351,20 @@ module Aws::SNS
     #   * `DeliveryPolicy` – The policy that defines how Amazon SNS retries
     #     failed deliveries to HTTP/S endpoints.
     #
-    #   * `DisplayName` – The display name to use for a topic with SMS
-    #     subscriptions.
+    #   * `DisplayName` – The display name to use for a topic with SMS,
+    #     `email`, and `email-json` subscriptions. For `email` and
+    #     `email-json` subscriptions, the display name is used as the sender
+    #     name for regular notification messages. Subscription confirmation
+    #     and unsubscribe confirmation emails always use "Amazon Web
+    #     Services Notifications" as the sender name.
+    #
+    #   * `MaximumMessageSize` – The maximum size, in bytes, of a message
+    #     that can be published to the topic. Valid values are `1024` to
+    #     `1048576` (1 MiB). The default is `262144` (256 KiB).
+    #
+    #     A topic with a `MaximumMessageSize` above 256 KiB must have 100 or
+    #     fewer subscriptions, and each subscription must be an Amazon SQS,
+    #     Amazon Data Firehose, or Lambda subscription.
     #
     #   * `Policy` – The policy that defines who can access your topic. By
     #     default, only the topic owner can publish or subscribe to the
@@ -523,6 +535,10 @@ module Aws::SNS
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] data_protection_policy
+    #   Amazon SNS message data protection is no longer available to new
+    #   customers. For more information and guidance on alternatives, see
+    #   [Amazon SNS message data protection availability change][1].
+    #
     #   The body of the policy document you want to use for this topic.
     #
     #   You can only add one policy per topic.
@@ -530,6 +546,10 @@ module Aws::SNS
     #   The policy must be in JSON string format.
     #
     #   Length Constraints: Maximum length of 30,720.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-message-data-protection-availability-change.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/CreateTopicInput AWS API Documentation
@@ -983,11 +1003,19 @@ module Aws::SNS
     #     policy.
     #
     #   * `DisplayName` – The human-readable name used in the `From` field
-    #     for notifications to `email` and `email-json` endpoints.
+    #     for notifications to `email` and `email-json` endpoints. For
+    #     subscription confirmation and unsubscribe confirmation emails, the
+    #     sender name is always "Amazon Web Services Notifications"
+    #     regardless of this attribute.
     #
     #   * `EffectiveDeliveryPolicy` – The JSON serialization of the
     #     effective delivery policy, taking system defaults into account.
     #
+    #   * `MaximumMessageSize` – The maximum size, in bytes, of a message
+    #     that can be published to the topic. Amazon SNS returns this
+    #     attribute only if you explicitly set it. If Amazon SNS doesn't
+    #     return it, the topic uses the default of `262144` (256 KiB).
+    #
     #   * `Owner` – The Amazon Web Services account ID of the topic's
     #     owner.
     #
@@ -1595,15 +1623,18 @@ module Aws::SNS
     # Name, type, and value must not be empty or null. In addition, the
     # message body should not be empty or null. All parts of the message
     # attribute, including name, type, and value, are included in the
-    # message size restriction, which is currently 256 KB (262,144 bytes).
-    # For more information, see [Amazon SNS message attributes][2] and
-    # [Publishing to a mobile phone][3] in the *Amazon SNS Developer Guide.*
+    # message size restriction, which is 256 KiB (262,144 bytes) by default
+    # and is determined by the topic's `MaximumMessageSize` attribute. For
+    # more information, see [Large message payloads][2], [Amazon SNS message
+    # attributes][3] and [Publishing to a mobile phone][4] in the *Amazon
+    # SNS Developer Guide.*
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
-    # [2]: https://docs.aws.amazon.com/sns/latest/dg/SNSMessageAttributes.html
-    # [3]: https://docs.aws.amazon.com/sns/latest/dg/sms_publish-to-phone.html
+    # [2]: https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html
+    # [3]: https://docs.aws.amazon.com/sns/latest/dg/SNSMessageAttributes.html
+    # [4]: https://docs.aws.amazon.com/sns/latest/dg/sms_publish-to-phone.html
     #
     # @!attribute [rw] data_type
     #   Amazon SNS supports the following logical data types: String,
@@ -2017,9 +2048,18 @@ module Aws::SNS
     #
     #   Constraints:
     #
-    #   * With the exception of SMS, messages must be UTF-8 encoded strings
-    #     and at most 256 KB in size (262,144 bytes, not 262,144
-    #     characters).
+    #   * With the exception of SMS, messages must be UTF-8 encoded strings.
+    #     By default, a message can be at most 256 KiB in size (262,144
+    #     bytes, not 262,144 characters).
+    #
+    #     When you publish to a topic, the maximum size is determined by the
+    #     topic's `MaximumMessageSize` attribute, which supports values up
+    #     to 1 MiB (1,048,576 bytes). Amazon SNS validates the combined size
+    #     of the message body and message attributes against this value and
+    #     returns an `InvalidParameter` error if the limit is exceeded.
+    #
+    #     For more information, see [Large message payloads][1] in the
+    #     *Amazon SNS Developer Guide.*
     #
     #   * For SMS, each message can contain up to 140 characters. This
     #     character limit depends on the encoding schema. For example, an
@@ -2060,6 +2100,10 @@ module Aws::SNS
     #
     #   * Failure to parse or validate any key or value in the message will
     #     cause the `Publish` call to return an error (no partial delivery).
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html
     #   @return [String]
     #
     # @!attribute [rw] subject
@@ -2632,8 +2676,26 @@ module Aws::SNS
     #   * `DeliveryPolicy` – The policy that defines how Amazon SNS retries
     #     failed deliveries to HTTP/S endpoints.
     #
-    #   * `DisplayName` – The display name to use for a topic with SMS
-    #     subscriptions.
+    #   * `DisplayName` – The display name to use for a topic with SMS,
+    #     `email`, and `email-json` subscriptions. For `email` and
+    #     `email-json` subscriptions, the display name is used as the sender
+    #     name for regular notification messages. Subscription confirmation
+    #     and unsubscribe confirmation emails always use "Amazon Web
+    #     Services Notifications" as the sender name.
+    #
+    #   * `MaximumMessageSize` – The maximum size, in bytes, of a message
+    #     that can be published to the topic. Valid values are `1024` to
+    #     `1048576` (1 MiB). The default is `262144` (256 KiB).
+    #
+    #     A topic with a `MaximumMessageSize` above 256 KiB must have 100 or
+    #     fewer subscriptions, and each subscription must be an Amazon SQS,
+    #     Amazon Data Firehose, or Lambda subscription.
+    #
+    #     You can increase or decrease this value at any time. If the topic
+    #     doesn't meet these requirements when you set a value above 256
+    #     KiB, Amazon SNS returns an `InvalidParameter` error. For more
+    #     information, see [Large message payloads][1] in the *Amazon SNS
+    #     Developer Guide.*
     #
     #   * `Policy` – The policy that defines who can access your topic. By
     #     default, only the topic owner can publish or subscribe to the
@@ -2706,7 +2768,7 @@ module Aws::SNS
     #     sent to push notification services.
     #
     #      For example, For more information, see [Using Amazon SNS
-    #     Application Attributes for Message Delivery Status][1].
+    #     Application Attributes for Message Delivery Status][2].
     #
     #      </note>
     #
@@ -2735,11 +2797,11 @@ module Aws::SNS
     #
     #    </note>
     #
-    #   The following attribute applies only to [server-side-encryption][2]:
+    #   The following attribute applies only to [server-side-encryption][3]:
     #
     #   * `KmsMasterKeyId` – The ID of an Amazon Web Services managed
     #     customer master key (CMK) for Amazon SNS or a custom CMK. For more
-    #     information, see [Key Terms][3]. For more examples, see [KeyId][4]
+    #     information, see [Key Terms][4]. For more examples, see [KeyId][5]
     #     in the *Key Management Service API Reference*.
     #
     #   * `SignatureVersion` – The signature version corresponds to the
@@ -2748,7 +2810,7 @@ module Aws::SNS
     #     confirmation messages sent by Amazon SNS. By default,
     #     `SignatureVersion` is set to `1`.
     #
-    #   The following attribute applies only to [FIFO topics][5]:
+    #   The following attribute applies only to [FIFO topics][6]:
     #
     #   * `ArchivePolicy` – The policy that sets the retention period for
     #     messages stored in the message archive of an Amazon SNS FIFO
@@ -2760,7 +2822,7 @@ module Aws::SNS
     #     * By default, `ContentBasedDeduplication` is set to `false`. If
     #       you create a FIFO topic and this attribute is `false`, you must
     #       specify a value for the `MessageDeduplicationId` parameter for
-    #       the [Publish][6] action.
+    #       the [Publish][7] action.
     #
     #     * When you set `ContentBasedDeduplication` to `true`, Amazon SNS
     #       uses a SHA-256 hash to generate the `MessageDeduplicationId`
@@ -2784,18 +2846,19 @@ module Aws::SNS
     #     * `MessageGroup` – The scope of deduplication is within each
     #       individual message group, which enables higher throughput per
     #       topic subject to regional quotas. For more information on quotas
-    #       or to request an increase, see [Amazon SNS service quotas][7] in
+    #       or to request an increase, see [Amazon SNS service quotas][8] in
     #       the Amazon Web Services General Reference.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html
-    #   [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
-    #   [3]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
-    #   [4]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
-    #   [5]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
-    #   [6]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
-    #   [7]: https://docs.aws.amazon.com/general/latest/gr/sns.html
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html
+    #   [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html
+    #   [3]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
+    #   [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
+    #   [5]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
+    #   [6]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
+    #   [7]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
+    #   [8]: https://docs.aws.amazon.com/general/latest/gr/sns.html
     #   @return [String]
     #
     # @!attribute [rw] attribute_value

data/lib/aws-sdk-sns.rb

@@ -58,7 +58,7 @@ module Aws::SNS
   autoload :Subscription, 'aws-sdk-sns/subscription'
   autoload :Topic, 'aws-sdk-sns/topic'
 
-  GEM_VERSION = '1.120.0'
+  GEM_VERSION = '1.121.0'
 
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-sns
 version: !ruby/object:Gem::Version
-  version: 1.120.0
+  version: 1.121.0
 platform: ruby
 authors:
 - Amazon Web Services