aws-sdk-sns 1.93.0 → 1.95.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 1ced88b2411812a2266c0780ffe31a28418fce51fb1058e9c5e720924af6488b
4
- data.tar.gz: c3feb8458a2afd48a36ea13366320efa495f138f3c86226c5d10028d5e8e3f8d
3
+ metadata.gz: 60acde1e78da1233b5bc1498b8a151ba7fb34c6c3a565f4f70eaa7de1c5325fe
4
+ data.tar.gz: 3481d65f9bf0c20aa9239caa06edeaa4fb23c727611dd21bf55d32cdb287bdbc
5
5
  SHA512:
6
- metadata.gz: 60e3d00cdd0252c357d892c1f88758da38ae731c13d8c0c7d25dceb8eceaa65c81f2c67d30f1e36c13dbaff6a72d3f162550a264b363730c1c138c1a35effca3
7
- data.tar.gz: 48605ac571656d1bfcf4b17b97fa8b1f1141a13dade8218c42c5084b5e3f4b031e7b9016e97b75c231dd7bcb9ac186cebe3988101c785133ee27ae71516045ab
6
+ metadata.gz: 4244077c06b499b29ae8dcad978b7e240468f8dcbd41a0b794a1312d1620161b3f73e661ad2b52b56e8c7415032d054f2c0805b416c661b4dcc3f0b42d71a388
7
+ data.tar.gz: 392abd55b594c7baf31330cf3d087e3d37d3303a8538c0866bcb4d2ccc8d17a3426462b22ce216daf0a50ff62c1a0ae2112d880fe70347420903c850b2c4cfbe
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.95.0 (2025-02-06)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.94.0 (2025-01-21)
10
+ ------------------
11
+
12
+ * Feature - This release adds support for the topic attribute FifoThroughputScope for SNS FIFO topics. For details, see the documentation history in the Amazon Simple Notification Service Developer Guide.
13
+
4
14
  1.93.0 (2025-01-15)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.93.0
1
+ 1.95.0
@@ -878,6 +878,22 @@ module Aws::SNS
878
878
  # (Optional) To override the generated value, you can specify a
879
879
  # value for the `MessageDeduplicationId` parameter for the `Publish`
880
880
  # action.
881
+ # ^
882
+ #
883
+ # * `FifoThroughputScope` – Enables higher throughput for your FIFO
884
+ # topic by adjusting the scope of deduplication. This attribute has
885
+ # two possible values:
886
+ #
887
+ # * `Topic` – The scope of message deduplication is across the entire
888
+ # topic. This is the default value and maintains existing behavior,
889
+ # with a maximum throughput of 3000 messages per second or 20MB per
890
+ # second, whichever comes first.
891
+ #
892
+ # * `MessageGroup` – The scope of deduplication is within each
893
+ # individual message group, which enables higher throughput per
894
+ # topic subject to regional quotas. For more information on quotas
895
+ # or to request an increase, see [Amazon SNS service quotas][6] in
896
+ # the Amazon Web Services General Reference.
881
897
  #
882
898
  #
883
899
  #
@@ -886,6 +902,7 @@ module Aws::SNS
886
902
  # [3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
887
903
  # [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
888
904
  # [5]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
905
+ # [6]: https://docs.aws.amazon.com/general/latest/gr/sns.html
889
906
  #
890
907
  # @option params [Array<Types::Tag>] :tags
891
908
  # The list of tags to add to a new topic.
@@ -1877,20 +1894,50 @@ module Aws::SNS
1877
1894
  # Message attributes for Publish action.
1878
1895
  #
1879
1896
  # @option params [String] :message_deduplication_id
