aws-sdk-sns 1.19.0 → 1.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 5ae8a241c7827e91349db30712ef288306b2f0c0
-  data.tar.gz: bb512a9193dbd1e98e379c0355ce2904073fe8f7
+SHA256:
+  metadata.gz: 2c10fcf0aede9daa7ffc180be99eaf42df30d9e84eafd433d7086fe0df20ee55
+  data.tar.gz: 559f957645a9f665aaae3b0086178988660ae7b888ba6ff9d13c2f9032d75d5b
 SHA512:
-  metadata.gz: 9582f5eef312e7feb602b740898d6ef10eb9d600e3728a605d4fabe6c203ce6ba20a5c843b1e0d3eb8c095956990fa9986d8aaf8d1b97e75cc4a4be53c17d770
-  data.tar.gz: e39026bfb6245fdd0d718835388ce86fd172d7bd6f0d50a9a5303d1f80061b7c9e14e51684f798b12fc156b5ae3584832cbb0e7eb47205b5caafe953c3642ad6
+  metadata.gz: 239b22483640c1010548455dbc3f75b40b9e7437d78037e02e268a4a57fb6715b5101e927566a3f4332c8b03599041b2fe1553e82e6704c47c5965f0658d4945
+  data.tar.gz: 3be3aeb8100bf20c094895732d5b4745b50d44c74f882779faf04733e624394eb9a45beb33d89e41df3c212aabf32ac12ee688473e6d8692c81d33419db43da4

data/lib/aws-sdk-sns.rb

@@ -28,17 +28,20 @@ require_relative 'aws-sdk-sns/customizations'
 # methods each accept a hash of request parameters and return a response
 # structure.
 #
+#     sns = Aws::SNS::Client.new
+#     resp = sns.add_permission(params)
+#
 # See {Client} for more information.
 #
 # # Errors
 #
-# Errors returned from Amazon Simple Notification Service all
-# extend {Errors::ServiceError}.
+# Errors returned from Amazon Simple Notification Service are defined in the
+# {Errors} module and all extend {Errors::ServiceError}.
 #
 #     begin
 #       # do stuff
 #     rescue Aws::SNS::Errors::ServiceError
-#       # rescues all service API errors
+#       # rescues all Amazon Simple Notification Service API errors
 #     end
 #
 # See {Errors} for more information.
@@ -46,6 +49,6 @@ require_relative 'aws-sdk-sns/customizations'
 # @service
 module Aws::SNS
 
-  GEM_VERSION = '1.19.0'
+  GEM_VERSION = '1.24.0'
 
 end

data/lib/aws-sdk-sns/client.rb

@@ -30,6 +30,18 @@ require 'aws-sdk-core/plugins/protocols/query.rb'
 Aws::Plugins::GlobalConfiguration.add_identifier(:sns)
 
 module Aws::SNS
+  # An API client for SNS.  To construct a client, you need to configure a `:region` and `:credentials`.
+  #
+  #     client = Aws::SNS::Client.new(
+  #       region: region_name,
+  #       credentials: credentials,
+  #       # ...
+  #     )
+  #
+  # For details on configuring region and credentials see
+  # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
+  #
+  # See {#initialize} for a full list of supported configuration options.
   class Client < Seahorse::Client::Base
 
     include Aws::ClientStubs
@@ -93,7 +105,7 @@ module Aws::SNS
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
     #     used to determine the service `:endpoint`. When not passed,
-    #     a default `:region` is search for in the following locations:
+    #     a default `:region` is searched for in the following locations:
     #
     #     * `Aws.config[:region]`
     #     * `ENV['AWS_REGION']`
@@ -108,6 +120,12 @@ module Aws::SNS
     #     When set to `true`, a thread polling for endpoints will be running in
     #     the background every 60 secs (default). Defaults to `false`.
     #
