aws-sdk-sns 1.24.0 → 1.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c10fcf0aede9daa7ffc180be99eaf42df30d9e84eafd433d7086fe0df20ee55
-  data.tar.gz: 559f957645a9f665aaae3b0086178988660ae7b888ba6ff9d13c2f9032d75d5b
+  metadata.gz: 287a854cd0d72e977abcc32963f8d40ec6ba5c4b95124e884d33cb2a4c758101
+  data.tar.gz: c9d602b5b3a121c052bf358a4922288e802ba6ce97ddc95982fe4dbf4b67c168
 SHA512:
-  metadata.gz: 239b22483640c1010548455dbc3f75b40b9e7437d78037e02e268a4a57fb6715b5101e927566a3f4332c8b03599041b2fe1553e82e6704c47c5965f0658d4945
-  data.tar.gz: 3be3aeb8100bf20c094895732d5b4745b50d44c74f882779faf04733e624394eb9a45beb33d89e41df3c212aabf32ac12ee688473e6d8692c81d33419db43da4
+  metadata.gz: 5e69d5d4b49a28e50237f2ffac3c8aaa419682cd004bb21f82669538561ea8d9798bf5d3326b49cca40cce74d35ff7c96c8c966a59c22b679405e99baf117357
+  data.tar.gz: 85036ba044a0eaf7a0bb4ff42e73f899d4f1f577541fe09589399462057ca1ac16a089091cbf963d8ab5e246d211106e18866045184775a928ab9b2caa5113dc

data/lib/aws-sdk-sns.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -49,6 +51,6 @@ require_relative 'aws-sdk-sns/customizations'
 # @service
 module Aws::SNS
 
-  GEM_VERSION = '1.24.0'
+  GEM_VERSION = '1.29.0'
 
 end

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -24,6 +26,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
+require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/query.rb'
 
@@ -69,6 +72,7 @@ module Aws::SNS
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
+    add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::Query)
 
@@ -161,7 +165,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 a valid HTTP(S) URI.
+    #     to test or custom 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
@@ -425,25 +429,34 @@ module Aws::SNS
     end
 
     # Creates a platform application object for one of the supported push
-    # notification services, such as APNS and FCM, to which devices and
-    # mobile apps may register. You must specify PlatformPrincipal and
-    # PlatformCredential attributes when using the
-    # `CreatePlatformApplication` action. The PlatformPrincipal is received
-    # from the notification service. For APNS/APNS\_SANDBOX,
-    # 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,
-    # PlatformPrincipal is "TLS certificate". For Baidu, PlatformPrincipal
-    # is "API key".
-    #
-    # For APNS/APNS\_SANDBOX, PlatformCredential is "private key". For
-    # 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.
+    # notification services, such as APNS and GCM (Firebase Cloud
+    # Messaging), to which devices and mobile apps may register. You must
+    # specify `PlatformPrincipal` and `PlatformCredential` attributes when
+    # using the `CreatePlatformApplication` action.
+    #
+    # `PlatformPrincipal` and `PlatformCredential` are received from the
+    # notification service.
+    #
+    # * For `ADM`, `PlatformPrincipal` is `client id` and
+    #   `PlatformCredential` is `client secret`.
+    #
+    # * For `Baidu`, `PlatformPrincipal` is `API key` and
+    #   `PlatformCredential` is `secret key`.
+    #
+    # * For `APNS` and `APNS_SANDBOX`, `PlatformPrincipal` is `SSL
+    #   certificate` and `PlatformCredential` is `private key`.
+    #
+    # * For `GCM` (Firebase Cloud Messaging), there is no
+    #   `PlatformPrincipal` and the `PlatformCredential` is `API key`.
+    #
+    # * For `MPNS`, `PlatformPrincipal` is `TLS certificate` and
+    #   `PlatformCredential` is `private key`.
+    #
+    # * For `WNS`, `PlatformPrincipal` is `Package Security Identifier` and
+    #   `PlatformCredential` is `secret key`.
+    #
+    # You can use the returned `PlatformApplicationArn` as an attribute for
+    # the `CreatePlatformEndpoint` action.
     #
     # @option params [required, String] :name
     #   Application names must be made up of only uppercase and lowercase
@@ -452,7 +465,7 @@ 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 FCM
+    #   APNS (Apple Push Notification Service), APNS\_SANDBOX, and GCM
     #   (Firebase Cloud Messaging).
     #
     # @option params [required, Hash<String,String>] :attributes
