aws-sdk-sns 1.102.0 → 1.104.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: f33cb72b29aa3d6c20ff6656abb2d697fb5d02f4daa543ae8dc3252e5826507f
4
- data.tar.gz: 313f41df0e516c7b9423250406a272e77bc6731c443a8ecf16b99ea52f59fd59
3
+ metadata.gz: 6968f3ed01d024dde585626f5f6f34f6e57309136f05370e28178f489a88a5a9
4
+ data.tar.gz: 747784ca9df23a74d0c0a8621c852f1f61065c4033d59b198130a9bbe623cf3d
5
5
  SHA512:
6
- metadata.gz: f519469d5581a7533005982219bdbbfd88a10c17a6caa4bacb12e6bd4a4dc63b38120384ca341ab903c17c4a13b774e7fb4104c2af99ba82d2abe4b0af462d92
7
- data.tar.gz: 5dd8296241268d944437657cf7d92536b13c6a424d2d81d391d0d11a54a3cb3930fad24902e01c33150036098933d9e2201b69202e09b71e11c4fd63463ac814
6
+ metadata.gz: 4cd5895cd2d11961baa4eefff795a1d4ff134cc1308a1d1296cda792c9e96982d7286bd160909f016d82b80655910001f47bb86ce5ffcff140431c5e77358bd7
7
+ data.tar.gz: 8a79eac73604fbf19720d1614ec8604d47b806beb2aac989af0645dc8f3f6536c0e2a3d01fc2bbe33f60e54c1321e1876b714b708d2842be2cbba70a2aa416b1
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.104.0 (2025-08-04)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.103.0 (2025-08-01)
10
+ ------------------
11
+
12
+ * Feature - Amazon SNS support for Amazon SQS fair queues
13
+
4
14
  1.102.0 (2025-07-31)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.102.0
1
+ 1.104.0
@@ -95,8 +95,8 @@ module Aws::SNS
95
95
  # class name or an instance of a plugin class.
96
96
  #
97
97
  # @option options [required, Aws::CredentialProvider] :credentials
98
- # Your AWS credentials used for authentication. This can be an instance of any one of the
99
- # following classes:
98
+ # Your AWS credentials used for authentication. This can be any class that includes and implements
99
+ # `Aws::CredentialProvider`, or instance of any one of the following classes:
100
100
  #
101
101
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
102
102
  # credentials.
@@ -124,8 +124,7 @@ module Aws::SNS
124
124
  # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
125
125
  # from the Cognito Identity service.
126
126
  #
127
- # When `:credentials` are not configured directly, the following
128
- # locations will be searched for credentials:
127
+ # When `:credentials` are not configured directly, the following locations will be searched for credentials:
129
128
  #
130
129
  # * `Aws.config[:credentials]`
131
130
  #
@@ -139,12 +138,10 @@ module Aws::SNS
139
138
  #
140
139
  # * `~/.aws/config`
141
140
  #
142
- # * EC2/ECS IMDS instance profile - When used by default, the timeouts
143
- # are very aggressive. Construct and pass an instance of
144
- # `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
145
- # enable retries and extended timeouts. Instance profile credential
146
- # fetching can be disabled by setting `ENV['AWS_EC2_METADATA_DISABLED']`
147
- # to `true`.
141
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts are very aggressive.
142
+ # Construct and pass an instance of `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
143
+ # enable retries and extended timeouts. Instance profile credential fetching can be disabled by
144
+ # setting `ENV['AWS_EC2_METADATA_DISABLED']` to `true`.
148
145
  #
149
146
  # @option options [required, String] :region
150
147
  # The AWS region to connect to. The configured `:region` is
@@ -377,8 +374,8 @@ module Aws::SNS
377
374
  # `Aws::Telemetry::OTelProvider` for telemetry provider.
378
375
  #
379
376
  # @option options [Aws::TokenProvider] :token_provider
380
- # Your Bearer token used for authentication. This can be an instance of any one of the
381
- # following classes:
377
+ # Your Bearer token used for authentication. This can be any class that includes and implements
378
+ # `Aws::TokenProvider`, or instance of any one of the following classes:
382
379
  #
383
380
  # * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
384
381
  # tokens.
@@ -631,10 +628,11 @@ module Aws::SNS
631
628
  #
632
629
  # * For GCM (Firebase Cloud Messaging) using token credentials, there is
633
630
  # no `PlatformPrincipal`. The `PlatformCredential` is a JSON formatted
634
- # private key file. When using the Amazon Web Services CLI, the file
635
- # must be in string format and special characters must be ignored. To
636
- # format the file correctly, Amazon SNS recommends using the following
637
- # command: `` SERVICE_JSON=`jq @json <<< cat service.json` ``.
631
+ # private key file. When using the Amazon Web Services CLI or Amazon
632
+ # Web Services SDKs, the file must be in string format and special
633
+ # characters must be ignored. To format the file correctly, Amazon SNS
634
+ # recommends using the following command: `SERVICE_JSON=$(jq @json <
635
+ # service.json)`.
638
636
  #
639
637
  # * For MPNS, `PlatformPrincipal` is `TLS certificate` and
640
638
  # `PlatformCredential` is `private key`.
@@ -840,17 +838,9 @@ module Aws::SNS
840
838
  # * `DisplayName` – The display name to use for a topic with SMS
841
839
  # subscriptions.
842
840
  #
843
- # * `FifoTopic` – Set to true to create a FIFO topic.
844
- #
845
841
  # * `Policy` – The policy that defines who can access your topic. By
846
842
  # default, only the topic owner can publish or subscribe to the topic.
847
843
  #
848
- # * `SignatureVersion` – The signature version corresponds to the
849
- # hashing algorithm used while creating the signature of the
850
- # notifications, subscription confirmations, or unsubscribe
851
- # confirmation messages sent by Amazon SNS. By default,
852
- # `SignatureVersion` is set to `1`.
853
- #
854
844
  # * `TracingConfig` – Tracing mode of an Amazon SNS topic. By default
855
845
  # `TracingConfig` is set to `PassThrough`, and the topic passes
856
846
  # through the tracing header it receives from an Amazon SNS publisher
@@ -858,16 +848,104 @@ module Aws::SNS
858
848
  # segment data to topic owner account if the sampled flag in the
859
849
  # tracing header is true. This is only supported on standard topics.
860
850
  #