1880
- # This parameter applies only to FIFO (first-in-first-out) topics. The
1881
- # `MessageDeduplicationId` can contain up to 128 alphanumeric characters
1882
- # `(a-z, A-Z, 0-9)` and punctuation ``
1883
- # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
1884
- #
1885
- # Every message must have a unique `MessageDeduplicationId`, which is a
1886
- # token used for deduplication of sent messages. If a message with a
1887
- # particular `MessageDeduplicationId` is sent successfully, any message
1888
- # sent with the same `MessageDeduplicationId` during the 5-minute
1889
- # deduplication interval is treated as a duplicate.
1890
- #
1891
- # If the topic has `ContentBasedDeduplication` set, the system generates
1892
- # a `MessageDeduplicationId` based on the contents of the message. Your
1893
- # `MessageDeduplicationId` overrides the generated one.
1897
+ # * This parameter applies only to FIFO (first-in-first-out) topics. The
1898
+ # `MessageDeduplicationId` can contain up to 128 alphanumeric
1899
+ # characters `(a-z, A-Z, 0-9)` and punctuation ``
1900
+ # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
1901
+ #
1902
+ # * Every message must have a unique `MessageDeduplicationId`, which is
1903
+ # a token used for deduplication of sent messages within the 5 minute
1904
+ # minimum deduplication interval.
1905
+ #
1906
+ # * The scope of deduplication depends on the `FifoThroughputScope`
1907
+ # attribute, when set to `Topic` the message deduplication scope is
1908
+ # across the entire topic, when set to `MessageGroup` the message
1909
+ # deduplication scope is within each individual message group.
1910
+ #
1911
+ # * If a message with a particular `MessageDeduplicationId` is sent
1912
+ # successfully, subsequent messages within the deduplication scope and
1913
+ # interval, with the same `MessageDeduplicationId`, are accepted
1914
+ # successfully but aren't delivered.
1915
+ #
1916
+ # * Every message must have a unique `MessageDeduplicationId`:
1917
+ #
1918
+ # * You may provide a `MessageDeduplicationId` explicitly.
1919
+ #
1920
+ # * If you aren't able to provide a `MessageDeduplicationId` and you
1921
+ # enable `ContentBasedDeduplication` for your topic, Amazon SNS uses
1922
+ # a SHA-256 hash to generate the `MessageDeduplicationId` using the
1923
+ # body of the message (but not the attributes of the message).
1924
+ #
1925
+ # * If you don't provide a `MessageDeduplicationId` and the topic
1926
+ # doesn't have `ContentBasedDeduplication` set, the action fails
1927
+ # with an error.
1928
+ #
1929
+ # * If the topic has a `ContentBasedDeduplication` set, your
1930
+ # `MessageDeduplicationId` overrides the generated one.
1931
+ # * When `ContentBasedDeduplication` is in effect, messages with
1932
+ # identical content sent within the deduplication scope and interval
1933
+ # are treated as duplicates and only one copy of the message is
1934
+ # delivered.
1935
+ #
1936
+ # * If you send one message with `ContentBasedDeduplication` enabled,
1937
+ # and then another message with a `MessageDeduplicationId` that is the
1938
+ # same as the one generated for the first `MessageDeduplicationId`,
1939
+ # the two messages are treated as duplicates, within the deduplication
1940
+ # scope and interval, and only one copy of the message is delivered.
1894
1941
  #
1895
1942
  # @option params [String] :message_group_id
1896
1943
  # This parameter applies only to FIFO (first-in-first-out) topics. The
@@ -2615,6 +2662,22 @@ module Aws::SNS
2615
2662
  # (Optional) To override the generated value, you can specify a
2616
2663
  # value for the `MessageDeduplicationId` parameter for the `Publish`
2617
2664
  # action.
2665
+ # ^
2666
+ #
2667
+ # * `FifoThroughputScope` – Enables higher throughput for your FIFO
2668
+ # topic by adjusting the scope of deduplication. This attribute has
2669
+ # two possible values:
2670
+ #
2671
+ # * `Topic` – The scope of message deduplication is across the entire
2672
+ # topic. This is the default value and maintains existing behavior,
2673
+ # with a maximum throughput of 3000 messages per second or 20MB per
2674
+ # second, whichever comes first.
2675
+ #
2676
+ # * `MessageGroup` – The scope of deduplication is within each
2677
+ # individual message group, which enables higher throughput per
2678
+ # topic subject to regional quotas. For more information on quotas
2679
+ # or to request an increase, see [Amazon SNS service quotas][7] in
2680
+ # the Amazon Web Services General Reference.
2618
2681
  #
2619
2682
  #
2620
2683
  #
