aws-sdk-sns 1.92.0 → 1.96.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: 4ccab4e37fe911945b19c4b8e7569dfb4634a5ca08bfdb46862d72a577fc3742
4
- data.tar.gz: 798e83e8a8683c41e207fe8fb9664ddf8599a2e9d70d9ab5def959d9d7bb47d7
3
+ metadata.gz: 70ebdc4e9a9423f9319401a0b08b97eb09fadeefb6c1f5ae339fbf80fb4b52d9
4
+ data.tar.gz: 6e62f293b488fad73440d0d7d202aea3e242ee5beadc058bc7c63ca259bb014e
5
5
  SHA512:
6
- metadata.gz: 1004641d19b622a999209de7ff5c3a57b83b8468f2d24731c05f48a4bfa83223db03137399a2a2eca11f2f6cebd42df272ac98daf9ced3e1f400b7cf0b8ea17f
7
- data.tar.gz: 9893931c635fbd128e68a8dfc8d9c2ed41ed36ef9e0b026cada995acde559d8d0ae846406e7b88ff350bdf3fd4e4a084668d9342d39d7c53bb80b93989263d2e
6
+ metadata.gz: 30e25594f0009a2bc533c0e65f79f00b2b87ace29aaeeca7124ddd234d8c59606e64d8cb35c72954c68a5858346f4f7519a61204be262b6da50fbd881bac0ac4
7
+ data.tar.gz: '06695bb5ed244c4a53d5e2d5e015024b0701977b8f09dffaa98570c0a47f1636e6caae289f369f1b2b8f5da74b99003880876e9bdf06e656d07665fae7b02d8b'
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.96.0 (2025-02-18)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.95.0 (2025-02-06)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ 1.94.0 (2025-01-21)
15
+ ------------------
16
+
17
+ * 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.
18
+
19
+ 1.93.0 (2025-01-15)
20
+ ------------------
21
+
22
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
23
+
4
24
  1.92.0 (2024-11-22)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.92.0
1
+ 1.96.0
@@ -7,34 +7,34 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
- require 'seahorse/client/plugins/content_length.rb'
11
- require 'aws-sdk-core/plugins/credentials_configuration.rb'
12
- require 'aws-sdk-core/plugins/logging.rb'
13
- require 'aws-sdk-core/plugins/param_converter.rb'
14
- require 'aws-sdk-core/plugins/param_validator.rb'
15
- require 'aws-sdk-core/plugins/user_agent.rb'
16
- require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
17
- require 'aws-sdk-core/plugins/retry_errors.rb'
18
- require 'aws-sdk-core/plugins/global_configuration.rb'
19
- require 'aws-sdk-core/plugins/regional_endpoint.rb'
20
- require 'aws-sdk-core/plugins/endpoint_discovery.rb'
21
- require 'aws-sdk-core/plugins/endpoint_pattern.rb'
22
- require 'aws-sdk-core/plugins/response_paging.rb'
23
- require 'aws-sdk-core/plugins/stub_responses.rb'
24
- require 'aws-sdk-core/plugins/idempotency_token.rb'
25
- require 'aws-sdk-core/plugins/invocation_id.rb'
26
- require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
27
- require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
28
- require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
29
- require 'aws-sdk-core/plugins/transfer_encoding.rb'
30
- require 'aws-sdk-core/plugins/http_checksum.rb'
31
- require 'aws-sdk-core/plugins/checksum_algorithm.rb'
32
- require 'aws-sdk-core/plugins/request_compression.rb'
33
- require 'aws-sdk-core/plugins/defaults_mode.rb'
34
- require 'aws-sdk-core/plugins/recursion_detection.rb'
35
- require 'aws-sdk-core/plugins/telemetry.rb'
36
- require 'aws-sdk-core/plugins/sign.rb'
37
- require 'aws-sdk-core/plugins/protocols/query.rb'
10
+ require 'seahorse/client/plugins/content_length'
11
+ require 'aws-sdk-core/plugins/credentials_configuration'
12
+ require 'aws-sdk-core/plugins/logging'
13
+ require 'aws-sdk-core/plugins/param_converter'
14
+ require 'aws-sdk-core/plugins/param_validator'
15
+ require 'aws-sdk-core/plugins/user_agent'
16
+ require 'aws-sdk-core/plugins/helpful_socket_errors'
17
+ require 'aws-sdk-core/plugins/retry_errors'
18
+ require 'aws-sdk-core/plugins/global_configuration'
19
+ require 'aws-sdk-core/plugins/regional_endpoint'
20
+ require 'aws-sdk-core/plugins/endpoint_discovery'
21
+ require 'aws-sdk-core/plugins/endpoint_pattern'
22
+ require 'aws-sdk-core/plugins/response_paging'
23
+ require 'aws-sdk-core/plugins/stub_responses'
24
+ require 'aws-sdk-core/plugins/idempotency_token'
25
+ require 'aws-sdk-core/plugins/invocation_id'
26
+ require 'aws-sdk-core/plugins/jsonvalue_converter'
27
+ require 'aws-sdk-core/plugins/client_metrics_plugin'
28
+ require 'aws-sdk-core/plugins/client_metrics_send_plugin'
29
+ require 'aws-sdk-core/plugins/transfer_encoding'
30
+ require 'aws-sdk-core/plugins/http_checksum'
31
+ require 'aws-sdk-core/plugins/checksum_algorithm'
32
+ require 'aws-sdk-core/plugins/request_compression'
33
+ require 'aws-sdk-core/plugins/defaults_mode'
34
+ require 'aws-sdk-core/plugins/recursion_detection'
35
+ require 'aws-sdk-core/plugins/telemetry'
36
+ require 'aws-sdk-core/plugins/sign'
37
+ require 'aws-sdk-core/plugins/protocols/query'
38
38
 