861
- # The following attribute applies only to [server-side encryption][1]:
851
+ # * HTTP
852
+ #
853
+ # * `HTTPSuccessFeedbackRoleArn` – Indicates successful message
854
+ # delivery status for an Amazon SNS topic that is subscribed to an
855
+ # HTTP endpoint.
856
+ #
857
+ # * `HTTPSuccessFeedbackSampleRate` – Indicates percentage of
858
+ # successful messages to sample for an Amazon SNS topic that is
859
+ # subscribed to an HTTP endpoint.
860
+ #
861
+ # * `HTTPFailureFeedbackRoleArn` – Indicates failed message delivery
862
+ # status for an Amazon SNS topic that is subscribed to an HTTP
863
+ # endpoint.
864
+ # * Amazon Data Firehose
865
+ #
866
+ # * `FirehoseSuccessFeedbackRoleArn` – Indicates successful message
867
+ # delivery status for an Amazon SNS topic that is subscribed to an
868
+ # Amazon Data Firehose endpoint.
869
+ #
870
+ # * `FirehoseSuccessFeedbackSampleRate` – Indicates percentage of
871
+ # successful messages to sample for an Amazon SNS topic that is
872
+ # subscribed to an Amazon Data Firehose endpoint.
873
+ #
874
+ # * `FirehoseFailureFeedbackRoleArn` – Indicates failed message
875
+ # delivery status for an Amazon SNS topic that is subscribed to an
876
+ # Amazon Data Firehose endpoint.
877
+ # * Lambda
878
+ #
879
+ # * `LambdaSuccessFeedbackRoleArn` – Indicates successful message
880
+ # delivery status for an Amazon SNS topic that is subscribed to an
881
+ # Lambda endpoint.
882
+ #
883
+ # * `LambdaSuccessFeedbackSampleRate` – Indicates percentage of
884
+ # successful messages to sample for an Amazon SNS topic that is
885
+ # subscribed to an Lambda endpoint.
886
+ #
887
+ # * `LambdaFailureFeedbackRoleArn` – Indicates failed message delivery
888
+ # status for an Amazon SNS topic that is subscribed to an Lambda
889
+ # endpoint.
890
+ # * Platform application endpoint
891
+ #
892
+ # * `ApplicationSuccessFeedbackRoleArn` – Indicates successful message
893
+ # delivery status for an Amazon SNS topic that is subscribed to a
894
+ # platform application endpoint.
895
+ #
896
+ # * `ApplicationSuccessFeedbackSampleRate` – Indicates percentage of
897
+ # successful messages to sample for an Amazon SNS topic that is
898
+ # subscribed to an platform application endpoint.
899
+ #
900
+ # * `ApplicationFailureFeedbackRoleArn` – Indicates failed message
901
+ # delivery status for an Amazon SNS topic that is subscribed to an
902
+ # platform application endpoint.
903
+ # <note markdown="1"> In addition to being able to configure topic attributes for message
904
+ # delivery status of notification messages sent to Amazon SNS
905
+ # application endpoints, you can also configure application attributes
906
+ # for the delivery status of push notification messages sent to push
907
+ # notification services.
908
+ #
909
+ # For example, For more information, see [Using Amazon SNS Application
910
+ # Attributes for Message Delivery Status][1].
911
+ #
912
+ # </note>
913
+ #
914
+ # * Amazon SQS
915
+ #
916
+ # * `SQSSuccessFeedbackRoleArn` – Indicates successful message
917
+ # delivery status for an Amazon SNS topic that is subscribed to an
918
+ # Amazon SQS endpoint.
919
+ #
920
+ # * `SQSSuccessFeedbackSampleRate` – Indicates percentage of
921
+ # successful messages to sample for an Amazon SNS topic that is
922
+ # subscribed to an Amazon SQS endpoint.
923
+ #
924
+ # * `SQSFailureFeedbackRoleArn` – Indicates failed message delivery
925
+ # status for an Amazon SNS topic that is subscribed to an Amazon SQS
926
+ # endpoint.
927
+ #
928
+ # <note markdown="1"> The &lt;ENDPOINT&gt;SuccessFeedbackRoleArn and
929
+ # &lt;ENDPOINT&gt;FailureFeedbackRoleArn attributes are used to give
930
+ # Amazon SNS write access to use CloudWatch Logs on your behalf. The
931
+ # &lt;ENDPOINT&gt;SuccessFeedbackSampleRate attribute is for specifying
932
+ # the sample rate percentage (0-100) of successfully delivered messages.
933
+ # After you configure the &lt;ENDPOINT&gt;FailureFeedbackRoleArn
934
+ # attribute, then all failed message deliveries generate CloudWatch
935
+ # Logs.
936
+ #
937
+ # </note>
938
+ #
939
+ # The following attribute applies only to [server-side encryption][2]:
862
940
  #
863
941
  # * `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer
864
942
  # master key (CMK) for Amazon SNS or a custom CMK. For more
865
- # information, see [Key Terms][2]. For more examples, see [KeyId][3]
943
+ # information, see [Key Terms][3]. For more examples, see [KeyId][4]
866
944
  # in the *Key Management Service API Reference*.
867
945
  #
868
946
  # ^
869
947
  #
870
- # The following attributes apply only to [FIFO topics][4]:
948
+ # The following attributes apply only to [FIFO topics][5]:
871
949
  #
872
950
  # * `ArchivePolicy` – The policy that sets the retention period for
873
951
  # messages stored in the message archive of an Amazon SNS FIFO topic.
@@ -878,7 +956,7 @@ module Aws::SNS
878
956
  # * By default, `ContentBasedDeduplication` is set to `false`. If you
879
957
  # create a FIFO topic and this attribute is `false`, you must
880
958
  # specify a value for the `MessageDeduplicationId` parameter for the
881
- # [Publish][5] action.
959
+ # [Publish][6] action.
882
960
  #
883
961
  # * When you set `ContentBasedDeduplication` to `true`, Amazon SNS
884
962
  # uses a SHA-256 hash to generate the `MessageDeduplicationId` using
@@ -901,17 +979,18 @@ module Aws::SNS
901
979
  # * `MessageGroup` – The scope of deduplication is within each
902
980
  # individual message group, which enables higher throughput per
903
981
  # topic subject to regional quotas. For more information on quotas
904
- # or to request an increase, see [Amazon SNS service quotas][6] in
982
+ # or to request an increase, see [Amazon SNS service quotas][7] in
905
983
  # the Amazon Web Services General Reference.
906
984
  #
907
985
  #
908
986
  #
909
- # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
910
- # [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
911
- # [3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
912
- # [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
913
- # [5]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
914
- # [6]: https://docs.aws.amazon.com/general/latest/gr/sns.html
987
+ # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html
988
+ # [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
989
+ # [3]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
990
+ # [4]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
991
+ # [5]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
992
+ # [6]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
993
+ # [7]: https://docs.aws.amazon.com/general/latest/gr/sns.html
915
994
  #
916
995
  # @option params [Array<Types::Tag>] :tags
917
996
  # The list of tags to add to a new topic.
@@ -1949,15 +2028,25 @@ module Aws::SNS
1949
2028
  # scope and interval, and only one copy of the message is delivered.
1950
2029
  #
1951
2030
  # @option params [String] :message_group_id
1952
- # This parameter applies only to FIFO (first-in-first-out) topics. The
1953
- # `MessageGroupId` can contain up to 128 alphanumeric characters `(a-z,
1954
- # A-Z, 0-9)` and punctuation `` (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
2031
+ # The `MessageGroupId` can contain up to 128 alphanumeric characters
2032
+ # `(a-z, A-Z, 0-9)` and punctuation ``
2033
+ # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
2034
+ #
2035
+ # For FIFO topics: The `MessageGroupId` is a tag that specifies that a
2036
+ # message belongs to a specific message group. Messages that belong to
2037
+ # the same message group are processed in a FIFO manner (however,
2038
+ # messages in different message groups might be processed out of order).
2039
+ # Every message must include a `MessageGroupId`.
2040
+ #
2041
+ # For standard topics: The `MessageGroupId` is optional and is forwarded
2042
+ # only to Amazon SQS standard subscriptions to activate [fair
2043
+ # queues][1]. The `MessageGroupId` is not used for, or sent to, any
2044
+ # other endpoint types. When provided, the same validation rules apply
2045
+ # as for FIFO topics.
2046
+ #
1955
2047
  #
