@aws-sdk/client-sns 3.731.1 → 3.732.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -453,8 +453,8 @@ export interface CreateTopicInput {
453
453
  * <li>
454
454
  * <p>
455
455
  * <code>ArchivePolicy</code> – The policy that sets the retention period
456
- * for messages stored in the message archive of an Amazon SNS FIFO
457
- * topic.</p>
456
+ * for messages stored in the message archive of an Amazon SNS FIFO
457
+ * topic.</p>
458
458
  * </li>
459
459
  * <li>
460
460
  * <p>
@@ -463,19 +463,34 @@ export interface CreateTopicInput {
463
463
  * <ul>
464
464
  * <li>
465
465
  * <p>By default, <code>ContentBasedDeduplication</code> is set to
466
- * <code>false</code>. If you create a FIFO topic and this attribute is
467
- * <code>false</code>, you must specify a value for the
468
- * <code>MessageDeduplicationId</code> parameter for the <a href="https://docs.aws.amazon.com/sns/latest/api/API_Publish.html">Publish</a>
469
- * action. </p>
466
+ * <code>false</code>. If you create a FIFO topic and this attribute is
467
+ * <code>false</code>, you must specify a value for the
468
+ * <code>MessageDeduplicationId</code> parameter for the <a href="https://docs.aws.amazon.com/sns/latest/api/API_Publish.html">Publish</a> action. </p>
470
469
  * </li>
471
470
  * <li>
472
- * <p>When you set <code>ContentBasedDeduplication</code> to <code>true</code>,
473
- * Amazon SNS uses a SHA-256 hash to generate the
474
- * <code>MessageDeduplicationId</code> using the body of the message (but not
475
- * the attributes of the message).</p>
476
- * <p>(Optional) To override the generated value, you can specify a value for the
477
- * <code>MessageDeduplicationId</code> parameter for the <code>Publish</code>
478
- * action.</p>
471
+ * <p>When you set <code>ContentBasedDeduplication</code> to
472
+ * <code>true</code>, Amazon SNS uses a SHA-256 hash to
473
+ * generate the <code>MessageDeduplicationId</code> using the body of the
474
+ * message (but not the attributes of the message).</p>
475
+ * <p>(Optional) To override the generated value, you can specify a value
476
+ * for the <code>MessageDeduplicationId</code> parameter for the
477
+ * <code>Publish</code> action.</p>
478
+ * </li>
479
+ * </ul>
480
+ * </li>
481
+ * </ul>
482
+ * <ul>
483
+ * <li>
484
+ * <p>
485
+ * <code>FifoThroughputScope</code> – Enables higher throughput for your FIFO topic by adjusting the scope of deduplication. This attribute has two possible values:</p>
486
+ * <ul>
487
+ * <li>
488
+ * <p>
489
+ * <code>Topic</code> – The scope of message deduplication is across the entire topic. This is the default value and maintains existing behavior, with a maximum throughput of 3000 messages per second or 20MB per second, whichever comes first.</p>
490
+ * </li>
491
+ * <li>
492
+ * <p>
493
+ * <code>MessageGroup</code> – 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 <a href="https://docs.aws.amazon.com/general/latest/gr/sns.html">Amazon SNS service quotas</a> in the Amazon Web Services General Reference.</p>
479
494
  * </li>
480
495
  * </ul>
481
496
  * </li>
@@ -1862,18 +1877,69 @@ export interface PublishInput {
1862
1877
  */
1863
1878
  MessageAttributes?: Record<string, MessageAttributeValue> | undefined;
1864
1879
  /**
1865
- * <p>This parameter applies only to FIFO (first-in-first-out) topics. The
1866
- * <code>MessageDeduplicationId</code> can contain up to 128 alphanumeric characters
1867
- * <code>(a-z, A-Z, 0-9)</code> and punctuation
1868
- * <code>(!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~)</code>.</p>
1869
- * <p>Every message must have a unique <code>MessageDeduplicationId</code>, which is a token
1870
- * used for deduplication of sent messages. If a message with a particular
1871
- * <code>MessageDeduplicationId</code> is sent successfully, any message sent with the
1872
- * same <code>MessageDeduplicationId</code> during the 5-minute deduplication interval is
1873
- * treated as a duplicate. </p>
1874
- * <p>If the topic has <code>ContentBasedDeduplication</code> set, the system generates a
1875
- * <code>MessageDeduplicationId</code> based on the contents of the message. Your
1876
- * <code>MessageDeduplicationId</code> overrides the generated one.</p>
1880
+ * <ul>
1881
+ * <li>
1882
+ * <p>This parameter applies only to FIFO (first-in-first-out) topics. The
1883
+ * <code>MessageDeduplicationId</code> can contain up to 128 alphanumeric
1884
+ * characters <code>(a-z, A-Z, 0-9)</code> and punctuation
1885
+ * <code>(!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~)</code>.</p>
1886
+ * </li>
1887
+ * <li>
1888
+ * <p>Every message must have a unique <code>MessageDeduplicationId</code>, which is
1889
+ * a token used for deduplication of sent messages within the 5 minute minimum
1890
+ * deduplication interval.</p>
1891
+ * </li>
1892
+ * <li>
1893
+ * <p>The scope of deduplication depends on the <code>FifoThroughputScope</code>
1894
+ * attribute, when set to <code>Topic</code> the message deduplication scope is
1895
+ * across the entire topic, when set to <code>MessageGroup</code> the message
1896
+ * deduplication scope is within each individual message group.</p>
1897
+ * </li>
1898
+ * <li>
1899
+ * <p>If a message with a particular <code>MessageDeduplicationId</code> is sent
1900
+ * successfully, subsequent messages within the deduplication scope and interval,
1901
+ * with the same <code>MessageDeduplicationId</code>, are accepted successfully but
1902
+ * aren't delivered.</p>
1903
+ * </li>
1904
+ * <li>
1905
+ * <p>Every message must have a unique <code>MessageDeduplicationId</code>:</p>
1906
+ * <ul>
1907
+ * <li>
1908
+ * <p>You may provide a <code>MessageDeduplicationId</code>
1909
+ * explicitly.</p>
1910
+ * </li>
1911
+ * <li>
1912
+ * <p>If you aren't able to provide a <code>MessageDeduplicationId</code>
1913
+ * and you enable <code>ContentBasedDeduplication</code> for your topic,
1914
+ * Amazon SNS uses a SHA-256 hash to generate the
1915
+ * <code>MessageDeduplicationId</code> using the body of the message
1916
+ * (but not the attributes of the message).</p>
1917
+ * </li>
1918
+ * <li>
1919
+ * <p>If you don't provide a <code>MessageDeduplicationId</code> and the
1920
+ * topic doesn't have <code>ContentBasedDeduplication</code> set, the
1921
+ * action fails with an error.</p>
1922
+ * </li>
1923
+ * <li>
1924
+ * <p>If the topic has a <code>ContentBasedDeduplication</code> set, your
1925
+ * <code>MessageDeduplicationId</code> overrides the generated one.
1926
+ * </p>
1927
+ * </li>
1928
+ * </ul>
1929
+ * </li>
1930
+ * <li>
1931
+ * <p>When <code>ContentBasedDeduplication</code> is in effect, messages with
1932
+ * identical content sent within the deduplication scope and interval are treated
1933
+ * as duplicates and only one copy of the message is delivered.</p>
1934
+ * </li>
1935
+ * <li>
1936
+ * <p>If you send one message with <code>ContentBasedDeduplication</code> enabled,
1937
+ * and then another message with a <code>MessageDeduplicationId</code> that is the
1938
+ * same as the one generated for the first <code>MessageDeduplicationId</code>, the
1939
+ * two messages are treated as duplicates, within the deduplication scope and
1940
+ * interval, and only one copy of the message is delivered.</p>
1941
+ * </li>
1942
+ * </ul>
1877
1943
  * @public
1878
1944
  */
1879
1945
  MessageDeduplicationId?: string | undefined;
@@ -2014,12 +2080,31 @@ export interface PublishBatchRequestEntry {
2014
2080
  MessageAttributes?: Record<string, MessageAttributeValue> | undefined;
2015
2081
  /**
2016
2082
  * <p>This parameter applies only to FIFO (first-in-first-out) topics.</p>
2017
- * <p>The token used for deduplication of messages within a 5-minute minimum deduplication
2018
- * interval. If a message with a particular <code>MessageDeduplicationId</code> is sent
2019
- * successfully, subsequent messages with the same <code>MessageDeduplicationId</code> are
2020
- * accepted successfully but aren't delivered.</p>
2021
2083
  * <ul>
2022
2084
  * <li>
2085
+ * <p>This parameter applies only to FIFO (first-in-first-out) topics. The
2086
+ * <code>MessageDeduplicationId</code> can contain up to 128 alphanumeric
2087
+ * characters <code>(a-z, A-Z, 0-9)</code> and punctuation
2088
+ * <code>(!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~)</code>.</p>
2089
+ * </li>
2090
+ * <li>
2091
+ * <p>Every message must have a unique <code>MessageDeduplicationId</code>, which is
2092
+ * a token used for deduplication of sent messages within the 5 minute minimum
2093
+ * deduplication interval.</p>
2094
+ * </li>
2095
+ * <li>
2096
+ * <p>The scope of deduplication depends on the <code>FifoThroughputScope</code>
2097
+ * attribute, when set to <code>Topic</code> the message deduplication scope is
2098
+ * across the entire topic, when set to <code>MessageGroup</code> the message
2099
+ * deduplication scope is within each individual message group. </p>
2100
+ * </li>
2101
+ * <li>
2102
+ * <p>If a message with a particular <code>MessageDeduplicationId</code> is sent
2103
+ * successfully, subsequent messages within the deduplication scope and interval,
2104
+ * with the same <code>MessageDeduplicationId</code>, are accepted successfully but
2105
+ * aren't delivered.</p>
2106
+ * </li>
2107
+ * <li>
2023
2108
  * <p>Every message must have a unique <code>MessageDeduplicationId</code>.</p>
2024
2109
  * <ul>
2025
2110
  * <li>
@@ -2047,15 +2132,15 @@ export interface PublishBatchRequestEntry {
2047
2132
  * </li>
2048
2133
  * <li>
2049
2134
  * <p>When <code>ContentBasedDeduplication</code> is in effect, messages with
2050
- * identical content sent within the deduplication interval are treated as
2051
- * duplicates and only one copy of the message is delivered.</p>
2135
+ * identical content sent within the deduplication scope and interval are treated
2136
+ * as duplicates and only one copy of the message is delivered.</p>
2052
2137
  * </li>
2053
2138
  * <li>
2054
2139
  * <p>If you send one message with <code>ContentBasedDeduplication</code> enabled,
2055
2140
  * and then another message with a <code>MessageDeduplicationId</code> that is the
2056
2141
  * same as the one generated for the first <code>MessageDeduplicationId</code>, the
2057
- * two messages are treated as duplicates and only one copy of the message is
2058
- * delivered. </p>
2142
+ * two messages are treated as duplicates, within the deduplication scope and
2143
+ * interval, and only one copy of the message is delivered. </p>
2059
2144
  * </li>
2060
2145
  * </ul>
2061
2146
  * <note>
@@ -2067,11 +2152,6 @@ export interface PublishBatchRequestEntry {
2067
2152
  * <p>Amazon SNS continues to keep track of the message deduplication ID even after the
2068
2153
  * message is received and deleted. </p>
2069
2154
  * </note>
2070
- * <p>The length of <code>MessageDeduplicationId</code> is 128 characters.</p>
2071
- * <p>
2072
- * <code>MessageDeduplicationId</code> can contain alphanumeric characters <code>(a-z,
2073
- * A-Z, 0-9)</code> and punctuation
2074
- * <code>(!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~)</code>.</p>
2075
2155
  * @public
2076
2156
  */
2077
2157
  MessageDeduplicationId?: string | undefined;
@@ -2783,8 +2863,8 @@ export interface SetTopicAttributesInput {
2783
2863
  * <li>
2784
2864
  * <p>
2785
2865
  * <code>ArchivePolicy</code> – The policy that sets the retention period
2786
- * for messages stored in the message archive of an Amazon SNS FIFO
2787
- * topic.</p>
2866
+ * for messages stored in the message archive of an Amazon SNS FIFO
2867
+ * topic.</p>
2788
2868
  * </li>
2789
2869
  * <li>
2790
2870
  * <p>
@@ -2793,19 +2873,34 @@ export interface SetTopicAttributesInput {
2793
2873
  * <ul>
2794
2874
  * <li>
2795
2875
  * <p>By default, <code>ContentBasedDeduplication</code> is set to
2796
- * <code>false</code>. If you create a FIFO topic and this attribute is
2797
- * <code>false</code>, you must specify a value for the
2798
- * <code>MessageDeduplicationId</code> parameter for the <a href="https://docs.aws.amazon.com/sns/latest/api/API_Publish.html">Publish</a>
2799
- * action. </p>
2876
+ * <code>false</code>. If you create a FIFO topic and this attribute is
2877
+ * <code>false</code>, you must specify a value for the
2878
+ * <code>MessageDeduplicationId</code> parameter for the <a href="https://docs.aws.amazon.com/sns/latest/api/API_Publish.html">Publish</a> action. </p>
2879
+ * </li>
2880
+ * <li>
2881
+ * <p>When you set <code>ContentBasedDeduplication</code> to
2882
+ * <code>true</code>, Amazon SNS uses a SHA-256 hash to
2883
+ * generate the <code>MessageDeduplicationId</code> using the body of the
2884
+ * message (but not the attributes of the message).</p>
2885
+ * <p>(Optional) To override the generated value, you can specify a value
2886
+ * for the <code>MessageDeduplicationId</code> parameter for the
2887
+ * <code>Publish</code> action.</p>
2888
+ * </li>
2889
+ * </ul>
2890
+ * </li>
2891
+ * </ul>
2892
+ * <ul>
2893
+ * <li>
2894
+ * <p>
2895
+ * <code>FifoThroughputScope</code> – Enables higher throughput for your FIFO topic by adjusting the scope of deduplication. This attribute has two possible values:</p>
2896
+ * <ul>
2897
+ * <li>
2898
+ * <p>
2899
+ * <code>Topic</code> – The scope of message deduplication is across the entire topic. This is the default value and maintains existing behavior, with a maximum throughput of 3000 messages per second or 20MB per second, whichever comes first.</p>
2800
2900
  * </li>
2801
2901
  * <li>
2802
- * <p>When you set <code>ContentBasedDeduplication</code> to <code>true</code>,
2803
- * Amazon SNS uses a SHA-256 hash to generate the
2804
- * <code>MessageDeduplicationId</code> using the body of the message (but not
2805
- * the attributes of the message).</p>
2806
- * <p>(Optional) To override the generated value, you can specify a value for the
2807
- * <code>MessageDeduplicationId</code> parameter for the <code>Publish</code>
2808
- * action.</p>
2902
+ * <p>
2903
+ * <code>MessageGroup</code> – 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 <a href="https://docs.aws.amazon.com/general/latest/gr/sns.html">Amazon SNS service quotas</a> in the Amazon Web Services General Reference.</p>
2809
2904
  * </li>
2810
2905
  * </ul>
2811
2906
  * </li>
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-sns",
3
3
  "description": "AWS SDK for JavaScript Sns Client for Node.js, Browser and React Native",
4
- "version": "3.731.1",
4
+ "version": "3.732.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-sns",