aws-sdk-sns 1.97.0 → 1.106.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +45 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-sns/client.rb +179 -80
- data/lib/aws-sdk-sns/client_api.rb +33 -33
- data/lib/aws-sdk-sns/errors.rb +0 -1
- data/lib/aws-sdk-sns/platform_endpoint.rb +19 -9
- data/lib/aws-sdk-sns/resource.rb +100 -19
- data/lib/aws-sdk-sns/topic.rb +29 -23
- data/lib/aws-sdk-sns/types.rb +148 -58
- data/lib/aws-sdk-sns.rb +1 -1
- data/sig/client.rbs +1 -0
- data/sig/resource.rbs +1 -0
- metadata +6 -9
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: fbd1c229d09558ddc8697b3549bfa1379695e39a05011ab45133bd7f6d5d8088
|
4
|
+
data.tar.gz: 950722f06a0506e1c70c519db5f5df8c00279035ec835047bf29f70da48bd7ac
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 13c8f83d06a731d4902c74b01375078c728d6aaf31df6968dfc92aaa57ce688d6b642a25a1449241ac75f6686f9f24a4fd11bb57eda616628be5b479560c489b
|
7
|
+
data.tar.gz: 1f0e28887868414ea0b65677e12d59bf7a7ed70563113938379a8b98fc962d398030dca595498c629b8361559b80fd179d213a910a3af7ffecb829849d3ac4b1
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,51 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.106.0 (2025-08-27)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Remove incorrect endpoint tests
|
8
|
+
|
9
|
+
1.105.0 (2025-08-26)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
13
|
+
|
14
|
+
1.104.0 (2025-08-04)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
18
|
+
|
19
|
+
1.103.0 (2025-08-01)
|
20
|
+
------------------
|
21
|
+
|
22
|
+
* Feature - Amazon SNS support for Amazon SQS fair queues
|
23
|
+
|
24
|
+
1.102.0 (2025-07-31)
|
25
|
+
------------------
|
26
|
+
|
27
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
28
|
+
|
29
|
+
1.101.0 (2025-07-21)
|
30
|
+
------------------
|
31
|
+
|
32
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
33
|
+
|
34
|
+
1.100.0 (2025-06-02)
|
35
|
+
------------------
|
36
|
+
|
37
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
38
|
+
|
39
|
+
1.99.0 (2025-05-12)
|
40
|
+
------------------
|
41
|
+
|
42
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
43
|
+
|
44
|
+
1.98.0 (2025-05-01)
|
45
|
+
------------------
|
46
|
+
|
47
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
48
|
+
|
4
49
|
1.97.0 (2025-03-04)
|
5
50
|
------------------
|
6
51
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.106.0
|
data/lib/aws-sdk-sns/client.rb
CHANGED
@@ -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. This can be
|
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,22 +124,24 @@ 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]`
|
130
|
+
#
|
131
131
|
# * The `:access_key_id`, `:secret_access_key`, `:session_token`, and
|
132
132
|
# `:account_id` options.
|
133
|
-
#
|
134
|
-
#
|
133
|
+
#
|
134
|
+
# * `ENV['AWS_ACCESS_KEY_ID']`, `ENV['AWS_SECRET_ACCESS_KEY']`,
|
135
|
+
# `ENV['AWS_SESSION_TOKEN']`, and `ENV['AWS_ACCOUNT_ID']`.
|
136
|
+
#
|
135
137
|
# * `~/.aws/credentials`
|
138
|
+
#
|
136
139
|
# * `~/.aws/config`
|
137
|
-
#
|
138
|
-
#
|
139
|
-
# `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
|
140
|
-
# enable retries and extended timeouts. Instance profile credential
|
141
|
-
#
|
142
|
-
# to true.
|
140
|
+
#
|
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`.
|
143
145
|
#
|
144
146
|
# @option options [required, String] :region
|
145
147
|
# The AWS region to connect to. The configured `:region` is
|
@@ -167,6 +169,11 @@ module Aws::SNS
|
|
167
169
|
# When false, the request will raise a `RetryCapacityNotAvailableError` and will
|
168
170
|
# not retry instead of sleeping.
|
169
171
|
#
|
172
|
+
# @option options [Array<String>] :auth_scheme_preference
|
173
|
+
# A list of preferred authentication schemes to use when making a request. Supported values are:
|
174
|
+
# `sigv4`, `sigv4a`, `httpBearerAuth`, and `noAuth`. When set using `ENV['AWS_AUTH_SCHEME_PREFERENCE']` or in
|
175
|
+
# shared config as `auth_scheme_preference`, the value should be a comma-separated list.
|
176
|
+
#
|
170
177
|
# @option options [Boolean] :client_side_monitoring (false)
|
171
178
|
# When `true`, client-side metrics will be collected for all API requests from
|
172
179
|
# this client.
|
@@ -200,8 +207,7 @@ module Aws::SNS
|
|
200
207
|
# accepted modes and the configuration defaults that are included.
|
201
208
|
#
|
202
209
|
# @option options [Boolean] :disable_host_prefix_injection (false)
|
203
|
-
#
|
204
|
-
# to default service endpoint when available.
|
210
|
+
# When `true`, the SDK will not prepend the modeled host prefix to the endpoint.
|
205
211
|
#
|
206
212
|
# @option options [Boolean] :disable_request_compression (false)
|
207
213
|
# When set to 'true' the request body will not be compressed
|
@@ -254,8 +260,8 @@ module Aws::SNS
|
|
254
260
|
# 4 times. Used in `standard` and `adaptive` retry modes.
|
255
261
|
#
|
256
262
|
# @option options [String] :profile ("default")
|
257
|
-
# Used when loading credentials from the shared credentials file
|
258
|
-
#
|
263
|
+
# Used when loading credentials from the shared credentials file at `HOME/.aws/credentials`.
|
264
|
+
# When not specified, 'default' is used.
|
259
265
|
#
|
260
266
|
# @option options [String] :request_checksum_calculation ("when_supported")
|
261
267
|
# Determines when a checksum will be calculated for request payloads. Values are:
|
@@ -368,8 +374,8 @@ module Aws::SNS
|
|
368
374
|
# `Aws::Telemetry::OTelProvider` for telemetry provider.
|
369
375
|
#
|
370
376
|
# @option options [Aws::TokenProvider] :token_provider
|
371
|
-
#
|
372
|
-
# 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:
|
373
379
|
#
|
374
380
|
# * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
|
375
381
|
# tokens.
|
@@ -622,10 +628,11 @@ module Aws::SNS
|
|
622
628
|
#
|
623
629
|
# * For GCM (Firebase Cloud Messaging) using token credentials, there is
|
624
630
|
# no `PlatformPrincipal`. The `PlatformCredential` is a JSON formatted
|
625
|
-
# private key file. When using the Amazon Web Services CLI
|
626
|
-
# must be in string format and special
|
627
|
-
# format the file correctly, Amazon SNS
|
628
|
-
# command:
|
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)`.
|
629
636
|
#
|
630
637
|
# * For MPNS, `PlatformPrincipal` is `TLS certificate` and
|
631
638
|
# `PlatformCredential` is `private key`.
|
@@ -831,17 +838,9 @@ module Aws::SNS
|
|
831
838
|
# * `DisplayName` – The display name to use for a topic with SMS
|
832
839
|
# subscriptions.
|
833
840
|
#
|
834
|
-
# * `FifoTopic` – Set to true to create a FIFO topic.
|
835
|
-
#
|
836
841
|
# * `Policy` – The policy that defines who can access your topic. By
|
837
842
|
# default, only the topic owner can publish or subscribe to the topic.
|
838
843
|
#
|
839
|
-
# * `SignatureVersion` – The signature version corresponds to the
|
840
|
-
# hashing algorithm used while creating the signature of the
|
841
|
-
# notifications, subscription confirmations, or unsubscribe
|
842
|
-
# confirmation messages sent by Amazon SNS. By default,
|
843
|
-
# `SignatureVersion` is set to `1`.
|
844
|
-
#
|
845
844
|
# * `TracingConfig` – Tracing mode of an Amazon SNS topic. By default
|
846
845
|
# `TracingConfig` is set to `PassThrough`, and the topic passes
|
847
846
|
# through the tracing header it receives from an Amazon SNS publisher
|
@@ -849,16 +848,104 @@ module Aws::SNS
|
|
849
848
|
# segment data to topic owner account if the sampled flag in the
|
850
849
|
# tracing header is true. This is only supported on standard topics.
|
851
850
|
#
|
852
|
-
#
|
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 <ENDPOINT>SuccessFeedbackRoleArn and
|
929
|
+
# <ENDPOINT>FailureFeedbackRoleArn attributes are used to give
|
930
|
+
# Amazon SNS write access to use CloudWatch Logs on your behalf. The
|
931
|
+
# <ENDPOINT>SuccessFeedbackSampleRate attribute is for specifying
|
932
|
+
# the sample rate percentage (0-100) of successfully delivered messages.
|
933
|
+
# After you configure the <ENDPOINT>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]:
|
853
940
|
#
|
854
941
|
# * `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer
|
855
942
|
# master key (CMK) for Amazon SNS or a custom CMK. For more
|
856
|
-
# information, see [Key Terms][
|
943
|
+
# information, see [Key Terms][3]. For more examples, see [KeyId][4]
|
857
944
|
# in the *Key Management Service API Reference*.
|
858
945
|
#
|
859
946
|
# ^
|
860
947
|
#
|
861
|
-
# The following attributes apply only to [FIFO topics][
|
948
|
+
# The following attributes apply only to [FIFO topics][5]:
|
862
949
|
#
|
863
950
|
# * `ArchivePolicy` – The policy that sets the retention period for
|
864
951
|
# messages stored in the message archive of an Amazon SNS FIFO topic.
|
@@ -869,7 +956,7 @@ module Aws::SNS
|
|
869
956
|
# * By default, `ContentBasedDeduplication` is set to `false`. If you
|
870
957
|
# create a FIFO topic and this attribute is `false`, you must
|
871
958
|
# specify a value for the `MessageDeduplicationId` parameter for the
|
872
|
-
# [Publish][
|
959
|
+
# [Publish][6] action.
|
873
960
|
#
|
874
961
|
# * When you set `ContentBasedDeduplication` to `true`, Amazon SNS
|
875
962
|
# uses a SHA-256 hash to generate the `MessageDeduplicationId` using
|
@@ -892,17 +979,18 @@ module Aws::SNS
|
|
892
979
|
# * `MessageGroup` – The scope of deduplication is within each
|
893
980
|
# individual message group, which enables higher throughput per
|
894
981
|
# topic subject to regional quotas. For more information on quotas
|
895
|
-
# or to request an increase, see [Amazon SNS service quotas][
|
982
|
+
# or to request an increase, see [Amazon SNS service quotas][7] in
|
896
983
|
# the Amazon Web Services General Reference.
|
897
984
|
#
|
898
985
|
#
|
899
986
|
#
|
900
|
-
# [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-
|
901
|
-
# [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
|
902
|
-
# [3]: https://docs.aws.amazon.com/
|
903
|
-
# [4]: https://docs.aws.amazon.com/
|
904
|
-
# [5]: https://docs.aws.amazon.com/sns/latest/
|
905
|
-
# [6]: https://docs.aws.amazon.com/
|
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
|
906
994
|
#
|
907
995
|
# @option params [Array<Types::Tag>] :tags
|
908
996
|
# The list of tags to add to a new topic.
|
@@ -1940,15 +2028,25 @@ module Aws::SNS
|
|
1940
2028
|
# scope and interval, and only one copy of the message is delivered.
|
1941
2029
|
#
|
1942
2030
|
# @option params [String] :message_group_id
|
1943
|
-
#
|
1944
|
-
# `
|
1945
|
-
#
|
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.
|
1946
2046
|
#
|
1947
|
-
#
|
1948
|
-
#
|
1949
|
-
#
|
1950
|
-
# message groups might be processed out of order). Every message must
|
1951
|
-
# include a `MessageGroupId`.
|
2047
|
+
#
|
2048
|
+
#
|
2049
|
+
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-fair-queues.html
|
1952
2050
|
#
|
1953
2051
|
# @return [Types::PublishResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1954
2052
|
#
|
@@ -1989,34 +2087,45 @@ module Aws::SNS
|
|
1989
2087
|
req.send_request(options)
|
1990
2088
|
end
|
1991
2089
|
|
1992
|
-
# Publishes up to
|
1993
|
-
# version of `Publish
|
1994
|
-
#
|
1995
|
-
#
|
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.
|
1996
2098
|
#
|
1997
2099
|
# The result of publishing each message is reported individually in the
|
1998
2100
|
# response. Because the batch request can result in a combination of
|
1999
2101
|
# successful and unsuccessful actions, you should check for batch errors
|
2000
|
-
# even when the call returns an HTTP status code of
|
2102
|
+
# even when the call returns an HTTP status code of 200.
|
2001
2103
|
#
|
2002
2104
|
# The maximum allowed individual message size and the maximum total
|
2003
2105
|
# payload size (the sum of the individual lengths of all of the batched
|
2004
2106
|
# messages) are both 256 KB (262,144 bytes).
|
2005
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
|
+
#
|
2006
2114
|
# Some actions take lists of parameters. These lists are specified using
|
2007
|
-
# the `param.n` notation. Values of `n` are integers starting from
|
2008
|
-
# For example, a parameter list with two elements looks like
|
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:
|
2009
2118
|
#
|
2010
|
-
#
|
2119
|
+
# `&AttributeName.1=first`
|
2011
2120
|
#
|
2012
|
-
#
|
2121
|
+
# `&AttributeName.2=second`
|
2013
2122
|
#
|
2014
2123
|
# If you send a batch message to a topic, Amazon SNS publishes the batch
|
2015
2124
|
# message to each endpoint that is subscribed to the topic. The format
|
2016
2125
|
# of the batch message depends on the notification protocol for each
|
2017
2126
|
# subscribed endpoint.
|
2018
2127
|
#
|
2019
|
-
# 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
|
2020
2129
|
# SNS immediately delivers the message to subscribers.
|
2021
2130
|
#
|
2022
2131
|
# @option params [required, String] :topic_arn
|
@@ -2521,10 +2630,6 @@ module Aws::SNS
|
|
2521
2630
|
# The following lists the names, descriptions, and values of the special
|
2522
2631
|
# request parameters that the `SetTopicAttributes` action uses:
|
2523
2632
|
#
|
2524
|
-
# * `ApplicationSuccessFeedbackRoleArn` – Indicates failed message
|
2525
|
-
# delivery status for an Amazon SNS topic that is subscribed to a
|
2526
|
-
# platform application endpoint.
|
2527
|
-
#
|
2528
2633
|
# * `DeliveryPolicy` – The policy that defines how Amazon SNS retries
|
2529
2634
|
# failed deliveries to HTTP/S endpoints.
|
2530
2635
|
#
|
@@ -2554,19 +2659,19 @@ module Aws::SNS
|
|
2554
2659
|
# * `HTTPFailureFeedbackRoleArn` – Indicates failed message delivery
|
2555
2660
|
# status for an Amazon SNS topic that is subscribed to an HTTP
|
2556
2661
|
# endpoint.
|
2557
|
-
# * Amazon
|
2662
|
+
# * Amazon Data Firehose
|
2558
2663
|
#
|
2559
2664
|
# * `FirehoseSuccessFeedbackRoleArn` – Indicates successful message
|
2560
2665
|
# delivery status for an Amazon SNS topic that is subscribed to an
|
2561
|
-
# Amazon
|
2666
|
+
# Amazon Data Firehose endpoint.
|
2562
2667
|
#
|
2563
2668
|
# * `FirehoseSuccessFeedbackSampleRate` – Indicates percentage of
|
2564
2669
|
# successful messages to sample for an Amazon SNS topic that is
|
2565
|
-
# subscribed to an Amazon
|
2670
|
+
# subscribed to an Amazon Data Firehose endpoint.
|
2566
2671
|
#
|
2567
2672
|
# * `FirehoseFailureFeedbackRoleArn` – Indicates failed message
|
2568
2673
|
# delivery status for an Amazon SNS topic that is subscribed to an
|
2569
|
-
# Amazon
|
2674
|
+
# Amazon Data Firehose endpoint.
|
2570
2675
|
# * Lambda
|
2571
2676
|
#
|
2572
2677
|
# * `LambdaSuccessFeedbackRoleArn` – Indicates successful message
|
@@ -2584,15 +2689,15 @@ module Aws::SNS
|
|
2584
2689
|
#
|
2585
2690
|
# * `ApplicationSuccessFeedbackRoleArn` – Indicates successful message
|
2586
2691
|
# delivery status for an Amazon SNS topic that is subscribed to an
|
2587
|
-
#
|
2692
|
+
# platform application endpoint.
|
2588
2693
|
#
|
2589
2694
|
# * `ApplicationSuccessFeedbackSampleRate` – Indicates percentage of
|
2590
2695
|
# successful messages to sample for an Amazon SNS topic that is
|
2591
|
-
# subscribed to an
|
2696
|
+
# subscribed to an platform application endpoint.
|
2592
2697
|
#
|
2593
2698
|
# * `ApplicationFailureFeedbackRoleArn` – Indicates failed message
|
2594
2699
|
# delivery status for an Amazon SNS topic that is subscribed to an
|
2595
|
-
#
|
2700
|
+
# platform application endpoint.
|
2596
2701
|
# <note markdown="1"> In addition to being able to configure topic attributes for message
|
2597
2702
|
# delivery status of notification messages sent to Amazon SNS
|
2598
2703
|
# application endpoints, you can also configure application attributes
|
@@ -2744,8 +2849,8 @@ module Aws::SNS
|
|
2744
2849
|
#
|
2745
2850
|
# * `lambda` – delivery of JSON-encoded message to an Lambda function
|
2746
2851
|
#
|
2747
|
-
# * `firehose` – delivery of JSON-encoded message to an Amazon
|
2748
|
-
#
|
2852
|
+
# * `firehose` – delivery of JSON-encoded message to an Amazon Data
|
2853
|
+
# Firehose delivery stream.
|
2749
2854
|
#
|
2750
2855
|
# @option params [String] :endpoint
|
2751
2856
|
# The endpoint that you want to receive notifications. Endpoints vary by
|
@@ -2774,7 +2879,7 @@ module Aws::SNS
|
|
2774
2879
|
# function.
|
2775
2880
|
#
|
2776
2881
|
# * For the `firehose` protocol, the endpoint is the ARN of an Amazon
|
2777
|
-
#
|
2882
|
+
# Data Firehose delivery stream.
|
2778
2883
|
#
|
2779
2884
|
# @option params [Hash<String,String>] :attributes
|
2780
2885
|
# A map of attributes with their corresponding values.
|
@@ -2953,12 +3058,6 @@ module Aws::SNS
|
|
2953
3058
|
# is delivered to the endpoint, so that the endpoint owner can easily
|
2954
3059
|
# resubscribe to the topic if the `Unsubscribe` request was unintended.
|
2955
3060
|
#
|
2956
|
-
# <note markdown="1"> Amazon SQS queue subscriptions require authentication for deletion.
|
2957
|
-
# Only the owner of the subscription, or the owner of the topic can
|
2958
|
-
# unsubscribe using the required Amazon Web Services signature.
|
2959
|
-
#
|
2960
|
-
# </note>
|
2961
|
-
#
|
2962
3061
|
# This action is throttled at 100 transactions per second (TPS).
|
2963
3062
|
#
|
2964
3063
|
# @option params [required, String] :subscription_arn
|
@@ -3072,7 +3171,7 @@ module Aws::SNS
|
|
3072
3171
|
tracer: tracer
|
3073
3172
|
)
|
3074
3173
|
context[:gem_name] = 'aws-sdk-sns'
|
3075
|
-
context[:gem_version] = '1.
|
3174
|
+
context[:gem_version] = '1.106.0'
|
3076
3175
|
Seahorse::Client::Request.new(handlers, context)
|
3077
3176
|
end
|
3078
3177
|
|