1956
- # The `MessageGroupId` is a tag that specifies that a message belongs to
1957
- # a specific message group. Messages that belong to the same message
1958
- # group are processed in a FIFO manner (however, messages in different
1959
- # message groups might be processed out of order). Every message must
1960
- # include a `MessageGroupId`.
2048
+ #
2049
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-fair-queues.html
1961
2050
  #
1962
2051
  # @return [Types::PublishResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1963
2052
  #
@@ -1998,34 +2087,45 @@ module Aws::SNS
1998
2087
  req.send_request(options)
1999
2088
  end
2000
2089
 
2001
- # Publishes up to ten messages to the specified topic. This is a batch
2002
- # version of `Publish`. For FIFO topics, multiple messages within a
2003
- # single batch are published in the order they are sent, and messages
2004
- # are deduplicated within the batch and across batches for 5 minutes.
2090
+ # Publishes up to 10 messages to the specified topic in a single batch.
2091
+ # This is a batch version of the `Publish` API. If you try to send more
2092
+ # than 10 messages in a single batch request, you will receive a
2093
+ # `TooManyEntriesInBatchRequest` exception.
2094
+ #
2095
+ # For FIFO topics, multiple messages within a single batch are published
2096
+ # in the order they are sent, and messages are deduplicated within the
2097
+ # batch and across batches for five minutes.
2005
2098
  #
2006
2099
  # The result of publishing each message is reported individually in the
2007
2100
  # response. Because the batch request can result in a combination of
2008
2101
  # successful and unsuccessful actions, you should check for batch errors
2009
- # even when the call returns an HTTP status code of `200`.
2102
+ # even when the call returns an HTTP status code of 200.
2010
2103
  #
2011
2104
  # The maximum allowed individual message size and the maximum total
2012
2105
  # payload size (the sum of the individual lengths of all of the batched
2013
2106
  # messages) are both 256 KB (262,144 bytes).
2014
2107
  #
2108
+ # The `PublishBatch` API can send up to 10 messages at a time. If you
2109
+ # attempt to send more than 10 messages in one request, you will
2110
+ # encounter a `TooManyEntriesInBatchRequest` exception. In such cases,
2111
+ # split your messages into multiple requests, each containing no more
2112
+ # than 10 messages.
2113
+ #
2015
2114
  # Some actions take lists of parameters. These lists are specified using
2016
- # the `param.n` notation. Values of `n` are integers starting from 1.
2017
- # For example, a parameter list with two elements looks like this:
2115
+ # the `param.n` notation. Values of `n` are integers starting from
2116
+ # **1**. For example, a parameter list with two elements looks like
2117
+ # this:
2018
2118
  #
2019
- # &amp;AttributeName.1=first
2119
+ # `&AttributeName.1=first`
2020
2120
  #
2021
- # &amp;AttributeName.2=second
2121
+ # `&AttributeName.2=second`
2022
2122
  #
2023
2123
  # If you send a batch message to a topic, Amazon SNS publishes the batch
2024
2124
  # message to each endpoint that is subscribed to the topic. The format
2025
2125
  # of the batch message depends on the notification protocol for each
2026
2126
  # subscribed endpoint.
2027
2127
  #
2028
- # When a `messageId` is returned, the batch message is saved and Amazon
2128
+ # When a `messageId` is returned, the batch message is saved, and Amazon
2029
2129
  # SNS immediately delivers the message to subscribers.
2030
2130
  #
2031
2131
  # @option params [required, String] :topic_arn
@@ -2530,10 +2630,6 @@ module Aws::SNS
2530
2630
  # The following lists the names, descriptions, and values of the special
2531
2631
  # request parameters that the `SetTopicAttributes` action uses:
2532
2632
  #
2533
- # * `ApplicationSuccessFeedbackRoleArn` – Indicates failed message
2534
- # delivery status for an Amazon SNS topic that is subscribed to a
2535
- # platform application endpoint.
2536
- #
2537
2633
  # * `DeliveryPolicy` – The policy that defines how Amazon SNS retries
2538
2634
  # failed deliveries to HTTP/S endpoints.
2539
2635
  #
@@ -2563,19 +2659,19 @@ module Aws::SNS
2563
2659
  # * `HTTPFailureFeedbackRoleArn` – Indicates failed message delivery
2564
2660
  # status for an Amazon SNS topic that is subscribed to an HTTP
2565
2661
  # endpoint.
2566
- # * Amazon Kinesis Data Firehose
2662
+ # * Amazon Data Firehose
2567
2663
  #
2568
2664
  # * `FirehoseSuccessFeedbackRoleArn` – Indicates successful message
2569
2665
  # delivery status for an Amazon SNS topic that is subscribed to an
2570
- # Amazon Kinesis Data Firehose endpoint.
2666
+ # Amazon Data Firehose endpoint.
2571
2667
  #
2572
2668
  # * `FirehoseSuccessFeedbackSampleRate` – Indicates percentage of
2573
2669
  # successful messages to sample for an Amazon SNS topic that is
2574
- # subscribed to an Amazon Kinesis Data Firehose endpoint.
2670
+ # subscribed to an Amazon Data Firehose endpoint.
2575
2671
  #
2576
2672
  # * `FirehoseFailureFeedbackRoleArn` – Indicates failed message
2577
2673
  # delivery status for an Amazon SNS topic that is subscribed to an
2578
- # Amazon Kinesis Data Firehose endpoint.
2674
+ # Amazon Data Firehose endpoint.
2579
2675
  # * Lambda
2580
2676
  #
2581
2677
  # * `LambdaSuccessFeedbackRoleArn` – Indicates successful message
@@ -2593,15 +2689,15 @@ module Aws::SNS
2593
2689
  #
2594
2690
  # * `ApplicationSuccessFeedbackRoleArn` – Indicates successful message
2595
2691
  # delivery status for an Amazon SNS topic that is subscribed to an
2596
- # Amazon Web Services application endpoint.
2692
+ # platform application endpoint.
2597
2693
  #
2598
2694
  # * `ApplicationSuccessFeedbackSampleRate` – Indicates percentage of
2599
2695
  # successful messages to sample for an Amazon SNS topic that is
2600
- # subscribed to an Amazon Web Services application endpoint.
2696
+ # subscribed to an platform application endpoint.
2601
2697
  #
2602
2698
  # * `ApplicationFailureFeedbackRoleArn` – Indicates failed message
2603
2699
  # delivery status for an Amazon SNS topic that is subscribed to an
2604
- # Amazon Web Services application endpoint.
2700
+ # platform application endpoint.
2605
2701
  # <note markdown="1"> In addition to being able to configure topic attributes for message
2606
2702
  # delivery status of notification messages sent to Amazon SNS
2607
2703
  # application endpoints, you can also configure application attributes
@@ -2753,8 +2849,8 @@ module Aws::SNS
2753
2849
  #