39
39
  module Aws::SNS
40
40
  # An API client for SNS. To construct a client, you need to configure a `:region` and `:credentials`.
@@ -257,11 +257,34 @@ module Aws::SNS
257
257
  # Used when loading credentials from the shared credentials file
258
258
  # at HOME/.aws/credentials. When not specified, 'default' is used.
259
259
  #
260
+ # @option options [String] :request_checksum_calculation ("when_supported")
261
+ # Determines when a checksum will be calculated for request payloads. Values are:
262
+ #
263
+ # * `when_supported` - (default) When set, a checksum will be
264
+ # calculated for all request payloads of operations modeled with the
265
+ # `httpChecksum` trait where `requestChecksumRequired` is `true` and/or a
266
+ # `requestAlgorithmMember` is modeled.
267
+ # * `when_required` - When set, a checksum will only be calculated for
268
+ # request payloads of operations modeled with the `httpChecksum` trait where
269
+ # `requestChecksumRequired` is `true` or where a `requestAlgorithmMember`
270
+ # is modeled and supplied.
271
+ #
260
272
  # @option options [Integer] :request_min_compression_size_bytes (10240)
261
273
  # The minimum size in bytes that triggers compression for request
262
274
  # bodies. The value must be non-negative integer value between 0
263
275
  # and 10485780 bytes inclusive.
264
276
  #
277
+ # @option options [String] :response_checksum_validation ("when_supported")
278
+ # Determines when checksum validation will be performed on response payloads. Values are:
279
+ #
280
+ # * `when_supported` - (default) When set, checksum validation is performed on all
281
+ # response payloads of operations modeled with the `httpChecksum` trait where
282
+ # `responseAlgorithms` is modeled, except when no modeled checksum algorithms
283
+ # are supported.
284
+ # * `when_required` - When set, checksum validation is not performed on
285
+ # response payloads of operations unless the checksum algorithm is supported and
286
+ # the `requestValidationModeMember` member is set to `ENABLED`.
287
+ #
265
288
  # @option options [Proc] :retry_backoff
266
289
  # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
267
290
  # This option is only used in the `legacy` retry mode.
@@ -855,6 +878,22 @@ module Aws::SNS
855
878
  # (Optional) To override the generated value, you can specify a