@@ -2624,6 +2687,7 @@ module Aws::SNS
2624
2687
  # [4]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
2625
2688
  # [5]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
2626
2689
  # [6]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
2690
+ # [7]: https://docs.aws.amazon.com/general/latest/gr/sns.html
2627
2691
  #
2628
2692
  # @option params [String] :attribute_value
2629
2693
  # The new value for the attribute.
@@ -3008,7 +3072,7 @@ module Aws::SNS
3008
3072
  tracer: tracer
3009
3073
  )
3010
3074
  context[:gem_name] = 'aws-sdk-sns'
3011
- context[:gem_version] = '1.93.0'
3075
+ context[:gem_version] = '1.95.0'
3012
3076
  Seahorse::Client::Request.new(handlers, context)
3013
3077
  end
3014
3078
 
@@ -10,46 +10,42 @@
10
10
  module Aws::SNS
11
11
  class EndpointProvider
12
12
  def resolve_endpoint(parameters)
13
- region = parameters.region
14
- use_dual_stack = parameters.use_dual_stack
15
- use_fips = parameters.use_fips
16
- endpoint = parameters.endpoint
17
- if Aws::Endpoints::Matchers.set?(endpoint)
18
- if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
13
+ if Aws::Endpoints::Matchers.set?(parameters.endpoint)
14
+ if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_fips, true)
19
15
  raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
20
16
  end
21
- if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
17
+ if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_dual_stack, true)
22
18
  raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
23
19
  end
24
- return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
20
+ return Aws::Endpoints::Endpoint.new(url: parameters.endpoint, headers: {}, properties: {})
25
21
  end
26
- if Aws::Endpoints::Matchers.set?(region)
27
- if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
28
- if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
22
+ if Aws::Endpoints::Matchers.set?(parameters.region)
23
+ if (partition_result = Aws::Endpoints::Matchers.aws_partition(parameters.region))
24
+ if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(parameters.use_dual_stack, true)
29
25
  if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