@@ -490,16 +503,16 @@ module Aws::SNS
     end
 
     # Creates an endpoint for a device and mobile app on one of the
-    # 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
-    # `Publish` action to send a message to a mobile app or by the
-    # `Subscribe` action for subscription to a topic. The
-    # `CreatePlatformEndpoint` action is idempotent, so if the requester
-    # already owns an endpoint with the same device token and attributes,
-    # that endpoint's ARN is returned without creating a new endpoint. For
-    # more information, see [Using Amazon SNS Mobile Push Notifications][1].
+    # supported push notification services, such as GCM (Firebase Cloud
+    # Messaging) and APNS. `CreatePlatformEndpoint` requires the
+    # `PlatformApplicationArn` that is returned from
+    # `CreatePlatformApplication`. You can use the returned `EndpointArn` to
+    # send a message to a mobile app or by the `Subscribe` action for
+    # subscription to a topic. The `CreatePlatformEndpoint` action is
+    # idempotent, so if the requester already owns an endpoint with the same
+    # device token and attributes, that endpoint's ARN is returned without
+    # creating a new endpoint. For more information, see [Using Amazon SNS
+    # Mobile Push Notifications][1].
     #
     # When using `CreatePlatformEndpoint` with Baidu, two attributes must be
     # provided: ChannelId and UserId. The token field must also contain the
@@ -520,8 +533,8 @@ 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 FCM or ADM, the device token equivalent is called the
-    #   registration ID.
+    #   when using GCM (Firebase Cloud Messaging) or ADM, the device token
+    #   equivalent is called the registration ID.
     #
     # @option params [String] :custom_user_data
     #   Arbitrary user data to associate with the endpoint. Amazon SNS does
@@ -681,8 +694,9 @@ module Aws::SNS
     end
 
     # Deletes a platform application object for one of the supported push
-    # notification services, such as APNS and FCM. For more information, see
-    # [Using Amazon SNS Mobile Push Notifications][1].
+    # notification services, such as APNS and GCM (Firebase Cloud
+    # Messaging). For more information, see [Using Amazon SNS Mobile Push
+    # Notifications][1].
     #
     #
     #
@@ -734,8 +748,9 @@ module Aws::SNS
     end
 
     # Retrieves the endpoint attributes for a device on one of the supported
-    # push notification services, such as FCM and APNS. For more
-    # information, see [Using Amazon SNS Mobile Push Notifications][1].
+    # push notification services, such as GCM (Firebase Cloud Messaging) and
+    # APNS. For more information, see [Using Amazon SNS Mobile Push
+    # Notifications][1].
     #
     #
     #
@@ -769,8 +784,9 @@ module Aws::SNS
     end
 
     # Retrieves the attributes of the platform application object for the
-    # supported push notification services, such as APNS and FCM. For more
-    # information, see [Using Amazon SNS Mobile Push Notifications][1].
+    # supported push notification services, such as APNS and GCM (Firebase
+    # Cloud Messaging). For more information, see [Using Amazon SNS Mobile
+    # Push Notifications][1].
     #
     #
     #
@@ -904,11 +920,11 @@ module Aws::SNS
     end
 
     # Lists the endpoints and endpoint attributes for devices in a supported
-    # 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
-    # be returned. To receive the next page, you call
+    # push notification service, such as GCM (Firebase Cloud Messaging) 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 be returned. To receive the next page, you call
     # `ListEndpointsByPlatformApplication` again using the NextToken string
     # received from the previous call. When there are no more records to
     # return, NextToken will be null. For more information, see [Using
@@ -1003,14 +1019,15 @@ module Aws::SNS
     end
 
     # Lists the platform application objects for the supported push
-    # 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
-    # receive the next page, you call `ListPlatformApplications` using the
-    # NextToken string received from the previous call. When there are no
-    # more records to return, NextToken will be null. For more information,
-    # see [Using Amazon SNS Mobile Push Notifications][1].
+    # notification services, such as APNS and GCM (Firebase Cloud
+    # Messaging). 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 receive the next page, you call
+    # `ListPlatformApplications` using the NextToken string received from
+    # the previous call. When there are no more records to return,
+    # `NextToken` will be null. For more information, see [Using Amazon SNS
+    # Mobile Push Notifications][1].
     #
     # This action is throttled at 15 transactions per second (TPS).
     #