856
879
  # value for the `MessageDeduplicationId` parameter for the `Publish`
857
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.
858
897
  #
859
898
  #
860
899
  #
@@ -863,6 +902,7 @@ module Aws::SNS
863
902
  # [3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
864
903
  # [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
865
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
866
906
  #
867
907
  # @option params [Array<Types::Tag>] :tags
868
908
  # The list of tags to add to a new topic.
@@ -1854,20 +1894,50 @@ module Aws::SNS
1854
1894
  # Message attributes for Publish action.
1855
1895
  #
1856
1896
  # @option params [String] :message_deduplication_id
1857
- # This parameter applies only to FIFO (first-in-first-out) topics. The
1858
- # `MessageDeduplicationId` can contain up to 128 alphanumeric characters
1859
- # `(a-z, A-Z, 0-9)` and punctuation ``
1860
- # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
1861
- #
1862
- # Every message must have a unique `MessageDeduplicationId`, which is a
1863
- # token used for deduplication of sent messages. If a message with a
1864
- # particular `MessageDeduplicationId` is sent successfully, any message
1865
- # sent with the same `MessageDeduplicationId` during the 5-minute
1866
- # deduplication interval is treated as a duplicate.
1867
- #
1868
- # If the topic has `ContentBasedDeduplication` set, the system generates
1869
- # a `MessageDeduplicationId` based on the contents of the message. Your
1870
- # `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.
1871
1941
  #
1872
1942
  # @option params [String] :message_group_id
1873
1943
  # This parameter applies only to FIFO (first-in-first-out) topics. The
@@ -2592,6 +2662,22 @@ module Aws::SNS
2592
2662
  # (Optional) To override the generated value, you can specify a
2593
2663
  # value for the `MessageDeduplicationId` parameter for the `Publish`
2594
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.
2595
2681
  #
2596
2682
  #
2597
2683
  #
@@ -2601,6 +2687,7 @@ module Aws::SNS
2601
2687
  # [4]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
2602
2688
  # [5]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
2603
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
2604
2691
  #
2605
2692
  # @option params [String] :attribute_value
2606
2693
  # The new value for the attribute.
@@ -2985,7 +3072,7 @@ module Aws::SNS
2985
3072
  tracer: tracer
2986
3073
  )
2987
3074
  context[:gem_name] = 'aws-sdk-sns'
2988
- context[:gem_version] = '1.92.0'
3075
+ context[:gem_version] = '1.96.0'
2989
3076
  Seahorse::Client::Request.new(handlers, context)
2990
3077
  end
2991
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.92.0'
61
+ GEM_VERSION = '1.96.0'
62
62
 
63
63
  end
64
64
 
data/sig/client.rbs CHANGED
@@ -39,7 +39,9 @@ module Aws
39
39
  ?logger: untyped,
40
40
  ?max_attempts: Integer,
41
41
  ?profile: String,
42
+ ?request_checksum_calculation: String,
42
43
  ?request_min_compression_size_bytes: Integer,
44
+ ?response_checksum_validation: String,
43
45
  ?retry_backoff: Proc,
44
46
  ?retry_base_delay: Float,
45
47
  ?retry_jitter: (:none | :equal | :full | ^(Integer) -> Integer),
data/sig/resource.rbs CHANGED
@@ -39,7 +39,9 @@ module Aws
39
39
  ?logger: untyped,
40
40
  ?max_attempts: Integer,
41
41
  ?profile: String,
42
+ ?request_checksum_calculation: String,
42
43
  ?request_min_compression_size_bytes: Integer,
44
+ ?response_checksum_validation: String,
43
45
  ?retry_backoff: Proc,
44
46
  ?retry_base_delay: Float,
45
47
  ?retry_jitter: (:none | :equal | :full | ^(Integer) -> Integer),
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.92.0
4
+ version: 1.96.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: 2024-11-22 00:00:00.000000000 Z
11
+ date: 2025-02-18 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.210.0
22
+ version: 3.216.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.210.0
32
+ version: 3.216.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement