aws-sdk-sns 1.88.0 → 1.112.0

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

@@ -28,37 +28,68 @@ module Aws::SNS
   #
   # ## Error Classes
   # * {AuthorizationErrorException}
+  #    * This error class is not used. `AuthorizationError` is used during parsing instead.
   # * {BatchEntryIdsNotDistinctException}
+  #    * This error class is not used. `BatchEntryIdsNotDistinct` is used during parsing instead.
   # * {BatchRequestTooLongException}
+  #    * This error class is not used. `BatchRequestTooLong` is used during parsing instead.
   # * {ConcurrentAccessException}
+  #    * This error class is not used. `ConcurrentAccess` is used during parsing instead.
   # * {EmptyBatchRequestException}
+  #    * This error class is not used. `EmptyBatchRequest` is used during parsing instead.
   # * {EndpointDisabledException}
+  #    * This error class is not used. `EndpointDisabled` is used during parsing instead.
   # * {FilterPolicyLimitExceededException}
+  #    * This error class is not used. `FilterPolicyLimitExceeded` is used during parsing instead.
   # * {InternalErrorException}
+  #    * This error class is not used. `InternalError` is used during parsing instead.
   # * {InvalidBatchEntryIdException}
+  #    * This error class is not used. `InvalidBatchEntryId` is used during parsing instead.
   # * {InvalidParameterException}
+  #    * This error class is not used. `InvalidParameter` is used during parsing instead.
   # * {InvalidParameterValueException}
+  #    * This error class is not used. `ParameterValueInvalid` is used during parsing instead.
   # * {InvalidSecurityException}
+  #    * This error class is not used. `InvalidSecurity` is used during parsing instead.
   # * {InvalidStateException}
+  #    * This error class is not used. `InvalidState` is used during parsing instead.
   # * {KMSAccessDeniedException}
+  #    * This error class is not used. `KMSAccessDenied` is used during parsing instead.
   # * {KMSDisabledException}
+  #    * This error class is not used. `KMSDisabled` is used during parsing instead.
   # * {KMSInvalidStateException}
+  #    * This error class is not used. `KMSInvalidState` is used during parsing instead.
   # * {KMSNotFoundException}
+  #    * This error class is not used. `KMSNotFound` is used during parsing instead.
   # * {KMSOptInRequired}
   # * {KMSThrottlingException}
+  #    * This error class is not used. `KMSThrottling` is used during parsing instead.
   # * {NotFoundException}
+  #    * This error class is not used. `NotFound` is used during parsing instead.
   # * {OptedOutException}
+  #    * This error class is not used. `OptedOut` is used during parsing instead.
   # * {PlatformApplicationDisabledException}
+  #    * This error class is not used. `PlatformApplicationDisabled` is used during parsing instead.
   # * {ReplayLimitExceededException}
+  #    * This error class is not used. `ReplayLimitExceeded` is used during parsing instead.
   # * {ResourceNotFoundException}
+  #    * This error class is not used. `ResourceNotFound` is used during parsing instead.
   # * {StaleTagException}
+  #    * This error class is not used. `StaleTag` is used during parsing instead.
   # * {SubscriptionLimitExceededException}
+  #    * This error class is not used. `SubscriptionLimitExceeded` is used during parsing instead.
   # * {TagLimitExceededException}
+  #    * This error class is not used. `TagLimitExceeded` is used during parsing instead.
   # * {TagPolicyException}
+  #    * This error class is not used. `TagPolicy` is used during parsing instead.
   # * {ThrottledException}
+  #    * This error class is not used. `Throttled` is used during parsing instead.
   # * {TooManyEntriesInBatchRequestException}
+  #    * This error class is not used. `TooManyEntriesInBatchRequest` is used during parsing instead.
   # * {TopicLimitExceededException}
+  #    * This error class is not used. `TopicLimitExceeded` is used during parsing instead.
   # * {UserErrorException}
+  #    * This error class is not used. `UserError` is used during parsing instead.
   # * {ValidationException}
   # * {VerificationException}
   #