+    #   @option options [Boolean] :adaptive_retry_wait_to_fill (true)
+    #     Used only in `adaptive` retry mode.  When true, the request will sleep
+    #     until there is sufficent client side capacity to retry the request.
+    #     When false, the request will raise a `RetryCapacityNotAvailableError` and will
+    #     not retry instead of sleeping.
+    #
     #   @option options [Boolean] :client_side_monitoring (false)
     #     When `true`, client-side metrics will be collected for all API requests from
     #     this client.
@@ -132,6 +150,10 @@ module Aws::SNS
     #     When `true`, an attempt is made to coerce request parameters into
     #     the required types.
     #
+    #   @option options [Boolean] :correct_clock_skew (true)
+    #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
+    #     a clock skew correction and retry requests with skewed client clocks.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -139,7 +161,7 @@ module Aws::SNS
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be avalid HTTP(S) URI.
+    #     to test endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -154,7 +176,7 @@ module Aws::SNS
     #     requests fetching endpoints information. Defaults to 60 sec.
     #
     #   @option options [Boolean] :endpoint_discovery (false)
-    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
@@ -166,15 +188,29 @@ module Aws::SNS
     #     The Logger instance to send log messages to.  If this option
     #     is not set, logging will be disabled.
     #
+    #   @option options [Integer] :max_attempts (3)
+    #     An integer representing the maximum number attempts that will be made for
+    #     a single request, including the initial attempt.  For example,
+    #     setting this value to 5 will result in a request being retried up to
+    #     4 times. Used in `standard` and `adaptive` retry modes.
+    #
     #   @option options [String] :profile ("default")
     #     Used when loading credentials from the shared credentials file
     #     at HOME/.aws/credentials.  When not specified, 'default' is used.
     #
+    #   @option options [Proc] :retry_backoff
+    #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
+    #     This option is only used in the `legacy` retry mode.
+    #
     #   @option options [Float] :retry_base_delay (0.3)
-    #     The base delay in seconds used by the default backoff function.
+    #     The base delay in seconds used by the default backoff function. This option
+    #     is only used in the `legacy` retry mode.
     #
     #   @option options [Symbol] :retry_jitter (:none)
-    #     A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.
+    #     A delay randomiser function used by the default backoff function.
+    #     Some predefined functions can be referenced by name - :none, :equal, :full,
+    #     otherwise a Proc that takes and returns a number. This option is only used
+    #     in the `legacy` retry mode.
     #
     #     @see https://www.awsarchitectureblog.com/2015/03/backoff.html
     #
@@ -182,11 +218,30 @@ module Aws::SNS
     #     The maximum number of times to retry failed requests.  Only
     #     ~ 500 level server errors and certain ~ 400 level client errors
     #     are retried.  Generally, these are throttling errors, data
-    #     checksum errors, networking errors, timeout errors and auth
-    #     errors from expired credentials.
+    #     checksum errors, networking errors, timeout errors, auth errors,
+    #     endpoint discovery, and errors from expired credentials.
+    #     This option is only used in the `legacy` retry mode.
     #
     #   @option options [Integer] :retry_max_delay (0)
-    #     The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
+    #     The maximum number of seconds to delay between retries (0 for no limit)
+    #     used by the default backoff function. This option is only used in the
+    #     `legacy` retry mode.
+    #
+    #   @option options [String] :retry_mode ("legacy")
+    #     Specifies which retry algorithm to use. Values are:
+    #
+    #     * `legacy` - The pre-existing retry behavior.  This is default value if
+    #       no retry mode is provided.
+    #
+    #     * `standard` - A standardized set of retry rules across the AWS SDKs.
+    #       This includes support for retry quotas, which limit the number of
+    #       unsuccessful retries a client can make.
+    #
+    #     * `adaptive` - An experimental retry mode that includes all the
+    #       functionality of `standard` mode along with automatic client side
+    #       throttling.  This is a provisional mode that may change behavior
+    #       in the future.
+    #
     #
     #   @option options [String] :secret_access_key
     #
@@ -209,16 +264,15 @@ module Aws::SNS
     #     requests through.  Formatted like 'http://proxy.com:123'.
     #
     #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before rasing a
+    #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
     #   @option options [Integer] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
