@aws-sdk/client-sns 3.1133.0 → 3.1135.0

package/dist-cjs/index.js

@@ -69,7 +69,7 @@ const commonParams = {
     UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
 };
 
-var version = "3.1132.0";
+var version = "3.1134.0";
 var packageInfo = {
 	version: version};
 

package/dist-types/commands/GetDataProtectionPolicyCommand.d.ts

@@ -24,7 +24,12 @@ declare const GetDataProtectionPolicyCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
 };
 /**
- * <p>Retrieves the specified inline <code>DataProtectionPolicy</code> document that is
+ * <important>
+ *             <p>Amazon SNS message data protection is no longer available to new customers.
+ *   For more information and guidance on alternatives, see
+ * <a href="https://docs.aws.amazon.com/sns/latest/dg/sns-message-data-protection-availability-change.html">Amazon SNS message data protection availability change</a>.</p>
+ *          </important>
+ *          <p>Retrieves the specified inline <code>DataProtectionPolicy</code> document that is
  *             stored in the specified Amazon SNS topic. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/PublishBatchCommand.d.ts

@@ -35,9 +35,16 @@ declare const PublishBatchCommand_base: {
  *             Because the batch request can result in a combination of successful and unsuccessful
  *             actions, you should check for batch errors even when the call returns an HTTP status
  *             code of 200.</p>
- *          <p>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).</p>
+ *          <p>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
+ *                 <code>MaximumMessageSize</code> 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
+ *                 <code>MaximumMessageSize</code>.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html">Large message payloads</a> in
+ *             the <i>Amazon SNS Developer Guide.</i>
+ *          </p>
  *          <important>
  *             <p>The <code>PublishBatch</code> API can send up to 10 messages at a time. If you
  *                 attempt to send more than 10 messages in one request, you will encounter a

package/dist-types/commands/PutDataProtectionPolicyCommand.d.ts

@@ -24,7 +24,12 @@ declare const PutDataProtectionPolicyCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
 };
 /**
- * <p>Adds or updates an inline policy document that is stored in the specified Amazon SNS
+ * <important>
+ *             <p>Amazon SNS message data protection is no longer available to new customers.
+ *   For more information and guidance on alternatives, see
+ * <a href="https://docs.aws.amazon.com/sns/latest/dg/sns-message-data-protection-availability-change.html">Amazon SNS message data protection availability change</a>.</p>
+ *          </important>
+ *          <p>Adds or updates an inline policy document that is stored in the specified Amazon SNS
  *             topic.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/models/models_0.d.ts

@@ -245,8 +245,21 @@ export interface CreateTopicInput {
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>DisplayName</code> – The display name to use for a topic with SMS
-     *                     subscriptions.</p>
+     *                   <code>DisplayName</code> – The display name to use for a topic with SMS,
+     *                     <code>email</code>, and <code>email-json</code> subscriptions. For <code>email</code> and <code>email-json</code> 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.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>MaximumMessageSize</code> – The maximum
+     *                 size, in bytes, of a message that can be published to the topic. Valid values are
+     *                     <code>1024</code> to <code>1048576</code> (1 MiB). The default is
+     *                     <code>262144</code> (256 KiB).</p>
+     *                <p>A topic with a <code>MaximumMessageSize</code> above 256 KiB must have 100 or
+     *                 fewer subscriptions, and each subscription must be an Amazon SQS, Amazon Data Firehose, or Lambda
+     *                 subscription.</p>
      *             </li>
      *             <li>
      *                <p>
@@ -467,7 +480,12 @@ export interface CreateTopicInput {
      */
     Tags?: Tag[] | undefined;
     /**
-     * <p>The body of the policy document you want to use for this topic.</p>
+     * <important>
+     *             <p>Amazon SNS message data protection is no longer available to new customers.
+     *   For more information and guidance on alternatives, see
+     * <a href="https://docs.aws.amazon.com/sns/latest/dg/sns-message-data-protection-availability-change.html">Amazon SNS message data protection availability change</a>.</p>
+     *          </important>
+     *          <p>The body of the policy document you want to use for this topic.</p>
      *          <p>You can only add one policy per topic.</p>
      *          <p>The policy must be in JSON string format.</p>
      *          <p>Length Constraints: Maximum length of 30,720.</p>
@@ -864,7 +882,9 @@ export interface GetTopicAttributesResponse {
      *                <p>
      *                   <code>DisplayName</code> – The human-readable name used in the
      *                         <code>From</code> field for notifications to <code>email</code> and
-     *                         <code>email-json</code> endpoints.</p>
+     *                         <code>email-json</code> endpoints. For subscription confirmation and
+     *                         unsubscribe confirmation emails, the sender name is always
+     *                         "Amazon Web Services Notifications" regardless of this attribute.</p>
      *             </li>
      *             <li>
      *                <p>
@@ -873,6 +893,13 @@ export interface GetTopicAttributesResponse {
      *             </li>
      *             <li>
      *                <p>
+     *                   <code>MaximumMessageSize</code> – 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
+     *                         <code>262144</code> (256 KiB).</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <code>Owner</code> – The Amazon Web Services account ID of the topic's owner.</p>
      *             </li>
      *             <li>
@@ -1423,8 +1450,10 @@ export interface OptInPhoneNumberResponse {
  *                 <a href="https://docs.aws.amazon.com/sns/latest/api/API_Publish.html">Publish</a>.</p>
  *          <p>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 <a href="https://docs.aws.amazon.com/sns/latest/dg/SNSMessageAttributes.html">Amazon SNS message attributes</a> and
+ *             value, are included in the message size restriction, which is 256 KiB (262,144 bytes) by
+ *             default and is determined by the topic's <code>MaximumMessageSize</code> attribute. For
+ *             more information, see <a href="https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html">Large message payloads</a>,
+ *                 <a href="https://docs.aws.amazon.com/sns/latest/dg/SNSMessageAttributes.html">Amazon SNS message attributes</a> and
  *                 <a href="https://docs.aws.amazon.com/sns/latest/dg/sms_publish-to-phone.html">Publishing
  *                 to a mobile phone</a> in the <i>Amazon SNS Developer Guide.</i>
  *          </p>
@@ -1490,8 +1519,17 @@ export interface PublishInput {
      *          <p>Constraints:</p>
      *          <ul>
      *             <li>
-     *                <p>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).</p>
+     *                <p>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).</p>
+     *                <p>When you publish to a topic, the maximum size is determined by the topic's
+     *                         <code>MaximumMessageSize</code> 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
+     *                         <code>InvalidParameter</code> error if the limit is exceeded.</p>
+     *                <p>For more information, see <a href="https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html">Large message
+     *                         payloads</a> in the <i>Amazon SNS Developer Guide.</i>
+     *                </p>
      *             </li>
      *             <li>
      *                <p>For SMS, each message can contain up to 140 characters. This character limit
@@ -2334,8 +2372,27 @@ export interface SetTopicAttributesInput {
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>DisplayName</code> – The display name to use for a topic with SMS
-     *                     subscriptions.</p>
+     *                   <code>DisplayName</code> – The display name to use for a topic with SMS,
+     *                     <code>email</code>, and <code>email-json</code> subscriptions. For <code>email</code> and <code>email-json</code> 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.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>MaximumMessageSize</code> – The maximum
+     *                 size, in bytes, of a message that can be published to the topic. Valid values are
+     *                     <code>1024</code> to <code>1048576</code> (1 MiB). The default is
+     *                     <code>262144</code> (256 KiB).</p>
+     *                <p>A topic with a <code>MaximumMessageSize</code> above 256 KiB must have 100 or
+     *                 fewer subscriptions, and each subscription must be an Amazon SQS, Amazon Data Firehose, or Lambda
+     *                 subscription.</p>
+     *                <p>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
+     *                         <code>InvalidParameter</code> error. For more information, see <a href="https://docs.aws.amazon.com/sns/latest/dg/large-message-payloads.html">Large
+     *                         message payloads</a> in the <i>Amazon SNS Developer
+     *                     Guide.</i>
+     *                </p>
      *             </li>
      *             <li>
      *                <p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-sdk/client-sns",
-  "version": "3.1133.0",
+  "version": "3.1135.0",
   "description": "AWS SDK for JavaScript Sns Client for Node.js, Browser and React Native",
   "homepage": "https://github.com/aws/aws-sdk-js-v3/tree/main/clients/client-sns",
   "license": "Apache-2.0",