@@ -68,6 +99,8 @@ module Aws::SNS
 
     extend Aws::Errors::DynamicErrors
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `AuthorizationError` instead.
     class AuthorizationErrorException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -83,6 +116,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `BatchEntryIdsNotDistinct` instead.
     class BatchEntryIdsNotDistinctException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -98,6 +133,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `BatchRequestTooLong` instead.
     class BatchRequestTooLongException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -113,6 +150,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `ConcurrentAccess` instead.
     class ConcurrentAccessException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -128,6 +167,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `EmptyBatchRequest` instead.
     class EmptyBatchRequestException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -143,6 +184,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `EndpointDisabled` instead.
     class EndpointDisabledException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -158,6 +201,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `FilterPolicyLimitExceeded` instead.
     class FilterPolicyLimitExceededException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -173,6 +218,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `InternalError` instead.
     class InternalErrorException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -188,6 +235,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `InvalidBatchEntryId` instead.
     class InvalidBatchEntryIdException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -203,6 +252,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `InvalidParameter` instead.
     class InvalidParameterException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -218,6 +269,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `ParameterValueInvalid` instead.
     class InvalidParameterValueException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -233,6 +286,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `InvalidSecurity` instead.
     class InvalidSecurityException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -248,6 +303,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `InvalidState` instead.
     class InvalidStateException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -263,6 +320,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `KMSAccessDenied` instead.
     class KMSAccessDeniedException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -278,6 +337,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `KMSDisabled` instead.
     class KMSDisabledException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -293,6 +354,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `KMSInvalidState` instead.
     class KMSInvalidStateException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -308,6 +371,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `KMSNotFound` instead.
     class KMSNotFoundException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -338,6 +403,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `KMSThrottling` instead.
     class KMSThrottlingException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -353,6 +420,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `NotFound` instead.
     class NotFoundException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -368,6 +437,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `OptedOut` instead.
     class OptedOutException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -383,6 +454,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `PlatformApplicationDisabled` instead.
     class PlatformApplicationDisabledException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -398,6 +471,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `ReplayLimitExceeded` instead.
     class ReplayLimitExceededException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -413,6 +488,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `ResourceNotFound` instead.
     class ResourceNotFoundException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -428,6 +505,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `StaleTag` instead.
     class StaleTagException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -443,6 +522,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `SubscriptionLimitExceeded` instead.
     class SubscriptionLimitExceededException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -458,6 +539,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `TagLimitExceeded` instead.
     class TagLimitExceededException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -473,6 +556,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `TagPolicy` instead.
     class TagPolicyException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -488,6 +573,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `Throttled` instead.
     class ThrottledException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -503,6 +590,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `TooManyEntriesInBatchRequest` instead.
     class TooManyEntriesInBatchRequestException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -518,6 +607,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `TopicLimitExceeded` instead.
     class TopicLimitExceededException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -533,6 +624,8 @@ module Aws::SNS
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `UserError` instead.
     class UserErrorException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -52,7 +52,6 @@ module Aws::SNS
     #   * APNS – Returns the token or certificate.
     #
     #   * GCM – Returns the token or key.
-    #
     # * `EventEndpointCreated` – Topic ARN to which EndpointCreated event
     #   notifications should be sent.
     #

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

@@ -221,30 +221,70 @@ module Aws::SNS
     # @option options [Hash<String,Types::MessageAttributeValue>] :message_attributes
     #   Message attributes for Publish action.
     # @option options [String] :message_deduplication_id
-    #   This parameter applies only to FIFO (first-in-first-out) topics. The
-    #   `MessageDeduplicationId` can contain up to 128 alphanumeric characters
+    #   * This parameter applies only to FIFO (first-in-first-out) topics. The
+    #     `MessageDeduplicationId` can contain up to 128 alphanumeric
+    #     characters `(a-z, A-Z, 0-9)` and punctuation ``
+    #     (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
+    #
+    #   * Every message must have a unique `MessageDeduplicationId`, which is
+    #     a token used for deduplication of sent messages within the 5 minute
+    #     minimum deduplication interval.
+    #
+    #   * The scope of deduplication depends on the `FifoThroughputScope`
+    #     attribute, when set to `Topic` the message deduplication scope is
+    #     across the entire topic, when set to `MessageGroup` the message
+    #     deduplication scope is within each individual message group.
+    #
+    #   * If a message with a particular `MessageDeduplicationId` is sent
+    #     successfully, subsequent messages within the deduplication scope and
+    #     interval, with the same `MessageDeduplicationId`, are accepted
+    #     successfully but aren't delivered.
+    #
+    #   * Every message must have a unique `MessageDeduplicationId`:
+    #
+    #     * You may provide a `MessageDeduplicationId` explicitly.
+    #
+    #     * If you aren't able to provide a `MessageDeduplicationId` and you
+    #       enable `ContentBasedDeduplication` for your topic, Amazon SNS uses
+    #       a SHA-256 hash to generate the `MessageDeduplicationId` using the
+    #       body of the message (but not the attributes of the message).
+    #
+    #     * If you don't provide a `MessageDeduplicationId` and the topic
+    #       doesn't have `ContentBasedDeduplication` set, the action fails
+    #       with an error.
+    #
+    #     * If the topic has a `ContentBasedDeduplication` set, your
+    #       `MessageDeduplicationId` overrides the generated one.
+    #   * When `ContentBasedDeduplication` is in effect, messages with
+    #     identical content sent within the deduplication scope and interval
+    #     are treated as duplicates and only one copy of the message is
+    #     delivered.
+    #
+    #   * If you send one message with `ContentBasedDeduplication` enabled,
+    #     and then another message with a `MessageDeduplicationId` that is the
+    #     same as the one generated for the first `MessageDeduplicationId`,
+    #     the two messages are treated as duplicates, within the deduplication
+    #     scope and interval, and only one copy of the message is delivered.
+    # @option options [String] :message_group_id
+    #   The `MessageGroupId` can contain up to 128 alphanumeric characters
     #   `(a-z, A-Z, 0-9)` and punctuation ``