-    #     safely be set
-    #     per-request on the session yeidled by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idble before it is
+    #     seconds a connection is allowed to sit idle before it is
     #     considered stale.  Stale connections are closed and removed
     #     from the pool before making a request.
     #
@@ -227,7 +281,7 @@ module Aws::SNS
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yeidled by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -271,7 +325,7 @@ module Aws::SNS
     # @option params [required, Array<String>] :action_name
     #   The action you want to allow for the specified principal(s).
     #
-    #   Valid values: any Amazon SNS action name.
+    #   Valid values: Any Amazon SNS action name, for example `Publish`.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -376,7 +430,7 @@ module Aws::SNS
     # PlatformCredential attributes when using the
     # `CreatePlatformApplication` action. The PlatformPrincipal is received
     # from the notification service. For APNS/APNS\_SANDBOX,
-    # PlatformPrincipal is "SSL certificate". For GCM, PlatformPrincipal
+    # PlatformPrincipal is "SSL certificate". For FCM, PlatformPrincipal
     # is not applicable. For ADM, PlatformPrincipal is "client id". The
     # PlatformCredential is also received from the notification service. For
     # WNS, PlatformPrincipal is "Package Security Identifier". For MPNS,
@@ -384,30 +438,12 @@ module Aws::SNS
     # is "API key".
     #
     # For APNS/APNS\_SANDBOX, PlatformCredential is "private key". For
-    # GCM, PlatformCredential is "API key". For ADM, PlatformCredential is
+    # FCM, PlatformCredential is "API key". For ADM, PlatformCredential is
     # "client secret". For WNS, PlatformCredential is "secret key". For
     # MPNS, PlatformCredential is "private key". For Baidu,
     # PlatformCredential is "secret key". The PlatformApplicationArn that
     # is returned when using `CreatePlatformApplication` is then used as an
-    # attribute for the `CreatePlatformEndpoint` action. For more
-    # information, see [Using Amazon SNS Mobile Push Notifications][1]. For
-    # more information about obtaining the PlatformPrincipal and
-    # PlatformCredential for each of the supported push notification
-    # services, see [Getting Started with Apple Push Notification
-    # Service][2], [Getting Started with Amazon Device Messaging][3],
-    # [Getting Started with Baidu Cloud Push][4], [Getting Started with
-    # Google Cloud Messaging for Android][5], [Getting Started with
-    # MPNS][6], or [Getting Started with WNS][7].
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/sns/latest/dg/SNSMobilePush.html
-    # [2]: https://docs.aws.amazon.com/sns/latest/dg/mobile-push-apns.html
-    # [3]: https://docs.aws.amazon.com/sns/latest/dg/mobile-push-adm.html
-    # [4]: https://docs.aws.amazon.com/sns/latest/dg/mobile-push-baidu.html
-    # [5]: https://docs.aws.amazon.com/sns/latest/dg/mobile-push-gcm.html
-    # [6]: https://docs.aws.amazon.com/sns/latest/dg/mobile-push-mpns.html
-    # [7]: https://docs.aws.amazon.com/sns/latest/dg/mobile-push-wns.html
+    # attribute for the `CreatePlatformEndpoint` action.
     #
     # @option params [required, String] :name
     #   Application names must be made up of only uppercase and lowercase
@@ -416,8 +452,8 @@ module Aws::SNS
     #
     # @option params [required, String] :platform
     #   The following platforms are supported: ADM (Amazon Device Messaging),
-    #   APNS (Apple Push Notification Service), APNS\_SANDBOX, and GCM (Google
-    #   Cloud Messaging).
+    #   APNS (Apple Push Notification Service), APNS\_SANDBOX, and FCM
+    #   (Firebase Cloud Messaging).
     #
     # @option params [required, Hash<String,String>] :attributes
     #   For a list of attributes, see [SetPlatformApplicationAttributes][1]
@@ -454,7 +490,7 @@ module Aws::SNS
     end
 
     # Creates an endpoint for a device and mobile app on one of the