@@ -1241,8 +1258,9 @@ module Aws::SNS
       req.send_request(options)
     end
 
-    # Sends a message to an Amazon SNS topic or sends a text message (SMS
-    # message) directly to a phone number.
+    # Sends a message to an Amazon SNS topic, a text message (SMS message)
+    # directly to a phone number, or a message to a mobile platform endpoint
+    # (when you specify the `TargetArn`).
     #
     # If you send a message to a topic, Amazon SNS delivers the message to
     # each endpoint that is subscribed to the topic. The format of the
@@ -1261,6 +1279,9 @@ module Aws::SNS
     # For more information about formatting messages, see [Send Custom
     # Platform-Specific Payloads in Messages to Mobile Devices][1].
     #
+    # You can publish messages only to topics and endpoints in the same AWS
+    # Region.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/sns/latest/dg/mobile-push-send-custommessage.html
@@ -1429,8 +1450,9 @@ module Aws::SNS
     end
 
     # Sets the attributes for an endpoint for a device on one of the
-    # supported push notification services, such as FCM and APNS. For more
-    # information, see [Using Amazon SNS Mobile Push Notifications][1].
+    # supported push notification services, such as GCM (Firebase Cloud
+    # Messaging) and APNS. For more information, see [Using Amazon SNS
+    # Mobile Push Notifications][1].
     #
     #
     #
@@ -1478,11 +1500,11 @@ module Aws::SNS
     end
 
     # Sets the attributes of the platform application object for the
-    # 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
-    # Status][2].
+    # supported push notification services, such as APNS and GCM (Firebase
+    # Cloud Messaging). 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 Status][2].
     #
     #
     #
@@ -1497,26 +1519,27 @@ module Aws::SNS
     #   include the following:
     #
     #   * `PlatformCredential` – The credential received from the notification
-    #     service. For APNS/APNS\_SANDBOX, PlatformCredential is private key.
-    #     For FCM, PlatformCredential is "API key". For ADM,
-    #     PlatformCredential is "client secret".
+    #     service. For `APNS` and `APNS_SANDBOX`, `PlatformCredential` is
+    #     `private key`. For `GCM` (Firebase Cloud Messaging),
+    #     `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 FCM, PlatformPrincipal is not applicable. For ADM,
-    #     PlatformPrincipal is "client id".
+    #     service. For `APNS` and `APNS_SANDBOX`, `PlatformPrincipal` is `SSL
+    #     certificate`. For `GCM` (Firebase Cloud Messaging), there is no
+    #     `PlatformPrincipal`. For `ADM`, `PlatformPrincipal` is `client id`.
     #
-    #   * `EventEndpointCreated` – Topic ARN to which EndpointCreated event
-    #     notifications should be sent.
+    #   * `EventEndpointCreated` – Topic ARN to which `EndpointCreated` event
+    #     notifications are sent.
     #
-    #   * `EventEndpointDeleted` – Topic ARN to which EndpointDeleted event
-    #     notifications should be sent.
+    #   * `EventEndpointDeleted` – Topic ARN to which `EndpointDeleted` event
+    #     notifications are sent.
     #
-    #   * `EventEndpointUpdated` – Topic ARN to which EndpointUpdate event
-    #     notifications should be sent.
+    #   * `EventEndpointUpdated` – Topic ARN to which `EndpointUpdate` event
+    #     notifications are sent.
     #
-    #   * `EventDeliveryFailure` – Topic ARN to which DeliveryFailure event
-    #     notifications should be sent upon Direct Publish delivery failure
+    #   * `EventDeliveryFailure` – Topic ARN to which `DeliveryFailure` event
+    #     notifications are sent upon Direct Publish delivery failure
     #     (permanent) to one of the application's endpoints.
     #
     #   * `SuccessFeedbackRoleArn` – IAM role ARN used to give Amazon SNS
@@ -1773,11 +1796,13 @@ module Aws::SNS
       req.send_request(options)
     end
 
-    # Prepares to subscribe an endpoint by sending the endpoint a
-    # confirmation message. To actually create a subscription, the endpoint
-    # owner must call the `ConfirmSubscription` action with the token from
-    # the confirmation message. Confirmation tokens are valid for three
-    # days.
+    # Subscribes an endpoint to an Amazon SNS topic. If the endpoint type is
+    # HTTP/S or email, or if the endpoint and the topic are not in the same
+    # AWS account, the endpoint owner must the `ConfirmSubscription` action
+    # to confirm the subscription.
+    #
+    # You call the `ConfirmSubscription` action with the token from the
+    # subscription response. Confirmation tokens are valid for three days.
     #
     # This action is throttled at 100 transactions per second (TPS).
     #