30
- return Aws::Endpoints::Endpoint.new(url: "https://sns-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
26
+ return Aws::Endpoints::Endpoint.new(url: "https://sns-fips.#{parameters.region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
31
27
  end
32
28
  raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
33
29
  end
34
- if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
30
+ if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_fips, true)
35
31
  if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
36
- if Aws::Endpoints::Matchers.string_equals?(region, "us-gov-east-1")
32
+ if Aws::Endpoints::Matchers.string_equals?(parameters.region, "us-gov-east-1")
37
33
  return Aws::Endpoints::Endpoint.new(url: "https://sns.us-gov-east-1.amazonaws.com", headers: {}, properties: {})
38
34
  end
39
- if Aws::Endpoints::Matchers.string_equals?(region, "us-gov-west-1")
35
+ if Aws::Endpoints::Matchers.string_equals?(parameters.region, "us-gov-west-1")
40
36
  return Aws::Endpoints::Endpoint.new(url: "https://sns.us-gov-west-1.amazonaws.com", headers: {}, properties: {})
41
37
  end
42
- return Aws::Endpoints::Endpoint.new(url: "https://sns-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
38
+ return Aws::Endpoints::Endpoint.new(url: "https://sns-fips.#{parameters.region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
43
39
  end
44
40
  raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
45
41
  end
46
- if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
42
+ if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_dual_stack, true)
47
43
  if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
48
- return Aws::Endpoints::Endpoint.new(url: "https://sns.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
44
+ return Aws::Endpoints::Endpoint.new(url: "https://sns.#{parameters.region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
49
45
  end
50
46
  raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
51
47
  end
52
- return Aws::Endpoints::Endpoint.new(url: "https://sns.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
48
+ return Aws::Endpoints::Endpoint.new(url: "https://sns.#{parameters.region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
53
49
  end
54
50
  end
55
51
  raise ArgumentError, "Invalid Configuration: Missing Region"
@@ -221,20 +221,50 @@ module Aws::SNS
221
221
  # @option options [Hash<String,Types::MessageAttributeValue>] :message_attributes
222
222
  # Message attributes for Publish action.
223
223
  # @option options [String] :message_deduplication_id
224
- # This parameter applies only to FIFO (first-in-first-out) topics. The
225
- # `MessageDeduplicationId` can contain up to 128 alphanumeric characters
226
- # `(a-z, A-Z, 0-9)` and punctuation ``
227
- # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
228
- #
229
- # Every message must have a unique `MessageDeduplicationId`, which is a
230
- # token used for deduplication of sent messages. If a message with a
231
- # particular `MessageDeduplicationId` is sent successfully, any message
232
- # sent with the same `MessageDeduplicationId` during the 5-minute
233
- # deduplication interval is treated as a duplicate.
234
- #
235
- # If the topic has `ContentBasedDeduplication` set, the system generates
236
- # a `MessageDeduplicationId` based on the contents of the message. Your
237
- # `MessageDeduplicationId` overrides the generated one.
224
+ # * This parameter applies only to FIFO (first-in-first-out) topics. The
225
+ # `MessageDeduplicationId` can contain up to 128 alphanumeric
226
+ # characters `(a-z, A-Z, 0-9)` and punctuation ``
227
+ # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
228
+ #
229
+ # * Every message must have a unique `MessageDeduplicationId`, which is
230
+ # a token used for deduplication of sent messages within the 5 minute
231
+ # minimum deduplication interval.
232
+ #
233
+ # * The scope of deduplication depends on the `FifoThroughputScope`
234
+ # attribute, when set to `Topic` the message deduplication scope is
235
+ # across the entire topic, when set to `MessageGroup` the message
236
+ # deduplication scope is within each individual message group.
237
+ #
238
+ # * If a message with a particular `MessageDeduplicationId` is sent
239
+ # successfully, subsequent messages within the deduplication scope and
240
+ # interval, with the same `MessageDeduplicationId`, are accepted
241
+ # successfully but aren't delivered.
242
+ #
243
+ # * Every message must have a unique `MessageDeduplicationId`:
244
+ #
245
+ # * You may provide a `MessageDeduplicationId` explicitly.
246
+ #
247
+ # * If you aren't able to provide a `MessageDeduplicationId` and you
248
+ # enable `ContentBasedDeduplication` for your topic, Amazon SNS uses
249
+ # a SHA-256 hash to generate the `MessageDeduplicationId` using the
250
+ # body of the message (but not the attributes of the message).
251
+ #
252
+ # * If you don't provide a `MessageDeduplicationId` and the topic
253
+ # doesn't have `ContentBasedDeduplication` set, the action fails
254
+ # with an error.
255
+ #
256
+ # * If the topic has a `ContentBasedDeduplication` set, your
257
+ # `MessageDeduplicationId` overrides the generated one.
258
+ # * When `ContentBasedDeduplication` is in effect, messages with
259
+ # identical content sent within the deduplication scope and interval
260
+ # are treated as duplicates and only one copy of the message is
261
+ # delivered.
262
+ #
263
+ # * If you send one message with `ContentBasedDeduplication` enabled,
264
+ # and then another message with a `MessageDeduplicationId` that is the
265
+ # same as the one generated for the first `MessageDeduplicationId`,
266
+ # the two messages are treated as duplicates, within the deduplication
267
+ # scope and interval, and only one copy of the message is delivered.
238
268
  # @option options [String] :message_group_id
239
269
  # This parameter applies only to FIFO (first-in-first-out) topics. The
240
270
  # `MessageGroupId` can contain up to 128 alphanumeric characters `(a-z,
@@ -155,6 +155,22 @@ module Aws::SNS
155
155
  # (Optional) To override the generated value, you can specify a
156
156
  # value for the `MessageDeduplicationId` parameter for the `Publish`
157
157
  # action.
158
+ # ^
159
+ #
160
+ # * `FifoThroughputScope` – Enables higher throughput for your FIFO
161
+ # topic by adjusting the scope of deduplication. This attribute has
162
+ # two possible values:
163
+ #
164
+ # * `Topic` – The scope of message deduplication is across the entire
165
+ # topic. This is the default value and maintains existing behavior,
166
+ # with a maximum throughput of 3000 messages per second or 20MB per
167
+ # second, whichever comes first.
168
+ #
169
+ # * `MessageGroup` – The scope of deduplication is within each
170
+ # individual message group, which enables higher throughput per
171
+ # topic subject to regional quotas. For more information on quotas
172
+ # or to request an increase, see [Amazon SNS service quotas][6] in
173
+ # the Amazon Web Services General Reference.
158
174
  #
159
175
  #
160
176
  #
@@ -163,6 +179,7 @@ module Aws::SNS
163
179
  # [3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
164
180
  # [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
165
181
  # [5]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
182
+ # [6]: https://docs.aws.amazon.com/general/latest/gr/sns.html
166
183
  # @option options [Array<Types::Tag>] :tags
167
184
  # The list of tags to add to a new topic.
168
185
  #
@@ -349,20 +349,50 @@ module Aws::SNS
349
349
  # @option options [Hash<String,Types::MessageAttributeValue>] :message_attributes
350
350
  # Message attributes for Publish action.
351
351
  # @option options [String] :message_deduplication_id
352
- # This parameter applies only to FIFO (first-in-first-out) topics. The
353
- # `MessageDeduplicationId` can contain up to 128 alphanumeric characters
354
- # `(a-z, A-Z, 0-9)` and punctuation ``
355
- # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
356
- #
357
- # Every message must have a unique `MessageDeduplicationId`, which is a
358
- # token used for deduplication of sent messages. If a message with a
359
- # particular `MessageDeduplicationId` is sent successfully, any message
360
- # sent with the same `MessageDeduplicationId` during the 5-minute
361
- # deduplication interval is treated as a duplicate.
362
- #
363
- # If the topic has `ContentBasedDeduplication` set, the system generates
364
- # a `MessageDeduplicationId` based on the contents of the message. Your
365
- # `MessageDeduplicationId` overrides the generated one.
352
+ # * This parameter applies only to FIFO (first-in-first-out) topics. The
353
+ # `MessageDeduplicationId` can contain up to 128 alphanumeric
354
+ # characters `(a-z, A-Z, 0-9)` and punctuation ``
355
+ # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
356
+ #
357
+ # * Every message must have a unique `MessageDeduplicationId`, which is
358
+ # a token used for deduplication of sent messages within the 5 minute
359
+ # minimum deduplication interval.
360
+ #
361
+ # * The scope of deduplication depends on the `FifoThroughputScope`
362
+ # attribute, when set to `Topic` the message deduplication scope is
363
+ # across the entire topic, when set to `MessageGroup` the message
364
+ # deduplication scope is within each individual message group.
365
+ #
366
+ # * If a message with a particular `MessageDeduplicationId` is sent
367
+ # successfully, subsequent messages within the deduplication scope and
368
+ # interval, with the same `MessageDeduplicationId`, are accepted
369
+ # successfully but aren't delivered.
370
+ #
371
+ # * Every message must have a unique `MessageDeduplicationId`:
372
+ #
373
+ # * You may provide a `MessageDeduplicationId` explicitly.
374
+ #
375
+ # * If you aren't able to provide a `MessageDeduplicationId` and you
376
+ # enable `ContentBasedDeduplication` for your topic, Amazon SNS uses
377
+ # a SHA-256 hash to generate the `MessageDeduplicationId` using the
378
+ # body of the message (but not the attributes of the message).
379
+ #
380
+ # * If you don't provide a `MessageDeduplicationId` and the topic
381
+ # doesn't have `ContentBasedDeduplication` set, the action fails
382
+ # with an error.
383
+ #
384
+ # * If the topic has a `ContentBasedDeduplication` set, your
385
+ # `MessageDeduplicationId` overrides the generated one.
386
+ # * When `ContentBasedDeduplication` is in effect, messages with
387
+ # identical content sent within the deduplication scope and interval
388
+ # are treated as duplicates and only one copy of the message is
389
+ # delivered.
390
+ #
391
+ # * If you send one message with `ContentBasedDeduplication` enabled,
392
+ # and then another message with a `MessageDeduplicationId` that is the
393
+ # same as the one generated for the first `MessageDeduplicationId`,
394
+ # the two messages are treated as duplicates, within the deduplication
395
+ # scope and interval, and only one copy of the message is delivered.
366
396
  # @option options [String] :message_group_id
367
397
  # This parameter applies only to FIFO (first-in-first-out) topics. The
368
398
  # `MessageGroupId` can contain up to 128 alphanumeric characters `(a-z,
@@ -553,6 +583,22 @@ module Aws::SNS
553
583
  # (Optional) To override the generated value, you can specify a
554
584
  # value for the `MessageDeduplicationId` parameter for the `Publish`
555
585
  # action.
586
+ # ^
587
+ #
588
+ # * `FifoThroughputScope` – Enables higher throughput for your FIFO
589
+ # topic by adjusting the scope of deduplication. This attribute has
590
+ # two possible values:
591
+ #
592
+ # * `Topic` – The scope of message deduplication is across the entire
593
+ # topic. This is the default value and maintains existing behavior,
594
+ # with a maximum throughput of 3000 messages per second or 20MB per
595
+ # second, whichever comes first.
596
+ #
597
+ # * `MessageGroup` – The scope of deduplication is within each
598
+ # individual message group, which enables higher throughput per
599
+ # topic subject to regional quotas. For more information on quotas
600
+ # or to request an increase, see [Amazon SNS service quotas][7] in
601
+ # the Amazon Web Services General Reference.
556
602
  #
557
603
  #
558
604
  #
@@ -562,6 +608,7 @@ module Aws::SNS
562
608
  # [4]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
563
609
  # [5]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
564
610
  # [6]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
611
+ # [7]: https://docs.aws.amazon.com/general/latest/gr/sns.html
565
612
  # @option options [String] :attribute_value
566
613
  # The new value for the attribute.
567
614
  # @return [EmptyStructure]
@@ -405,6 +405,22 @@ module Aws::SNS
405
405
  # (Optional) To override the generated value, you can specify a
406
406
  # value for the `MessageDeduplicationId` parameter for the
407
407
  # `Publish` action.
408
+ # ^
409
+ #
410
+ # * `FifoThroughputScope` – Enables higher throughput for your FIFO
411
+ # topic by adjusting the scope of deduplication. This attribute has
412
+ # two possible values:
413
+ #
414
+ # * `Topic` – The scope of message deduplication is across the
415
+ # entire topic. This is the default value and maintains existing
416
+ # behavior, with a maximum throughput of 3000 messages per second
417
+ # or 20MB per second, whichever comes first.
418
+ #
419
+ # * `MessageGroup` – The scope of deduplication is within each
420
+ # individual message group, which enables higher throughput per
421
+ # topic subject to regional quotas. For more information on quotas
422
+ # or to request an increase, see [Amazon SNS service quotas][6] in
423
+ # the Amazon Web Services General Reference.
408
424
  #
409
425
  #
410
426
  #
@@ -413,6 +429,7 @@ module Aws::SNS
413
429
  # [3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
414
430
  # [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
415
431
  # [5]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
432
+ # [6]: https://docs.aws.amazon.com/general/latest/gr/sns.html
416
433
  # @return [Hash<String,String>]
417
434
  #
418
435
  # @!attribute [rw] tags
@@ -1733,11 +1750,24 @@ module Aws::SNS
1733
1750
  # @!attribute [rw] message_deduplication_id
1734
1751
  # This parameter applies only to FIFO (first-in-first-out) topics.
1735
1752
  #
1736
- # The token used for deduplication of messages within a 5-minute
1737
- # minimum deduplication interval. If a message with a particular
1738
- # `MessageDeduplicationId` is sent successfully, subsequent messages
1739
- # with the same `MessageDeduplicationId` are accepted successfully but
1740
- # aren't delivered.
1753
+ # * This parameter applies only to FIFO (first-in-first-out) topics.
1754
+ # The `MessageDeduplicationId` can contain up to 128 alphanumeric
1755
+ # characters `(a-z, A-Z, 0-9)` and punctuation ``
1756
+ # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
1757
+ #
1758
+ # * Every message must have a unique `MessageDeduplicationId`, which
1759
+ # is a token used for deduplication of sent messages within the 5
1760
+ # minute minimum deduplication interval.
1761
+ #
1762
+ # * The scope of deduplication depends on the `FifoThroughputScope`
1763
+ # attribute, when set to `Topic` the message deduplication scope is
1764
+ # across the entire topic, when set to `MessageGroup` the message
1765
+ # deduplication scope is within each individual message group.
1766
+ #
1767
+ # * If a message with a particular `MessageDeduplicationId` is sent
1768
+ # successfully, subsequent messages within the deduplication scope
1769
+ # and interval, with the same `MessageDeduplicationId`, are accepted
1770
+ # successfully but aren't delivered.
1741
1771
  #
1742
1772
  # * Every message must have a unique `MessageDeduplicationId`.
1743
1773
  #
@@ -1756,15 +1786,16 @@ module Aws::SNS
1756
1786
  # * If the topic has a `ContentBasedDeduplication` set, your
1757
1787
  # `MessageDeduplicationId` overrides the generated one.
1758
1788
  # * When `ContentBasedDeduplication` is in effect, messages with
1759
- # identical content sent within the deduplication interval are
1760
- # treated as duplicates and only one copy of the message is
1789
+ # identical content sent within the deduplication scope and interval
1790
+ # are treated as duplicates and only one copy of the message is
1761
1791
  # delivered.
1762
1792
  #
1763
1793
  # * If you send one message with `ContentBasedDeduplication` enabled,
1764
1794
  # and then another message with a `MessageDeduplicationId` that is
1765
1795
  # the same as the one generated for the first
1766
1796
  # `MessageDeduplicationId`, the two messages are treated as
1767
- # duplicates and only one copy of the message is delivered.
1797
+ # duplicates, within the deduplication scope and interval, and only
1798
+ # one copy of the message is delivered.
1768
1799
  #
1769
1800
  # <note markdown="1"> The `MessageDeduplicationId` is available to the consumer of the
1770
1801
  # message (this can be useful for troubleshooting delivery issues).
@@ -1778,11 +1809,6 @@ module Aws::SNS
1778
1809
  # even after the message is received and deleted.
1779
1810
  #
1780
1811
  # </note>
1781
- #
1782
- # The length of `MessageDeduplicationId` is 128 characters.
1783
- #
1784
- # `MessageDeduplicationId` can contain alphanumeric characters `(a-z,
1785
- # A-Z, 0-9)` and punctuation `` (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
1786
1812
  # @return [String]
1787
1813
  #
1788
1814
  # @!attribute [rw] message_group_id
@@ -1985,20 +2011,52 @@ module Aws::SNS
1985
2011
  # @return [Hash<String,Types::MessageAttributeValue>]
1986
2012
  #
1987
2013
  # @!attribute [rw] message_deduplication_id
1988
- # This parameter applies only to FIFO (first-in-first-out) topics. The
1989
- # `MessageDeduplicationId` can contain up to 128 alphanumeric
1990
- # characters `(a-z, A-Z, 0-9)` and punctuation ``
1991
- # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
2014
+ # * This parameter applies only to FIFO (first-in-first-out) topics.
2015
+ # The `MessageDeduplicationId` can contain up to 128 alphanumeric
2016
+ # characters `(a-z, A-Z, 0-9)` and punctuation ``
2017
+ # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
2018
+ #
2019
+ # * Every message must have a unique `MessageDeduplicationId`, which
2020
+ # is a token used for deduplication of sent messages within the 5
2021
+ # minute minimum deduplication interval.
2022
+ #
2023
+ # * The scope of deduplication depends on the `FifoThroughputScope`
2024
+ # attribute, when set to `Topic` the message deduplication scope is
2025
+ # across the entire topic, when set to `MessageGroup` the message
2026
+ # deduplication scope is within each individual message group.
2027
+ #
2028
+ # * If a message with a particular `MessageDeduplicationId` is sent
2029
+ # successfully, subsequent messages within the deduplication scope
2030
+ # and interval, with the same `MessageDeduplicationId`, are accepted
2031
+ # successfully but aren't delivered.
2032
+ #
2033
+ # * Every message must have a unique `MessageDeduplicationId`:
1992
2034
  #
1993
- # Every message must have a unique `MessageDeduplicationId`, which is
1994
- # a token used for deduplication of sent messages. If a message with a
1995
- # particular `MessageDeduplicationId` is sent successfully, any
1996
- # message sent with the same `MessageDeduplicationId` during the
1997
- # 5-minute deduplication interval is treated as a duplicate.
2035
+ # * You may provide a `MessageDeduplicationId` explicitly.
1998
2036
  #
1999
- # If the topic has `ContentBasedDeduplication` set, the system
2000
- # generates a `MessageDeduplicationId` based on the contents of the
2001
- # message. Your `MessageDeduplicationId` overrides the generated one.
2037
+ # * If you aren't able to provide a `MessageDeduplicationId` and
2038
+ # you enable `ContentBasedDeduplication` for your topic, Amazon
2039
+ # SNS uses a SHA-256 hash to generate the `MessageDeduplicationId`
2040
+ # using the body of the message (but not the attributes of the
2041
+ # message).
2042
+ #
2043
+ # * If you don't provide a `MessageDeduplicationId` and the topic
2044
+ # doesn't have `ContentBasedDeduplication` set, the action fails
2045
+ # with an error.
2046
+ #
2047
+ # * If the topic has a `ContentBasedDeduplication` set, your
2048
+ # `MessageDeduplicationId` overrides the generated one.
2049
+ # * When `ContentBasedDeduplication` is in effect, messages with
2050
+ # identical content sent within the deduplication scope and interval
2051
+ # are treated as duplicates and only one copy of the message is
2052
+ # delivered.
2053
+ #
2054
+ # * If you send one message with `ContentBasedDeduplication` enabled,
2055
+ # and then another message with a `MessageDeduplicationId` that is
2056
+ # the same as the one generated for the first
2057
+ # `MessageDeduplicationId`, the two messages are treated as
2058
+ # duplicates, within the deduplication scope and interval, and only
2059
+ # one copy of the message is delivered.
2002
2060
  # @return [String]
2003
2061
  #
2004
2062
  # @!attribute [rw] message_group_id
@@ -2623,6 +2681,22 @@ module Aws::SNS
2623
2681
  # (Optional) To override the generated value, you can specify a
2624
2682
  # value for the `MessageDeduplicationId` parameter for the
2625
2683
  # `Publish` action.
2684
+ # ^
2685
+ #
2686
+ # * `FifoThroughputScope` – Enables higher throughput for your FIFO
2687
+ # topic by adjusting the scope of deduplication. This attribute has
2688
+ # two possible values:
2689
+ #
2690
+ # * `Topic` – The scope of message deduplication is across the
2691
+ # entire topic. This is the default value and maintains existing
2692
+ # behavior, with a maximum throughput of 3000 messages per second
2693
+ # or 20MB per second, whichever comes first.
2694
+ #
2695
+ # * `MessageGroup` – The scope of deduplication is within each
2696
+ # individual message group, which enables higher throughput per
2697
+ # topic subject to regional quotas. For more information on quotas
2698
+ # or to request an increase, see [Amazon SNS service quotas][7] in
2699
+ # the Amazon Web Services General Reference.
2626
2700
  #
2627
2701
  #
2628
2702
  #
@@ -2632,6 +2706,7 @@ module Aws::SNS
2632
2706
  # [4]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
2633
2707
  # [5]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
2634
2708
  # [6]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
2709
+ # [7]: https://docs.aws.amazon.com/general/latest/gr/sns.html
2635
2710
  # @return [String]
2636
2711
  #
2637
2712
  # @!attribute [rw] attribute_value
data/lib/aws-sdk-sns.rb CHANGED
@@ -58,7 +58,7 @@ module Aws::SNS
58
58
  autoload :Subscription, 'aws-sdk-sns/subscription'
59
59
  autoload :Topic, 'aws-sdk-sns/topic'
60
60
 
61
- GEM_VERSION = '1.93.0'
61
+ GEM_VERSION = '1.95.0'
62
62
 
63
63
  end
64
64
 
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-sns
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.93.0
4
+ version: 1.95.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2025-01-15 00:00:00.000000000 Z
11
+ date: 2025-02-06 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core