-    # supported push notification services, such as GCM and APNS.
+    # supported push notification services, such as FCM and APNS.
     # `CreatePlatformEndpoint` requires the PlatformApplicationArn that is
     # returned from `CreatePlatformApplication`. The EndpointArn that is
     # returned when using `CreatePlatformEndpoint` can then be used by the
@@ -484,7 +520,7 @@ module Aws::SNS
     #   device. The specific name for Token will vary, depending on which
     #   notification service is being used. For example, when using APNS as
     #   the notification service, you need the device token. Alternatively,
-    #   when using GCM or ADM, the device token equivalent is called the
+    #   when using FCM or ADM, the device token equivalent is called the
     #   registration ID.
     #
     # @option params [String] :custom_user_data
@@ -576,6 +612,11 @@ module Aws::SNS
     # @option params [Array<Types::Tag>] :tags
     #   The list of tags to add to a new topic.
     #
+    #   <note markdown="1"> To be able to tag a topic on creation, you must have the
+    #   `sns:CreateTopic` and `sns:TagResource` permissions.
+    #
+    #    </note>
+    #
     # @return [Types::CreateTopicResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateTopicResponse#topic_arn #topic_arn} => String
@@ -640,7 +681,7 @@ module Aws::SNS
     end
 
     # Deletes a platform application object for one of the supported push
-    # notification services, such as APNS and GCM. For more information, see
+    # notification services, such as APNS and FCM. For more information, see
     # [Using Amazon SNS Mobile Push Notifications][1].
     #
     #
@@ -693,7 +734,7 @@ module Aws::SNS
     end
 
     # Retrieves the endpoint attributes for a device on one of the supported
-    # push notification services, such as GCM and APNS. For more
+    # push notification services, such as FCM and APNS. For more
     # information, see [Using Amazon SNS Mobile Push Notifications][1].
     #
     #
@@ -728,7 +769,7 @@ module Aws::SNS
     end
 
     # Retrieves the attributes of the platform application object for the
-    # supported push notification services, such as APNS and GCM. For more
+    # supported push notification services, such as APNS and FCM. For more
     # information, see [Using Amazon SNS Mobile Push Notifications][1].
     #
     #
@@ -863,7 +904,7 @@ module Aws::SNS
     end
 
     # Lists the endpoints and endpoint attributes for devices in a supported
-    # push notification service, such as GCM and APNS. The results for
+    # push notification service, such as FCM and APNS. The results for
     # `ListEndpointsByPlatformApplication` are paginated and return a
     # limited list of endpoints, up to 100. If additional records are
     # available after the first page results, then a NextToken string will
@@ -893,6 +934,8 @@ module Aws::SNS
     #   * {Types::ListEndpointsByPlatformApplicationResponse#endpoints #endpoints} => Array&lt;Types::Endpoint&gt;
     #   * {Types::ListEndpointsByPlatformApplicationResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_endpoints_by_platform_application({
@@ -960,7 +1003,7 @@ module Aws::SNS
     end
 
     # Lists the platform application objects for the supported push
-    # notification services, such as APNS and GCM. The results for
+    # notification services, such as APNS and FCM. The results for
     # `ListPlatformApplications` are paginated and return a limited list of
     # applications, up to 100. If additional records are available after the
     # first page results, then a NextToken string will be returned. To
@@ -985,6 +1028,8 @@ module Aws::SNS
     #   * {Types::ListPlatformApplicationsResponse#platform_applications #platform_applications} => Array&lt;Types::PlatformApplication&gt;
     #   * {Types::ListPlatformApplicationsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_platform_applications({
@@ -1023,6 +1068,8 @@ module Aws::SNS
     #   * {Types::ListSubscriptionsResponse#subscriptions #subscriptions} => Array&lt;Types::Subscription&gt;
     #   * {Types::ListSubscriptionsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_subscriptions({
@@ -1067,6 +1114,8 @@ module Aws::SNS
     #   * {Types::ListSubscriptionsByTopicResponse#subscriptions #subscriptions} => Array&lt;Types::Subscription&gt;
     #   * {Types::ListSubscriptionsByTopicResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_subscriptions_by_topic({