2754
2850
  # * `lambda` – delivery of JSON-encoded message to an Lambda function
2755
2851
  #
2756
- # * `firehose` – delivery of JSON-encoded message to an Amazon Kinesis
2757
- # Data Firehose delivery stream.
2852
+ # * `firehose` – delivery of JSON-encoded message to an Amazon Data
2853
+ # Firehose delivery stream.
2758
2854
  #
2759
2855
  # @option params [String] :endpoint
2760
2856
  # The endpoint that you want to receive notifications. Endpoints vary by
@@ -2783,7 +2879,7 @@ module Aws::SNS
2783
2879
  # function.
2784
2880
  #
2785
2881
  # * For the `firehose` protocol, the endpoint is the ARN of an Amazon
2786
- # Kinesis Data Firehose delivery stream.
2882
+ # Data Firehose delivery stream.
2787
2883
  #
2788
2884
  # @option params [Hash<String,String>] :attributes
2789
2885
  # A map of attributes with their corresponding values.
@@ -2962,12 +3058,6 @@ module Aws::SNS
2962
3058
  # is delivered to the endpoint, so that the endpoint owner can easily
2963
3059
  # resubscribe to the topic if the `Unsubscribe` request was unintended.
2964
3060
  #
2965
- # <note markdown="1"> Amazon SQS queue subscriptions require authentication for deletion.
2966
- # Only the owner of the subscription, or the owner of the topic can
2967
- # unsubscribe using the required Amazon Web Services signature.
2968
- #
2969
- # </note>
2970
- #
2971
3061
  # This action is throttled at 100 transactions per second (TPS).
2972
3062
  #
2973
3063
  # @option params [required, String] :subscription_arn
@@ -3081,7 +3171,7 @@ module Aws::SNS
3081
3171
  tracer: tracer
3082
3172
  )
3083
3173
  context[:gem_name] = 'aws-sdk-sns'
3084
- context[:gem_version] = '1.102.0'
3174
+ context[:gem_version] = '1.104.0'
3085
3175
  Seahorse::Client::Request.new(handlers, context)
3086
3176
  end
3087
3177
 
@@ -266,15 +266,25 @@ module Aws::SNS
266
266
  # the two messages are treated as duplicates, within the deduplication
267
267
  # scope and interval, and only one copy of the message is delivered.
268
268
  # @option options [String] :message_group_id
269
- # This parameter applies only to FIFO (first-in-first-out) topics. The
270
- # `MessageGroupId` can contain up to 128 alphanumeric characters `(a-z,
271
- # A-Z, 0-9)` and punctuation `` (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
272
- #
273
- # The `MessageGroupId` is a tag that specifies that a message belongs to
274
- # a specific message group. Messages that belong to the same message
275
- # group are processed in a FIFO manner (however, messages in different
276
- # message groups might be processed out of order). Every message must
277
- # include a `MessageGroupId`.
269
+ # The `MessageGroupId` can contain up to 128 alphanumeric characters
270
+ # `(a-z, A-Z, 0-9)` and punctuation ``
271
+ # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
272
+ #
273
+ # For FIFO topics: The `MessageGroupId` is a tag that specifies that a
274
+ # message belongs to a specific message group. Messages that belong to
275
+ # the same message group are processed in a FIFO manner (however,
276
+ # messages in different message groups might be processed out of order).
277
+ # Every message must include a `MessageGroupId`.
278
+ #
279
+ # For standard topics: The `MessageGroupId` is optional and is forwarded
280
+ # only to Amazon SQS standard subscriptions to activate [fair
281
+ # queues][1]. The `MessageGroupId` is not used for, or sent to, any
282
+ # other endpoint types. When provided, the same validation rules apply
283
+ # as for FIFO topics.
284
+ #
285
+ #
286
+ #
287
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-fair-queues.html
278
288
  # @return [Types::PublishResponse]
279
289
  def publish(options = {})
280
290
  options = options.merge(target_arn: @arn)
@@ -108,17 +108,9 @@ module Aws::SNS
108
108
  # * `DisplayName` – The display name to use for a topic with SMS
109
109
  # subscriptions.
110
110
  #
111
- # * `FifoTopic` – Set to true to create a FIFO topic.
112
- #
113
111
  # * `Policy` – The policy that defines who can access your topic. By
114
112
  # default, only the topic owner can publish or subscribe to the topic.
115
113
  #
116
- # * `SignatureVersion` – The signature version corresponds to the
117
- # hashing algorithm used while creating the signature of the
118
- # notifications, subscription confirmations, or unsubscribe
119
- # confirmation messages sent by Amazon SNS. By default,
120
- # `SignatureVersion` is set to `1`.
121
- #
122
114
  # * `TracingConfig` – Tracing mode of an Amazon SNS topic. By default
123
115
  # `TracingConfig` is set to `PassThrough`, and the topic passes
124
116
  # through the tracing header it receives from an Amazon SNS publisher
@@ -126,16 +118,104 @@ module Aws::SNS
126
118
  # segment data to topic owner account if the sampled flag in the
127
119
  # tracing header is true. This is only supported on standard topics.
128
120
  #