-    #   (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
+    #   (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
     #
-    #   Every message must have a unique `MessageDeduplicationId`, which is a
-    #   token used for deduplication of sent messages. If a message with a
-    #   particular `MessageDeduplicationId` is sent successfully, any message
-    #   sent with the same `MessageDeduplicationId` during the 5-minute
-    #   deduplication interval is treated as a duplicate.
+    #   For FIFO topics: The `MessageGroupId` is a tag that specifies that a
+    #   message belongs to a specific message group. Messages that belong to
+    #   the same message group are processed in a FIFO manner (however,
+    #   messages in different message groups might be processed out of order).
+    #   Every message must include a `MessageGroupId`.
     #
-    #   If the topic has `ContentBasedDeduplication` set, the system generates
-    #   a `MessageDeduplicationId` based on the contents of the message. Your
-    #   `MessageDeduplicationId` overrides the generated one.
-    # @option options [String] :message_group_id
-    #   This parameter applies only to FIFO (first-in-first-out) topics. The
-    #   `MessageGroupId` can contain up to 128 alphanumeric characters `(a-z,
-    #   A-Z, 0-9)` and punctuation `` (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
-    #
-    #   The `MessageGroupId` is a tag that specifies that a message belongs to
-    #   a specific message group. Messages that belong to the same message
-    #   group are processed in a FIFO manner (however, messages in different
-    #   message groups might be processed out of order). Every message must
-    #   include a `MessageGroupId`.
+    #   For standard topics: The `MessageGroupId` is optional and is forwarded
+    #   only to Amazon SQS standard subscriptions to activate [fair
+    #   queues][1]. The `MessageGroupId` is not used for, or sent to, any
+    #   other endpoint types. When provided, the same validation rules apply
+    #   as for FIFO topics.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-fair-queues.html
     # @return [Types::PublishResponse]
     def publish(options = {})
       options = options.merge(target_arn: @arn)

data/lib/aws-sdk-sns/plugins/endpoints.rb

@@ -27,7 +27,7 @@ The endpoint provider used to resolve endpoints. Any object that responds to
       class Handler < Seahorse::Client::Handler
         def call(context)
           unless context[:discovered_endpoint]
-            params = parameters_for_operation(context)
+            params = Aws::SNS::Endpoints.parameters_for_operation(context)
             endpoint = context.config.endpoint_provider.resolve_endpoint(params)
 
             context.http_request.endpoint = endpoint.url
@@ -67,95 +67,6 @@ The endpoint provider used to resolve endpoints. Any object that responds to
             context.http_request.headers[key] = value
           end
         end