@@ -1809,11 +1834,11 @@ module Aws::SNS
     #   The endpoint that you want to receive notifications. Endpoints vary by
     #   protocol:
     #
-    #   * For the `http` protocol, the endpoint is an URL beginning with
-    #     `http://`
+    #   * For the `http` protocol, the (public) endpoint is a URL beginning
+    #     with `http://`
     #
-    #   * For the `https` protocol, the endpoint is a URL beginning with
-    #     `https://`
+    #   * For the `https` protocol, the (public) endpoint is a URL beginning
+    #     with `https://`
     #
     #   * For the `email` protocol, the endpoint is an email address
     #
@@ -1860,16 +1885,17 @@ module Aws::SNS
     #   Sets whether the response from the `Subscribe` request includes the
     #   subscription ARN, even if the subscription is not yet confirmed.
     #
-    #   * 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 set this parameter to `true`, the response includes the ARN
+    #     in all cases, even if the subscription is not yet confirmed. 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 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 default value is `false`.
     #
@@ -2030,7 +2056,7 @@ module Aws::SNS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-sns'
-      context[:gem_version] = '1.24.0'
+      context[:gem_version] = '1.29.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:

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

@@ -1,2 +1,4 @@
+# frozen_string_literal: true
+
 # utility classes
 require 'aws-sdk-sns/message_verifier'

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'net/http'
 require 'openssl'
 require 'base64'

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -103,8 +105,8 @@ 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 FCM or ADM, the device token equivalent is called the
-    #   registration ID.
+    #   when using GCM (Firebase Cloud Messaging) or ADM, the device token
+    #   equivalent is called the registration ID.
     # @option options [String] :custom_user_data
     #   Arbitrary user data to associate with the endpoint. Amazon SNS does
     #   not use this data. The data must be in UTF-8 format and less than 2KB.
@@ -148,26 +150,27 @@ module Aws::SNS
     #   include the following:
     #
     #   * `PlatformCredential` – The credential received from the notification
-    #     service. For APNS/APNS\_SANDBOX, PlatformCredential is private key.
-    #     For FCM, PlatformCredential is "API key". For ADM,
-    #     PlatformCredential is "client secret".
+    #     service. For `APNS` and `APNS_SANDBOX`, `PlatformCredential` is
+    #     `private key`. For `GCM` (Firebase Cloud Messaging),
+    #     `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 FCM, PlatformPrincipal is not applicable. For ADM,
-    #     PlatformPrincipal is "client id".
+    #     service. For `APNS` and `APNS_SANDBOX`, `PlatformPrincipal` is `SSL
+    #     certificate`. For `GCM` (Firebase Cloud Messaging), there is no
+    #     `PlatformPrincipal`. For `ADM`, `PlatformPrincipal` is `client id`.
     #
-    #   * `EventEndpointCreated` – Topic ARN to which EndpointCreated event
-    #     notifications should be sent.
+    #   * `EventEndpointCreated` – Topic ARN to which `EndpointCreated` event
+    #     notifications are sent.
     #
-    #   * `EventEndpointDeleted` – Topic ARN to which EndpointDeleted event
-    #     notifications should be sent.
+    #   * `EventEndpointDeleted` – Topic ARN to which `EndpointDeleted` event
+    #     notifications are sent.
     #
-    #   * `EventEndpointUpdated` – Topic ARN to which EndpointUpdate event
-    #     notifications should be sent.
+    #   * `EventEndpointUpdated` – Topic ARN to which `EndpointUpdate` event
+    #     notifications are sent.
     #
-    #   * `EventDeliveryFailure` – Topic ARN to which DeliveryFailure event
-    #     notifications should be sent upon Direct Publish delivery failure
+    #   * `EventDeliveryFailure` – Topic ARN to which `DeliveryFailure` event
+    #     notifications are sent upon Direct Publish delivery failure
     #     (permanent) to one of the application's endpoints.
     #
     #   * `SuccessFeedbackRoleArn` – IAM role ARN used to give Amazon SNS