129
- # The following attribute applies only to [server-side encryption][1]:
121
+ # * HTTP
122
+ #
123
+ # * `HTTPSuccessFeedbackRoleArn` – Indicates successful message
124
+ # delivery status for an Amazon SNS topic that is subscribed to an
125
+ # HTTP endpoint.
126
+ #
127
+ # * `HTTPSuccessFeedbackSampleRate` – Indicates percentage of
128
+ # successful messages to sample for an Amazon SNS topic that is
129
+ # subscribed to an HTTP endpoint.
130
+ #
131
+ # * `HTTPFailureFeedbackRoleArn` – Indicates failed message delivery
132
+ # status for an Amazon SNS topic that is subscribed to an HTTP
133
+ # endpoint.
134
+ # * Amazon Data Firehose
135
+ #
136
+ # * `FirehoseSuccessFeedbackRoleArn` – Indicates successful message
137
+ # delivery status for an Amazon SNS topic that is subscribed to an
138
+ # Amazon Data Firehose endpoint.
139
+ #
140
+ # * `FirehoseSuccessFeedbackSampleRate` – Indicates percentage of
141
+ # successful messages to sample for an Amazon SNS topic that is
142
+ # subscribed to an Amazon Data Firehose endpoint.
143
+ #
144
+ # * `FirehoseFailureFeedbackRoleArn` – Indicates failed message
145
+ # delivery status for an Amazon SNS topic that is subscribed to an
146
+ # Amazon Data Firehose endpoint.
147
+ # * Lambda
148
+ #
149
+ # * `LambdaSuccessFeedbackRoleArn` – Indicates successful message
150
+ # delivery status for an Amazon SNS topic that is subscribed to an
151
+ # Lambda endpoint.
152
+ #
153
+ # * `LambdaSuccessFeedbackSampleRate` – Indicates percentage of
154
+ # successful messages to sample for an Amazon SNS topic that is
155
+ # subscribed to an Lambda endpoint.
156
+ #
157
+ # * `LambdaFailureFeedbackRoleArn` – Indicates failed message delivery
158
+ # status for an Amazon SNS topic that is subscribed to an Lambda
159
+ # endpoint.
160
+ # * Platform application endpoint
161
+ #
162
+ # * `ApplicationSuccessFeedbackRoleArn` – Indicates successful message
163
+ # delivery status for an Amazon SNS topic that is subscribed to a
164
+ # platform application endpoint.
165
+ #
166
+ # * `ApplicationSuccessFeedbackSampleRate` – Indicates percentage of
167
+ # successful messages to sample for an Amazon SNS topic that is
168
+ # subscribed to an platform application endpoint.
169
+ #
170
+ # * `ApplicationFailureFeedbackRoleArn` – Indicates failed message
171
+ # delivery status for an Amazon SNS topic that is subscribed to an
172
+ # platform application endpoint.
173
+ # <note markdown="1"> In addition to being able to configure topic attributes for message
174
+ # delivery status of notification messages sent to Amazon SNS
175
+ # application endpoints, you can also configure application attributes
176
+ # for the delivery status of push notification messages sent to push
177
+ # notification services.
178
+ #
179
+ # For example, For more information, see [Using Amazon SNS Application
180
+ # Attributes for Message Delivery Status][1].
181
+ #
182
+ # </note>
183
+ #
184
+ # * Amazon SQS
185
+ #
186
+ # * `SQSSuccessFeedbackRoleArn` – Indicates successful message
187
+ # delivery status for an Amazon SNS topic that is subscribed to an
188
+ # Amazon SQS endpoint.
189
+ #
190
+ # * `SQSSuccessFeedbackSampleRate` – Indicates percentage of
191
+ # successful messages to sample for an Amazon SNS topic that is
192
+ # subscribed to an Amazon SQS endpoint.
193
+ #
194
+ # * `SQSFailureFeedbackRoleArn` – Indicates failed message delivery
195
+ # status for an Amazon SNS topic that is subscribed to an Amazon SQS
196
+ # endpoint.
197
+ #
198
+ # <note markdown="1"> The &lt;ENDPOINT&gt;SuccessFeedbackRoleArn and
199
+ # &lt;ENDPOINT&gt;FailureFeedbackRoleArn attributes are used to give
200
+ # Amazon SNS write access to use CloudWatch Logs on your behalf. The
201
+ # &lt;ENDPOINT&gt;SuccessFeedbackSampleRate attribute is for specifying
202
+ # the sample rate percentage (0-100) of successfully delivered messages.
203
+ # After you configure the &lt;ENDPOINT&gt;FailureFeedbackRoleArn
204
+ # attribute, then all failed message deliveries generate CloudWatch
205
+ # Logs.
206
+ #
207
+ # </note>
208
+ #
209
+ # The following attribute applies only to [server-side encryption][2]:
130
210
  #
131
211
  # * `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer
132
212
  # master key (CMK) for Amazon SNS or a custom CMK. For more
133
- # information, see [Key Terms][2]. For more examples, see [KeyId][3]
213
+ # information, see [Key Terms][3]. For more examples, see [KeyId][4]
134
214
  # in the *Key Management Service API Reference*.
135
215
  #
136
216
  # ^
137
217
  #
138
- # The following attributes apply only to [FIFO topics][4]:
218
+ # The following attributes apply only to [FIFO topics][5]:
139
219
  #
140
220
  # * `ArchivePolicy` – The policy that sets the retention period for
141
221
  # messages stored in the message archive of an Amazon SNS FIFO topic.
@@ -146,7 +226,7 @@ module Aws::SNS
146
226
  # * By default, `ContentBasedDeduplication` is set to `false`. If you
147
227
  # create a FIFO topic and this attribute is `false`, you must
148
228
  # specify a value for the `MessageDeduplicationId` parameter for the
149
- # [Publish][5] action.
229
+ # [Publish][6] action.
150
230
  #
151
231
  # * When you set `ContentBasedDeduplication` to `true`, Amazon SNS
152
232
  # uses a SHA-256 hash to generate the `MessageDeduplicationId` using
@@ -169,17 +249,18 @@ module Aws::SNS
169
249
  # * `MessageGroup` – The scope of deduplication is within each
170
250
  # individual message group, which enables higher throughput per
171
251
  # topic subject to regional quotas. For more information on quotas
172
- # or to request an increase, see [Amazon SNS service quotas][6] in
252
+ # or to request an increase, see [Amazon SNS service quotas][7] in
173
253
  # the Amazon Web Services General Reference.
174
254
  #
175
255
  #
176
256
  #
177
- # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
178
- # [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
179
- # [3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
180
- # [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
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
257
+ # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html
258
+ # [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
259
+ # [3]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
260
+ # [4]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
261
+ # [5]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
262
+ # [6]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
263
+ # [7]: https://docs.aws.amazon.com/general/latest/gr/sns.html
183
264
  # @option options [Array<Types::Tag>] :tags
184
265
  # The list of tags to add to a new topic.
185
266
  #
@@ -394,15 +394,25 @@ module Aws::SNS
394
394
  # the two messages are treated as duplicates, within the deduplication
395
395
  # scope and interval, and only one copy of the message is delivered.
396
396
  # @option options [String] :message_group_id
397
- # This parameter applies only to FIFO (first-in-first-out) topics. The
398
- # `MessageGroupId` can contain up to 128 alphanumeric characters `(a-z,
399
- # A-Z, 0-9)` and punctuation `` (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
400
- #
401
- # The `MessageGroupId` is a tag that specifies that a message belongs to
402
- # a specific message group. Messages that belong to the same message
403
- # group are processed in a FIFO manner (however, messages in different
404
- # message groups might be processed out of order). Every message must
405
- # include a `MessageGroupId`.
397
+ # The `MessageGroupId` can contain up to 128 alphanumeric characters
398
+ # `(a-z, A-Z, 0-9)` and punctuation ``
399
+ # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
400
+ #
401
+ # For FIFO topics: The `MessageGroupId` is a tag that specifies that a
402
+ # message belongs to a specific message group. Messages that belong to
403
+ # the same message group are processed in a FIFO manner (however,
404
+ # messages in different message groups might be processed out of order).
405
+ # Every message must include a `MessageGroupId`.
406
+ #
407
+ # For standard topics: The `MessageGroupId` is optional and is forwarded
408
+ # only to Amazon SQS standard subscriptions to activate [fair
409
+ # queues][1]. The `MessageGroupId` is not used for, or sent to, any
410
+ # other endpoint types. When provided, the same validation rules apply
411
+ # as for FIFO topics.
412
+ #
413
+ #
414
+ #
415
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-fair-queues.html
406
416
  # @return [Types::PublishResponse]
407
417
  def publish(options = {})
408
418
  options = options.merge(topic_arn: @arn)
@@ -442,10 +452,6 @@ module Aws::SNS
442
452
  # The following lists the names, descriptions, and values of the special
443
453
  # request parameters that the `SetTopicAttributes` action uses:
444
454
  #
445
- # * `ApplicationSuccessFeedbackRoleArn` – Indicates failed message
446
- # delivery status for an Amazon SNS topic that is subscribed to a
447
- # platform application endpoint.
448
- #
449
455
  # * `DeliveryPolicy` – The policy that defines how Amazon SNS retries