-
-        def parameters_for_operation(context)
-          case context.operation_name
-          when :add_permission
-            Aws::SNS::Endpoints::AddPermission.build(context)
-          when :check_if_phone_number_is_opted_out
-            Aws::SNS::Endpoints::CheckIfPhoneNumberIsOptedOut.build(context)
-          when :confirm_subscription
-            Aws::SNS::Endpoints::ConfirmSubscription.build(context)
-          when :create_platform_application
-            Aws::SNS::Endpoints::CreatePlatformApplication.build(context)
-          when :create_platform_endpoint
-            Aws::SNS::Endpoints::CreatePlatformEndpoint.build(context)
-          when :create_sms_sandbox_phone_number
-            Aws::SNS::Endpoints::CreateSMSSandboxPhoneNumber.build(context)
-          when :create_topic
-            Aws::SNS::Endpoints::CreateTopic.build(context)
-          when :delete_endpoint
-            Aws::SNS::Endpoints::DeleteEndpoint.build(context)
-          when :delete_platform_application
-            Aws::SNS::Endpoints::DeletePlatformApplication.build(context)
-          when :delete_sms_sandbox_phone_number
-            Aws::SNS::Endpoints::DeleteSMSSandboxPhoneNumber.build(context)
-          when :delete_topic
-            Aws::SNS::Endpoints::DeleteTopic.build(context)
-          when :get_data_protection_policy
-            Aws::SNS::Endpoints::GetDataProtectionPolicy.build(context)
-          when :get_endpoint_attributes
-            Aws::SNS::Endpoints::GetEndpointAttributes.build(context)
-          when :get_platform_application_attributes
-            Aws::SNS::Endpoints::GetPlatformApplicationAttributes.build(context)
-          when :get_sms_attributes
-            Aws::SNS::Endpoints::GetSMSAttributes.build(context)
-          when :get_sms_sandbox_account_status
-            Aws::SNS::Endpoints::GetSMSSandboxAccountStatus.build(context)
-          when :get_subscription_attributes
-            Aws::SNS::Endpoints::GetSubscriptionAttributes.build(context)
-          when :get_topic_attributes
-            Aws::SNS::Endpoints::GetTopicAttributes.build(context)
-          when :list_endpoints_by_platform_application
-            Aws::SNS::Endpoints::ListEndpointsByPlatformApplication.build(context)
-          when :list_origination_numbers
-            Aws::SNS::Endpoints::ListOriginationNumbers.build(context)
-          when :list_phone_numbers_opted_out
-            Aws::SNS::Endpoints::ListPhoneNumbersOptedOut.build(context)
-          when :list_platform_applications
-            Aws::SNS::Endpoints::ListPlatformApplications.build(context)
-          when :list_sms_sandbox_phone_numbers
-            Aws::SNS::Endpoints::ListSMSSandboxPhoneNumbers.build(context)
-          when :list_subscriptions
-            Aws::SNS::Endpoints::ListSubscriptions.build(context)
-          when :list_subscriptions_by_topic
-            Aws::SNS::Endpoints::ListSubscriptionsByTopic.build(context)
-          when :list_tags_for_resource
-            Aws::SNS::Endpoints::ListTagsForResource.build(context)
-          when :list_topics
-            Aws::SNS::Endpoints::ListTopics.build(context)
-          when :opt_in_phone_number
-            Aws::SNS::Endpoints::OptInPhoneNumber.build(context)
-          when :publish
-            Aws::SNS::Endpoints::Publish.build(context)
-          when :publish_batch
-            Aws::SNS::Endpoints::PublishBatch.build(context)
-          when :put_data_protection_policy
-            Aws::SNS::Endpoints::PutDataProtectionPolicy.build(context)
-          when :remove_permission
-            Aws::SNS::Endpoints::RemovePermission.build(context)
-          when :set_endpoint_attributes
-            Aws::SNS::Endpoints::SetEndpointAttributes.build(context)
-          when :set_platform_application_attributes
-            Aws::SNS::Endpoints::SetPlatformApplicationAttributes.build(context)
-          when :set_sms_attributes
-            Aws::SNS::Endpoints::SetSMSAttributes.build(context)
-          when :set_subscription_attributes
-            Aws::SNS::Endpoints::SetSubscriptionAttributes.build(context)
-          when :set_topic_attributes
-            Aws::SNS::Endpoints::SetTopicAttributes.build(context)
-          when :subscribe
-            Aws::SNS::Endpoints::Subscribe.build(context)
-          when :tag_resource
-            Aws::SNS::Endpoints::TagResource.build(context)
-          when :unsubscribe
-            Aws::SNS::Endpoints::Unsubscribe.build(context)
-          when :untag_resource
-            Aws::SNS::Endpoints::UntagResource.build(context)
-          when :verify_sms_sandbox_phone_number
-            Aws::SNS::Endpoints::VerifySMSSandboxPhoneNumber.build(context)
-          end
-        end
       end
 
       def add_handlers(handlers, _config)