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 +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-sns/client.rb +79 -15
- data/lib/aws-sdk-sns/endpoint_provider.rb +15 -19
- data/lib/aws-sdk-sns/platform_endpoint.rb +44 -14
- data/lib/aws-sdk-sns/resource.rb +17 -0
- data/lib/aws-sdk-sns/topic.rb +61 -14
- data/lib/aws-sdk-sns/types.rb +100 -25
- data/lib/aws-sdk-sns.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 60acde1e78da1233b5bc1498b8a151ba7fb34c6c3a565f4f70eaa7de1c5325fe
|
4
|
+
data.tar.gz: 3481d65f9bf0c20aa9239caa06edeaa4fb23c727611dd21bf55d32cdb287bdbc
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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.
|
1
|
+
1.95.0
|
data/lib/aws-sdk-sns/client.rb
CHANGED
@@ -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
|
-
#
|
1882
|
-
#
|
1883
|
-
#
|
1884
|
-
#
|
1885
|
-
# Every message must have a unique `MessageDeduplicationId`, which is
|
1886
|
-
#
|
1887
|
-
#
|
1888
|
-
#
|
1889
|
-
#
|
1890
|
-
#
|
1891
|
-
#
|
1892
|
-
#
|
1893
|
-
#
|
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.
|
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
|
-
|
14
|
-
|
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
|
-
#
|
226
|
-
#
|
227
|
-
#
|
228
|
-
#
|
229
|
-
# Every message must have a unique `MessageDeduplicationId`, which is
|
230
|
-
#
|
231
|
-
#
|
232
|
-
#
|
233
|
-
#
|
234
|
-
#
|
235
|
-
#
|
236
|
-
#
|
237
|
-
#
|
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,
|
data/lib/aws-sdk-sns/resource.rb
CHANGED
@@ -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
|
#
|
data/lib/aws-sdk-sns/topic.rb
CHANGED
@@ -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
|
-
#
|
354
|
-
#
|
355
|
-
#
|
356
|
-
#
|
357
|
-
# Every message must have a unique `MessageDeduplicationId`, which is
|
358
|
-
#
|
359
|
-
#
|
360
|
-
#
|
361
|
-
#
|
362
|
-
#
|
363
|
-
#
|
364
|
-
#
|
365
|
-
#
|
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]
|
data/lib/aws-sdk-sns/types.rb
CHANGED
@@ -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
|
-
#
|
1737
|
-
#
|
1738
|
-
#
|
1739
|
-
#
|
1740
|
-
#
|
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
|
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
|
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.
|
1989
|
-
#
|
1990
|
-
#
|
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
|
-
#
|
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
|
-
#
|
2000
|
-
#
|
2001
|
-
#
|
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
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.
|
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-
|
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
|