450
456
  # failed deliveries to HTTP/S endpoints.
451
457
  #
@@ -475,19 +481,19 @@ module Aws::SNS
475
481
  # * `HTTPFailureFeedbackRoleArn` – Indicates failed message delivery
476
482
  # status for an Amazon SNS topic that is subscribed to an HTTP
477
483
  # endpoint.
478
- # * Amazon Kinesis Data Firehose
484
+ # * Amazon Data Firehose
479
485
  #
480
486
  # * `FirehoseSuccessFeedbackRoleArn` – Indicates successful message
481
487
  # delivery status for an Amazon SNS topic that is subscribed to an
482
- # Amazon Kinesis Data Firehose endpoint.
488
+ # Amazon Data Firehose endpoint.
483
489
  #
484
490
  # * `FirehoseSuccessFeedbackSampleRate` – Indicates percentage of
485
491
  # successful messages to sample for an Amazon SNS topic that is
486
- # subscribed to an Amazon Kinesis Data Firehose endpoint.
492
+ # subscribed to an Amazon Data Firehose endpoint.
487
493
  #
488
494
  # * `FirehoseFailureFeedbackRoleArn` – Indicates failed message
489
495
  # delivery status for an Amazon SNS topic that is subscribed to an
490
- # Amazon Kinesis Data Firehose endpoint.
496
+ # Amazon Data Firehose endpoint.
491
497
  # * Lambda
492
498
  #
493
499
  # * `LambdaSuccessFeedbackRoleArn` – Indicates successful message
@@ -505,15 +511,15 @@ module Aws::SNS
505
511
  #
506
512
  # * `ApplicationSuccessFeedbackRoleArn` – Indicates successful message
507
513
  # delivery status for an Amazon SNS topic that is subscribed to an
508
- # Amazon Web Services application endpoint.
514
+ # platform application endpoint.
509
515
  #
510
516
  # * `ApplicationSuccessFeedbackSampleRate` – Indicates percentage of
511
517
  # successful messages to sample for an Amazon SNS topic that is
512
- # subscribed to an Amazon Web Services application endpoint.
518
+ # subscribed to an platform application endpoint.
513
519
  #
514
520
  # * `ApplicationFailureFeedbackRoleArn` – Indicates failed message
515
521
  # delivery status for an Amazon SNS topic that is subscribed to an
516
- # Amazon Web Services application endpoint.
522
+ # platform application endpoint.
517
523
  # <note markdown="1"> In addition to being able to configure topic attributes for message
518
524
  # delivery status of notification messages sent to Amazon SNS
519
525
  # application endpoints, you can also configure application attributes
@@ -651,8 +657,8 @@ module Aws::SNS
651
657
  #
652
658
  # * `lambda` – delivery of JSON-encoded message to an Lambda function
653
659
  #
654
- # * `firehose` – delivery of JSON-encoded message to an Amazon Kinesis
655
- # Data Firehose delivery stream.
660
+ # * `firehose` – delivery of JSON-encoded message to an Amazon Data
661
+ # Firehose delivery stream.
656
662
  # @option options [String] :endpoint
657
663
  # The endpoint that you want to receive notifications. Endpoints vary by
658
664
  # protocol:
@@ -680,7 +686,7 @@ module Aws::SNS
680
686
  # function.
681
687
  #
682
688
  # * For the `firehose` protocol, the endpoint is the ARN of an Amazon
683
- # Kinesis Data Firehose delivery stream.
689
+ # Data Firehose delivery stream.
684
690
  # @option options [Hash<String,String>] :attributes
685
691
  # A map of attributes with their corresponding values.
686
692
  #
@@ -354,18 +354,10 @@ module Aws::SNS
354
354
  # * `DisplayName` – The display name to use for a topic with SMS
355
355
  # subscriptions.
356
356
  #
357
- # * `FifoTopic` – Set to true to create a FIFO topic.
358
- #
359
357
  # * `Policy` – The policy that defines who can access your topic. By
360
358
  # default, only the topic owner can publish or subscribe to the
361
359
  # topic.
362
360
  #
363
- # * `SignatureVersion` – The signature version corresponds to the
364
- # hashing algorithm used while creating the signature of the
365
- # notifications, subscription confirmations, or unsubscribe
366
- # confirmation messages sent by Amazon SNS. By default,
367
- # `SignatureVersion` is set to `1`.
368
- #
369
361
  # * `TracingConfig` – Tracing mode of an Amazon SNS topic. By default
370
362
  # `TracingConfig` is set to `PassThrough`, and the topic passes
371
363
  # through the tracing header it receives from an Amazon SNS
@@ -374,16 +366,104 @@ module Aws::SNS
374
366
  # flag in the tracing header is true. This is only supported on
375
367
  # standard topics.
376
368
  #
377
- # The following attribute applies only to [server-side encryption][1]:
369
+ # * HTTP
370
+ #
371
+ # * `HTTPSuccessFeedbackRoleArn` – Indicates successful message
372
+ # delivery status for an Amazon SNS topic that is subscribed to an
373
+ # HTTP endpoint.
374
+ #
375
+ # * `HTTPSuccessFeedbackSampleRate` – Indicates percentage of
376
+ # successful messages to sample for an Amazon SNS topic that is
377
+ # subscribed to an HTTP endpoint.
378
+ #
379
+ # * `HTTPFailureFeedbackRoleArn` – Indicates failed message delivery
380
+ # status for an Amazon SNS topic that is subscribed to an HTTP
381
+ # endpoint.
382
+ # * Amazon Data Firehose
383
+ #
384
+ # * `FirehoseSuccessFeedbackRoleArn` – Indicates successful message
385
+ # delivery status for an Amazon SNS topic that is subscribed to an
386
+ # Amazon Data Firehose endpoint.
387
+ #
388
+ # * `FirehoseSuccessFeedbackSampleRate` – Indicates percentage of
389
+ # successful messages to sample for an Amazon SNS topic that is
390
+ # subscribed to an Amazon Data Firehose endpoint.
391
+ #
392
+ # * `FirehoseFailureFeedbackRoleArn` – Indicates failed message
393
+ # delivery status for an Amazon SNS topic that is subscribed to an
394
+ # Amazon Data Firehose endpoint.
395
+ # * Lambda
396
+ #
397
+ # * `LambdaSuccessFeedbackRoleArn` – Indicates successful message
398
+ # delivery status for an Amazon SNS topic that is subscribed to an
399
+ # Lambda endpoint.
400
+ #
401
+ # * `LambdaSuccessFeedbackSampleRate` – Indicates percentage of
402
+ # successful messages to sample for an Amazon SNS topic that is
403
+ # subscribed to an Lambda endpoint.
404
+ #
405
+ # * `LambdaFailureFeedbackRoleArn` – Indicates failed message
406
+ # delivery status for an Amazon SNS topic that is subscribed to an
407
+ # Lambda endpoint.
408
+ # * Platform application endpoint
409
+ #
410
+ # * `ApplicationSuccessFeedbackRoleArn` – Indicates successful
411
+ # message delivery status for an Amazon SNS topic that is
412
+ # subscribed to a platform application endpoint.
413
+ #
414
+ # * `ApplicationSuccessFeedbackSampleRate` – Indicates percentage of
415
+ # successful messages to sample for an Amazon SNS topic that is
416
+ # subscribed to an platform application endpoint.
417
+ #
418
+ # * `ApplicationFailureFeedbackRoleArn` – Indicates failed message
419
+ # delivery status for an Amazon SNS topic that is subscribed to an
420
+ # platform application endpoint.
421
+ # <note markdown="1"> In addition to being able to configure topic attributes for
422
+ # message delivery status of notification messages sent to Amazon
423
+ # SNS application endpoints, you can also configure application
424
+ # attributes for the delivery status of push notification messages
425
+ # sent to push notification services.
426
+ #
427
+ # For example, For more information, see [Using Amazon SNS
428
+ # Application Attributes for Message Delivery Status][1].
429
+ #
430
+ # </note>
431
+ #
432
+ # * Amazon SQS
433
+ #
434
+ # * `SQSSuccessFeedbackRoleArn` – Indicates successful message
435
+ # delivery status for an Amazon SNS topic that is subscribed to an
436
+ # Amazon SQS endpoint.
437
+ #
438
+ # * `SQSSuccessFeedbackSampleRate` – Indicates percentage of
439
+ # successful messages to sample for an Amazon SNS topic that is
440
+ # subscribed to an Amazon SQS endpoint.
441
+ #
442
+ # * `SQSFailureFeedbackRoleArn` – Indicates failed message delivery
443
+ # status for an Amazon SNS topic that is subscribed to an Amazon
444
+ # SQS endpoint.
445
+ #
446
+ # <note markdown="1"> The &lt;ENDPOINT&gt;SuccessFeedbackRoleArn and
447
+ # &lt;ENDPOINT&gt;FailureFeedbackRoleArn attributes are used to give
448
+ # Amazon SNS write access to use CloudWatch Logs on your behalf. The
449
+ # &lt;ENDPOINT&gt;SuccessFeedbackSampleRate attribute is for
450
+ # specifying the sample rate percentage (0-100) of successfully
451
+ # delivered messages. After you configure the
452
+ # &lt;ENDPOINT&gt;FailureFeedbackRoleArn attribute, then all failed
453
+ # message deliveries generate CloudWatch Logs.
454
+ #
455
+ # </note>
456
+ #
457
+ # The following attribute applies only to [server-side encryption][2]:
378
458
  #