@@ -1144,6 +1193,8 @@ module Aws::SNS
     #   * {Types::ListTopicsResponse#topics #topics} => Array&lt;Types::Topic&gt;
     #   * {Types::ListTopicsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_topics({
@@ -1234,10 +1285,6 @@ module Aws::SNS
     # @option params [required, String] :message
     #   The message you want to send.
     #
-    #   The `Message` parameter is always a string. If you set
-    #   `MessageStructure` to `json`, you must string-encode the `Message`
-    #   parameter.
-    #
     #   If you are publishing to a topic and you want to send the same message
     #   to all transport protocols, include the text of the message as a
     #   String value. If you want to send different messages for each
@@ -1315,17 +1362,8 @@ module Aws::SNS
     #   You can define other top-level keys that define the message you want
     #   to send to a specific transport protocol (e.g., "http").
     #
-    #   For information about sending different messages for each protocol
-    #   using the AWS Management Console, go to [Create Different Messages for
-    #   Each Protocol][1] in the *Amazon Simple Notification Service Getting
-    #   Started Guide*.
-    #
     #   Valid value: `json`
     #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/sns/latest/gsg/Publish.html#sns-message-formatting-by-protocol
-    #
     # @option params [Hash<String,Types::MessageAttributeValue>] :message_attributes
     #   Message attributes for Publish action.
     #
@@ -1391,7 +1429,7 @@ module Aws::SNS
     end
 
     # Sets the attributes for an endpoint for a device on one of the
-    # supported push notification services, such as GCM and APNS. For more
+    # supported push notification services, such as FCM and APNS. For more
     # information, see [Using Amazon SNS Mobile Push Notifications][1].
     #
     #
@@ -1440,7 +1478,7 @@ module Aws::SNS
     end
 
     # Sets the attributes of the platform application object for the
-    # supported push notification services, such as APNS and GCM. For more
+    # supported push notification services, such as APNS and FCM. For more
     # information, see [Using Amazon SNS Mobile Push Notifications][1]. For
     # information on configuring attributes for message delivery status, see
     # [Using Amazon SNS Application Attributes for Message Delivery
@@ -1460,12 +1498,12 @@ module Aws::SNS
     #
     #   * `PlatformCredential` – The credential received from the notification
     #     service. For APNS/APNS\_SANDBOX, PlatformCredential is private key.
-    #     For GCM, PlatformCredential is "API key". For ADM,
+    #     For FCM, PlatformCredential is "API key". For ADM,
     #     PlatformCredential is "client secret".
     #
     #   * `PlatformPrincipal` – The principal received from the notification
     #     service. For APNS/APNS\_SANDBOX, PlatformPrincipal is SSL
-    #     certificate. For GCM, PlatformPrincipal is not applicable. For ADM,
+    #     certificate. For FCM, PlatformPrincipal is not applicable. For ADM,
     #     PlatformPrincipal is "client id".
     #
     #   * `EventEndpointCreated` – Topic ARN to which EndpointCreated event
@@ -1649,6 +1687,13 @@ module Aws::SNS
     #     for the endpoints to process JSON formatting, which is otherwise
     #     created for Amazon SNS metadata.
     #
+    #   * `RedrivePolicy` – When specified, sends undeliverable messages to
+    #     the specified Amazon SQS dead-letter queue. Messages that can't be
+    #     delivered due to client errors (for example, when the subscribed
+    #     endpoint is unreachable) or server errors (for example, when the
+    #     service that powers the subscribed endpoint becomes unavailable) are
+    #     held in the dead-letter queue for further analysis or reprocessing.
+    #
     # @option params [String] :attribute_value
     #   The new value for the attribute in JSON format.
     #
@@ -1757,7 +1802,7 @@ module Aws::SNS
     #   * `application` – delivery of JSON-encoded message to an EndpointArn
     #     for a mobile app and device.
     #