379
459
  # * `KmsMasterKeyId` – The ID of an Amazon Web Services managed
380
460
  # customer master key (CMK) for Amazon SNS or a custom CMK. For more
381
- # information, see [Key Terms][2]. For more examples, see [KeyId][3]
461
+ # information, see [Key Terms][3]. For more examples, see [KeyId][4]
382
462
  # in the *Key Management Service API Reference*.
383
463
  #
384
464
  # ^
385
465
  #
386
- # The following attributes apply only to [FIFO topics][4]:
466
+ # The following attributes apply only to [FIFO topics][5]:
387
467
  #
388
468
  # * `ArchivePolicy` – The policy that sets the retention period for
389
469
  # messages stored in the message archive of an Amazon SNS FIFO
@@ -395,7 +475,7 @@ module Aws::SNS
395
475
  # * By default, `ContentBasedDeduplication` is set to `false`. If
396
476
  # you create a FIFO topic and this attribute is `false`, you must
397
477
  # specify a value for the `MessageDeduplicationId` parameter for
398
- # the [Publish][5] action.
478
+ # the [Publish][6] action.
399
479
  #
400
480
  # * When you set `ContentBasedDeduplication` to `true`, Amazon SNS
401
481
  # uses a SHA-256 hash to generate the `MessageDeduplicationId`
@@ -419,17 +499,18 @@ module Aws::SNS
419
499
  # * `MessageGroup` – The scope of deduplication is within each
420
500
  # individual message group, which enables higher throughput per
421
501
  # topic subject to regional quotas. For more information on quotas
422
- # or to request an increase, see [Amazon SNS service quotas][6] in
502
+ # or to request an increase, see [Amazon SNS service quotas][7] in
423
503
  # the Amazon Web Services General Reference.
424
504
  #
425
505
  #
426
506
  #
427
- # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
428
- # [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
429
- # [3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
430
- # [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
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
507
+ # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html
508
+ # [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
509
+ # [3]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
510
+ # [4]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
511
+ # [5]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
512
+ # [6]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
513
+ # [7]: https://docs.aws.amazon.com/general/latest/gr/sns.html
433
514
  # @return [Hash<String,String>]
434
515
  #
435
516
  # @!attribute [rw] tags
@@ -580,7 +661,7 @@ module Aws::SNS
580
661
 
581
662
  # Indicates that the number of filter polices in your Amazon Web
582
663
  # Services account exceeds the limit. To add more filter polices, submit
583
- # an Amazon SNS Limit Increase case in the Amazon Web Services Support
664
+ # an Amazon SNS Limit Increase case in the Amazon Web ServicesSupport
584
665
  # Center.
585
666
  #
586
667
  # @!attribute [rw] message
@@ -1734,7 +1815,7 @@ module Aws::SNS
1734
1815
  # that is a string.
1735
1816
  #
1736
1817
  # You can define other top-level keys that define the message you want
1737
- # to send to a specific transport protocol (e.g. http).
1818
+ # to send to a specific transport protocol (for example, http).
1738
1819
  # @return [String]
1739
1820
  #
1740
1821
  # @!attribute [rw] message_attributes
@@ -1812,27 +1893,30 @@ module Aws::SNS
1812
1893
  # @return [String]
1813
1894
  #
1814
1895
  # @!attribute [rw] message_group_id
1815
- # This parameter applies only to FIFO (first-in-first-out) topics.
1816
- #
1817
- # The tag that specifies that a message belongs to a specific message
1818
- # group. Messages that belong to the same message group are processed
1819
- # in a FIFO manner (however, messages in different message groups
1820
- # might be processed out of order). To interleave multiple ordered
1821
- # streams within a single topic, use `MessageGroupId` values (for
1822
- # example, session data for multiple users). In this scenario,
1823
- # multiple consumers can process the topic, but the session data of
1824
- # each user is processed in a FIFO fashion.
1825
- #
1826
- # You must associate a non-empty `MessageGroupId` with a message. If
1827
- # you don't provide a `MessageGroupId`, the action fails.
1896
+ # FIFO topics: The tag that specifies that a message belongs to a
1897
+ # specific message group. Messages that belong to the same message
1898
+ # group are processed in a FIFO manner (however, messages in different
1899
+ # message groups might be processed out of order). To interleave
1900
+ # multiple ordered streams within a single topic, use `MessageGroupId`
1901
+ # values (for example, session data for multiple users). In this
1902
+ # scenario, multiple consumers can process the topic, but the session
1903
+ # data of each user is processed in a FIFO fashion. You must associate
1904
+ # a non-empty `MessageGroupId` with a message. If you do not provide a
1905
+ # `MessageGroupId`, the action fails.
1906
+ #
1907
+ # Standard topics: The `MessageGroupId` is optional and is forwarded
1908
+ # only to Amazon SQS standard subscriptions to activate [fair
1909
+ # queues][1]. The `MessageGroupId` is not used for, or sent to, any
1910
+ # other endpoint types.
1828
1911
  #