-    #   * `lambda` – delivery of JSON-encoded message to an AWS Lambda
+    #   * `lambda` – delivery of JSON-encoded message to an Amazon Lambda
     #     function.
     #
     # @option params [String] :endpoint
@@ -1765,10 +1810,10 @@ module Aws::SNS
     #   protocol:
     #
     #   * For the `http` protocol, the endpoint is an URL beginning with
-    #     "https://"
+    #     `http://`
     #
     #   * For the `https` protocol, the endpoint is a URL beginning with
-    #     "https://"
+    #     `https://`
     #
     #   * For the `email` protocol, the endpoint is an email address
     #
@@ -1783,8 +1828,8 @@ module Aws::SNS
     #   * For the `application` protocol, the endpoint is the EndpointArn of a
     #     mobile app and device.
     #
-    #   * For the `lambda` protocol, the endpoint is the ARN of an AWS Lambda
-    #     function.
+    #   * For the `lambda` protocol, the endpoint is the ARN of an Amazon
+    #     Lambda function.
     #
     # @option params [Hash<String,String>] :attributes
     #   A map of attributes with their corresponding values.
@@ -1804,18 +1849,27 @@ module Aws::SNS
     #     for the endpoints to process JSON formatting, which is otherwise
     #     created for Amazon SNS metadata.
     #
+    #   * `RedrivePolicy` – When specified, sends undeliverable messages to
+    #     the specified Amazon SQS dead-letter queue. Messages that can't be
+    #     delivered due to client errors (for example, when the subscribed
+    #     endpoint is unreachable) or server errors (for example, when the
+    #     service that powers the subscribed endpoint becomes unavailable) are
+    #     held in the dead-letter queue for further analysis or reprocessing.
+    #
     # @option params [Boolean] :return_subscription_arn
     #   Sets whether the response from the `Subscribe` request includes the
     #   subscription ARN, even if the subscription is not yet confirmed.
     #
-    #   If you set this parameter to `false`, the response includes the ARN
-    #   for confirmed subscriptions, but it includes an ARN value of "pending
-    #   subscription" for subscriptions that are not yet confirmed. A
-    #   subscription becomes confirmed when the subscriber calls the
-    #   `ConfirmSubscription` action with a confirmation token.
+    #   * If you have the subscription ARN returned, the response includes the
+    #     ARN in all cases, even if the subscription is not yet confirmed.
+    #
+    #   * If you don't have the subscription ARN returned, in addition to the
+    #     ARN for confirmed subscriptions, the response also includes the
+    #     `pending subscription` ARN value for subscriptions that aren't yet
+    #     confirmed. A subscription becomes confirmed when the subscriber
+    #     calls the `ConfirmSubscription` action with a confirmation token.
     #
-    #   If you set this parameter to `true`, the response includes the ARN in
-    #   all cases, even if the subscription is not yet confirmed.
+    #   If you set this parameter to `true`, .
     #
     #   The default value is `false`.
     #
@@ -1863,18 +1917,14 @@ module Aws::SNS
     # * A new tag with a key identical to that of an existing tag overwrites
     #   the existing tag.
     #
-    # * Tagging actions are limited to 10 TPS per AWS account. If your
-    #   application requires a higher throughput, file a [technical support
-    #   request][2].
-    #
-    # For a full list of tag restrictions, see [Limits Related to Topics][3]
-    # in the *Amazon SNS Developer Guide*.
+    # * Tagging actions are limited to 10 TPS per AWS account, per AWS
+    #   region. If your application requires a higher throughput, file a
+    #   [technical support request][2].
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-tags.html
     # [2]: https://console.aws.amazon.com/support/home#/case/create?issueType=technical
-    # [3]: https://docs.aws.amazon.com/sns/latest/dg/sns-limits.html#limits-topics
     #
     # @option params [required, String] :resource_arn
     #   The ARN of the topic to which to add tags.
@@ -1980,7 +2030,7 @@ module Aws::SNS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-sns'
-      context[:gem_version] = '1.19.0'
+      context[:gem_version] = '1.24.0'
       Seahorse::Client::Request.new(handlers, context)
     end