1829
1912
  # The length of `MessageGroupId` is 128 characters.
1830
1913
  #
1831
1914
  # `MessageGroupId` can contain alphanumeric characters `(a-z, A-Z,
1832
1915
  # 0-9)` and punctuation `` (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
1833
1916
  #
1834
- # `MessageGroupId` is required for FIFO topics. You can't use it for
1835
- # standard topics.
1917
+ #
1918
+ #
1919
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-fair-queues.html
1836
1920
  # @return [String]
1837
1921
  #
1838
1922
  # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/PublishBatchRequestEntry AWS API Documentation
@@ -2060,16 +2144,25 @@ module Aws::SNS
2060
2144
  # @return [String]
2061
2145
  #
2062
2146
  # @!attribute [rw] message_group_id
2063
- # This parameter applies only to FIFO (first-in-first-out) topics. The
2064
- # `MessageGroupId` can contain up to 128 alphanumeric characters
2147
+ # The `MessageGroupId` can contain up to 128 alphanumeric characters
2065
2148
  # `(a-z, A-Z, 0-9)` and punctuation ``
2066
2149
  # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
2067
2150
  #
2068
- # The `MessageGroupId` is a tag that specifies that a message belongs
2069
- # to a specific message group. Messages that belong to the same
2070
- # message group are processed in a FIFO manner (however, messages in
2071
- # different message groups might be processed out of order). Every
2072
- # message must include a `MessageGroupId`.
2151
+ # For FIFO topics: The `MessageGroupId` is a tag that specifies that a
2152
+ # message belongs to a specific message group. Messages that belong to
2153
+ # the same message group are processed in a FIFO manner (however,
2154
+ # messages in different message groups might be processed out of
2155
+ # order). Every message must include a `MessageGroupId`.
2156
+ #
2157
+ # For standard topics: The `MessageGroupId` is optional and is
2158
+ # forwarded only to Amazon SQS standard subscriptions to activate
2159
+ # [fair queues][1]. The `MessageGroupId` is not used for, or sent to,
2160
+ # any other endpoint types. When provided, the same validation rules
2161
+ # apply as for FIFO topics.
2162
+ #
2163
+ #
2164
+ #
2165
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-fair-queues.html
2073
2166
  # @return [String]
2074
2167
  #
2075
2168
  # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/PublishInput AWS API Documentation
@@ -2536,10 +2629,6 @@ module Aws::SNS
2536
2629
  # special request parameters that the `SetTopicAttributes` action
2537
2630
  # uses:
2538
2631
  #
2539
- # * `ApplicationSuccessFeedbackRoleArn` – Indicates failed message
2540
- # delivery status for an Amazon SNS topic that is subscribed to a
2541
- # platform application endpoint.
2542
- #
2543
2632
  # * `DeliveryPolicy` – The policy that defines how Amazon SNS retries
2544
2633
  # failed deliveries to HTTP/S endpoints.
2545
2634
  #
@@ -2571,19 +2660,19 @@ module Aws::SNS
2571
2660
  # * `HTTPFailureFeedbackRoleArn` – Indicates failed message delivery
2572
2661
  # status for an Amazon SNS topic that is subscribed to an HTTP
2573
2662
  # endpoint.
2574
- # * Amazon Kinesis Data Firehose
2663
+ # * Amazon Data Firehose
2575
2664
  #
2576
2665
  # * `FirehoseSuccessFeedbackRoleArn` – Indicates successful message
2577
2666
  # delivery status for an Amazon SNS topic that is subscribed to an
2578
- # Amazon Kinesis Data Firehose endpoint.
2667
+ # Amazon Data Firehose endpoint.
2579
2668
  #
2580
2669
  # * `FirehoseSuccessFeedbackSampleRate` – Indicates percentage of
2581
2670
  # successful messages to sample for an Amazon SNS topic that is
2582
- # subscribed to an Amazon Kinesis Data Firehose endpoint.
2671
+ # subscribed to an Amazon Data Firehose endpoint.
2583
2672
  #
2584
2673
  # * `FirehoseFailureFeedbackRoleArn` – Indicates failed message
2585
2674
  # delivery status for an Amazon SNS topic that is subscribed to an
2586
- # Amazon Kinesis Data Firehose endpoint.
2675
+ # Amazon Data Firehose endpoint.
2587
2676
  # * Lambda
2588
2677
  #
2589
2678
  # * `LambdaSuccessFeedbackRoleArn` – Indicates successful message
@@ -2601,15 +2690,15 @@ module Aws::SNS
2601
2690
  #
2602
2691
  # * `ApplicationSuccessFeedbackRoleArn` – Indicates successful
2603
2692
  # message delivery status for an Amazon SNS topic that is
2604
- # subscribed to an Amazon Web Services application endpoint.
2693
+ # subscribed to an platform application endpoint.
2605
2694
  #
2606
2695
  # * `ApplicationSuccessFeedbackSampleRate` – Indicates percentage of
2607
2696
  # successful messages to sample for an Amazon SNS topic that is
2608
- # subscribed to an Amazon Web Services application endpoint.
2697
+ # subscribed to an platform application endpoint.
2609
2698
  #
2610
2699
  # * `ApplicationFailureFeedbackRoleArn` – Indicates failed message
2611
2700
  # delivery status for an Amazon SNS topic that is subscribed to an
2612
- # Amazon Web Services application endpoint.
2701
+ # platform application endpoint.
2613
2702
  # <note markdown="1"> In addition to being able to configure topic attributes for
2614
2703
  # message delivery status of notification messages sent to Amazon
2615
2704
  # SNS application endpoints, you can also configure application
@@ -2763,8 +2852,8 @@ module Aws::SNS
2763
2852
  #
2764
2853
  # * `lambda` – delivery of JSON-encoded message to an Lambda function
2765
2854
  #
2766
- # * `firehose` – delivery of JSON-encoded message to an Amazon Kinesis
2767
- # Data Firehose delivery stream.
2855
+ # * `firehose` – delivery of JSON-encoded message to an Amazon Data
2856
+ # Firehose delivery stream.
2768
2857
  # @return [String]
2769
2858
  #
2770
2859
  # @!attribute [rw] endpoint
@@ -2794,7 +2883,7 @@ module Aws::SNS
2794
2883
  # function.
2795
2884
  #
2796
2885
  # * For the `firehose` protocol, the endpoint is the ARN of an Amazon
2797
- # Kinesis Data Firehose delivery stream.
2886
+ # Data Firehose delivery stream.
2798
2887
  # @return [String]
2799
2888
  #
2800
2889
  # @!attribute [rw] attributes
@@ -3049,7 +3138,8 @@ module Aws::SNS
3049
3138
  include Aws::Structure
3050
3139
  end
3051
3140
 
3052
- # The batch request contains more entries than permissible.
3141
+ # The batch request contains more entries than permissible (more than
3142
+ # 10).
3053
3143
  #
3054
3144
  # @!attribute [rw] message
3055
3145
  # @return [String]
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.102.0'
61
+ GEM_VERSION = '1.104.0'
62
62
 
63
63
  end
64
64
 
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-sns
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.102.0
4
+ version: 1.104.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services