aws-sdk-sns 1.22.0 → 1.39.0

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

@@ -1,7 +1,9 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -45,6 +47,7 @@ module Aws::SNS
       :label,
       :aws_account_id,
       :action_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -58,6 +61,7 @@ module Aws::SNS
     #
     class AuthorizationErrorException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -78,6 +82,7 @@ module Aws::SNS
     #
     class CheckIfPhoneNumberIsOptedOutInput < Struct.new(
       :phone_number)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -97,6 +102,7 @@ module Aws::SNS
     #
     class CheckIfPhoneNumberIsOptedOutResponse < Struct.new(
       :is_opted_out)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -110,6 +116,7 @@ module Aws::SNS
     #
     class ConcurrentAccessException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -146,6 +153,7 @@ module Aws::SNS
       :topic_arn,
       :token,
       :authenticate_on_unsubscribe)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -159,6 +167,7 @@ module Aws::SNS
     #
     class ConfirmSubscriptionResponse < Struct.new(
       :subscription_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -172,6 +181,7 @@ module Aws::SNS
     #
     class CreateEndpointResponse < Struct.new(
       :endpoint_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -197,7 +207,7 @@ module Aws::SNS
     # @!attribute [rw] platform
     #   The following platforms are supported: ADM (Amazon Device
     #   Messaging), APNS (Apple Push Notification Service), APNS\_SANDBOX,
-    #   and FCM (Firebase Cloud Messaging).
+    #   and GCM (Firebase Cloud Messaging).
     #   @return [String]
     #
     # @!attribute [rw] attributes
@@ -214,6 +224,7 @@ module Aws::SNS
       :name,
       :platform,
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -227,6 +238,7 @@ module Aws::SNS
     #
     class CreatePlatformApplicationResponse < Struct.new(
       :platform_application_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -254,8 +266,8 @@ module Aws::SNS
     #   a 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.
     #   @return [String]
     #
     # @!attribute [rw] custom_user_data
@@ -279,6 +291,7 @@ module Aws::SNS
       :token,
       :custom_user_data,
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -306,6 +319,9 @@ module Aws::SNS
     #   Constraints: Topic names must be made up of only uppercase and
     #   lowercase ASCII letters, numbers, underscores, and hyphens, and must
     #   be between 1 and 256 characters long.
+    #
+    #   For a FIFO (first-in-first-out) topic, the name must end with the
+    #   `.fifo` suffix.
     #   @return [String]
     #
     # @!attribute [rw] attributes
@@ -320,6 +336,8 @@ module Aws::SNS
     #   * `DisplayName` – The display name to use for a topic with SMS
     #     subscriptions.
     #
+    #   * `FifoTopic` – Set to true to create a FIFO topic.
+    #
     #   * `Policy` – The policy that defines who can access your topic. By
     #     default, only the topic owner can publish or subscribe to the
     #     topic.
@@ -327,18 +345,41 @@ module Aws::SNS
     #   The following attribute applies only to
     #   [server-side-encryption][1]\:
     #
-    #   * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
+    #   * `KmsMasterKeyId` – The ID of an AWS-managed customer master key
     #     (CMK) for Amazon SNS or a custom CMK. For more information, see
     #     [Key Terms][2]. For more examples, see [KeyId][3] in the *AWS Key
     #     Management Service API Reference*.
     #
     #   ^
     #
+    #   The following attributes apply only to [FIFO topics][4]\:
+    #
+    #   * `FifoTopic` – When this is set to `true`, a FIFO topic is created.
+    #
+    #   * `ContentBasedDeduplication` – Enables content-based deduplication
+    #     for FIFO topics.
+    #
+    #     * By default, `ContentBasedDeduplication` is set to `false`. If
+    #       you create a FIFO topic and this attribute is `false`, you must
+    #       specify a value for the `MessageDeduplicationId` parameter for
+    #       the [Publish][5] action.
+    #
+    #     * When you set `ContentBasedDeduplication` to `true`, Amazon SNS
+    #       uses a SHA-256 hash to generate the `MessageDeduplicationId`
+    #       using the body of the message (but not the attributes of the
+    #       message).
+    #
+    #       (Optional) To override the generated value, you can specify a
+    #       value for the the `MessageDeduplicationId` parameter for the
+    #       `Publish` action.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
     #   [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
     #   [3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
+    #   [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
+    #   [5]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] tags
@@ -356,6 +397,7 @@ module Aws::SNS
       :name,
       :attributes,
       :tags)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -369,6 +411,7 @@ module Aws::SNS
     #
     class CreateTopicResponse < Struct.new(
       :topic_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -389,6 +432,7 @@ module Aws::SNS
     #
     class DeleteEndpointInput < Struct.new(
       :endpoint_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -409,6 +453,7 @@ module Aws::SNS
     #
     class DeletePlatformApplicationInput < Struct.new(
       :platform_application_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -427,6 +472,7 @@ module Aws::SNS
     #
     class DeleteTopicInput < Struct.new(
       :topic_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -445,6 +491,7 @@ module Aws::SNS
     class Endpoint < Struct.new(
       :endpoint_arn,
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -458,6 +505,7 @@ module Aws::SNS
     #
     class EndpointDisabledException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -472,6 +520,7 @@ module Aws::SNS
     #
     class FilterPolicyLimitExceededException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -492,6 +541,7 @@ module Aws::SNS
     #
     class GetEndpointAttributesInput < Struct.new(
       :endpoint_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -523,6 +573,7 @@ module Aws::SNS
     #
     class GetEndpointAttributesResponse < Struct.new(
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -543,6 +594,7 @@ module Aws::SNS
     #
     class GetPlatformApplicationAttributesInput < Struct.new(
       :platform_application_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -569,6 +621,7 @@ module Aws::SNS
     #
     class GetPlatformApplicationAttributesResponse < Struct.new(
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -599,6 +652,7 @@ module Aws::SNS
     #
     class GetSMSAttributesInput < Struct.new(
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -612,6 +666,7 @@ module Aws::SNS
     #
     class GetSMSAttributesResponse < Struct.new(
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -632,6 +687,7 @@ module Aws::SNS
     #
     class GetSubscriptionAttributesInput < Struct.new(
       :subscription_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -652,7 +708,8 @@ module Aws::SNS
     #     delivery policy and account system defaults.
     #
     #   * `FilterPolicy` – The filter policy JSON that is assigned to the
-    #     subscription.
+    #     subscription. For more information, see [Amazon SNS Message
+    #     Filtering][1] in the *Amazon SNS Developer Guide*.
     #
     #   * `Owner` – The AWS account ID of the subscription's owner.
     #
@@ -676,12 +733,33 @@ module Aws::SNS
     #
     #   * `TopicArn` – The topic ARN that the subscription is associated
     #     with.
+    #
+    #   The following attribute applies only to Amazon Kinesis Data Firehose
+    #   delivery stream subscriptions:
+    #
+    #   * `SubscriptionRoleArn` – The ARN of the IAM role that has the
+    #     following:
+    #
+    #     * Permission to write to the Kinesis Data Firehose delivery stream
+    #
+    #     * Amazon SNS listed as a trusted entity
+    #
+    #     Specifying a valid ARN for this attribute is required for Kinesis
+    #     Data Firehose delivery stream subscriptions. For more information,
+    #     see [Fanout to Kinesis Data Firehose delivery streams][2] in the
+    #     *Amazon SNS Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-message-filtering.html
+    #   [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-kinesis-subscriber.html
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/GetSubscriptionAttributesResponse AWS API Documentation
     #
     class GetSubscriptionAttributesResponse < Struct.new(
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -702,6 +780,7 @@ module Aws::SNS
     #
     class GetTopicAttributesInput < Struct.new(
       :topic_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -733,7 +812,7 @@ module Aws::SNS
     #
     #   * `TopicArn` – The topic's ARN.
     #
-    #   * `EffectiveDeliveryPolicy` – Yhe JSON serialization of the
+    #   * `EffectiveDeliveryPolicy` – The JSON serialization of the
     #     effective delivery policy, taking system defaults into account.
     #
     #   The following attribute applies only to
@@ -746,17 +825,41 @@ module Aws::SNS
     #
     #   ^
     #
+    #   The following attributes apply only to [FIFO topics][4]\:
+    #
+    #   * `FifoTopic` – When this is set to `true`, a FIFO topic is created.
+    #
+    #   * `ContentBasedDeduplication` – Enables content-based deduplication
+    #     for FIFO topics.
+    #
+    #     * By default, `ContentBasedDeduplication` is set to `false`. If
+    #       you create a FIFO topic and this attribute is `false`, you must
+    #       specify a value for the `MessageDeduplicationId` parameter for
+    #       the [Publish][5] action.
+    #
+    #     * When you set `ContentBasedDeduplication` to `true`, Amazon SNS
+    #       uses a SHA-256 hash to generate the `MessageDeduplicationId`
+    #       using the body of the message (but not the attributes of the
+    #       message).
+    #
+    #       (Optional) To override the generated value, you can specify a
+    #       value for the the `MessageDeduplicationId` parameter for the
+    #       `Publish` action.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
     #   [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
     #   [3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
+    #   [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
+    #   [5]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/GetTopicAttributesResponse AWS API Documentation
     #
     class GetTopicAttributesResponse < Struct.new(
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -769,6 +872,7 @@ module Aws::SNS
     #
     class InternalErrorException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -782,6 +886,7 @@ module Aws::SNS
     #
     class InvalidParameterException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -796,6 +901,7 @@ module Aws::SNS
     #
     class InvalidParameterValueException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -809,6 +915,7 @@ module Aws::SNS
     #
     class InvalidSecurityException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -822,6 +929,7 @@ module Aws::SNS
     #
     class KMSAccessDeniedException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -835,6 +943,7 @@ module Aws::SNS
     #
     class KMSDisabledException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -854,6 +963,7 @@ module Aws::SNS
     #
     class KMSInvalidStateException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -867,6 +977,7 @@ module Aws::SNS
     #
     class KMSNotFoundException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -879,6 +990,7 @@ module Aws::SNS
     #
     class KMSOptInRequired < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -897,6 +1009,7 @@ module Aws::SNS
     #
     class KMSThrottlingException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -926,6 +1039,7 @@ module Aws::SNS
     class ListEndpointsByPlatformApplicationInput < Struct.new(
       :platform_application_arn,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -946,6 +1060,7 @@ module Aws::SNS
     class ListEndpointsByPlatformApplicationResponse < Struct.new(
       :endpoints,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -968,6 +1083,7 @@ module Aws::SNS
     #
     class ListPhoneNumbersOptedOutInput < Struct.new(
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -990,6 +1106,7 @@ module Aws::SNS
     class ListPhoneNumbersOptedOutResponse < Struct.new(
       :phone_numbers,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1012,6 +1129,7 @@ module Aws::SNS
     #
     class ListPlatformApplicationsInput < Struct.new(
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1033,6 +1151,7 @@ module Aws::SNS
     class ListPlatformApplicationsResponse < Struct.new(
       :platform_applications,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1059,6 +1178,7 @@ module Aws::SNS
     class ListSubscriptionsByTopicInput < Struct.new(
       :topic_arn,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1079,6 +1199,7 @@ module Aws::SNS
     class ListSubscriptionsByTopicResponse < Struct.new(
       :subscriptions,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1099,6 +1220,7 @@ module Aws::SNS
     #
     class ListSubscriptionsInput < Struct.new(
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1118,6 +1240,7 @@ module Aws::SNS
     class ListSubscriptionsResponse < Struct.new(
       :subscriptions,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1136,6 +1259,7 @@ module Aws::SNS
     #
     class ListTagsForResourceRequest < Struct.new(
       :resource_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1147,6 +1271,7 @@ module Aws::SNS
     #
     class ListTagsForResourceResponse < Struct.new(
       :tags)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1165,6 +1290,7 @@ module Aws::SNS
     #
     class ListTopicsInput < Struct.new(
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1184,6 +1310,7 @@ module Aws::SNS
     class ListTopicsResponse < Struct.new(
       :topics,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1195,12 +1322,14 @@ module Aws::SNS
     # message body should not be empty or null. All parts of the message
     # attribute, including name, type, and value, are included in the
     # message size restriction, which is currently 256 KB (262,144 bytes).
-    # For more information, see [Using Amazon SNS Message Attributes][2].
+    # For more information, see [Amazon SNS message attributes][2] and
+    # [Publishing to a mobile phone][3] in the *Amazon SNS Developer Guide.*
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
     # [2]: https://docs.aws.amazon.com/sns/latest/dg/SNSMessageAttributes.html
+    # [3]: https://docs.aws.amazon.com/sns/latest/dg/sms_publish-to-phone.html
     #
     # @note When making an API call, you may pass MessageAttributeValue
     #   data as a hash:
@@ -1241,6 +1370,7 @@ module Aws::SNS
       :data_type,
       :string_value,
       :binary_value)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1253,6 +1383,7 @@ module Aws::SNS
     #
     class NotFoundException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1273,6 +1404,7 @@ module Aws::SNS
     #
     class OptInPhoneNumberInput < Struct.new(
       :phone_number)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1297,6 +1429,7 @@ module Aws::SNS
     class PlatformApplication < Struct.new(
       :platform_application_arn,
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1310,6 +1443,7 @@ module Aws::SNS
     #
     class PlatformApplicationDisabledException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1332,6 +1466,8 @@ module Aws::SNS
     #             binary_value: "data",
     #           },
     #         },
+    #         message_deduplication_id: "String",
+    #         message_group_id: "String",
     #       }
     #
     # @!attribute [rw] topic_arn
@@ -1446,6 +1582,36 @@ module Aws::SNS
     #   Message attributes for Publish action.
     #   @return [Hash<String,Types::MessageAttributeValue>]
     #
+    # @!attribute [rw] message_deduplication_id
+    #   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. 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.
+    #
+    #   If the topic has `ContentBasedDeduplication` set, the system
+    #   generates a `MessageDeduplicationId` based on the contents of the
+    #   message. Your `MessageDeduplicationId` overrides the generated one.
+    #   @return [String]
+    #
+    # @!attribute [rw] 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`.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/PublishInput AWS API Documentation
     #
     class PublishInput < Struct.new(
@@ -1455,7 +1621,10 @@ module Aws::SNS
       :message,
       :subject,
       :message_structure,
-      :message_attributes)
+      :message_attributes,
+      :message_deduplication_id,
+      :message_group_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1467,10 +1636,22 @@ module Aws::SNS
     #   Length Constraint: Maximum 100 characters
     #   @return [String]
     #
+    # @!attribute [rw] sequence_number
+    #   This response element applies only to FIFO (first-in-first-out)
+    #   topics.
+    #
+    #   The sequence number is a large, non-consecutive number that Amazon
+    #   SNS assigns to each message. The length of `SequenceNumber` is 128
+    #   bits. `SequenceNumber` continues to increase for each
+    #   `MessageGroupId`.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/PublishResponse AWS API Documentation
     #
     class PublishResponse < Struct.new(
-      :message_id)
+      :message_id,
+      :sequence_number)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1497,6 +1678,7 @@ module Aws::SNS
     class RemovePermissionInput < Struct.new(
       :topic_arn,
       :label)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1509,6 +1691,7 @@ module Aws::SNS
     #
     class ResourceNotFoundException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1552,6 +1735,7 @@ module Aws::SNS
     class SetEndpointAttributesInput < Struct.new(
       :endpoint_arn,
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1576,26 +1760,28 @@ 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".
+    #     notification 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
@@ -1613,6 +1799,7 @@ module Aws::SNS
     class SetPlatformApplicationAttributesInput < Struct.new(
       :platform_application_arn,
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1716,6 +1903,7 @@ module Aws::SNS
     #
     class SetSMSAttributesInput < Struct.new(
       :attributes)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1744,8 +1932,7 @@ module Aws::SNS
     #   A map of attributes with their corresponding values.
     #
     #   The following lists the names, descriptions, and values of the
-    #   special request parameters that the `SetTopicAttributes` action
-    #   uses:
+    #   special request parameters that this action uses:
     #
     #   * `DeliveryPolicy` – The policy that defines how Amazon SNS retries
     #     failed deliveries to HTTP/S endpoints.
@@ -1766,6 +1953,25 @@ module Aws::SNS
     #     when the service that powers the subscribed endpoint becomes
     #     unavailable) are held in the dead-letter queue for further
     #     analysis or reprocessing.
+    #
+    #   The following attribute applies only to Amazon Kinesis Data Firehose
+    #   delivery stream subscriptions:
+    #
+    #   * `SubscriptionRoleArn` – The ARN of the IAM role that has the
+    #     following:
+    #
+    #     * Permission to write to the Kinesis Data Firehose delivery stream
+    #
+    #     * Amazon SNS listed as a trusted entity
+    #
+    #     Specifying a valid ARN for this attribute is required for Kinesis
+    #     Data Firehose delivery stream subscriptions. For more information,
+    #     see [Fanout to Kinesis Data Firehose delivery streams][1] in the
+    #     *Amazon SNS Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-kinesis-subscriber.html
     #   @return [String]
     #
     # @!attribute [rw] attribute_value
@@ -1778,6 +1984,7 @@ module Aws::SNS
       :subscription_arn,
       :attribute_name,
       :attribute_value)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1816,18 +2023,39 @@ module Aws::SNS
     #   The following attribute applies only to
     #   [server-side-encryption][1]\:
     #
-    #   * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
+    #   * `KmsMasterKeyId` – The ID of an AWS-managed customer master key
     #     (CMK) for Amazon SNS or a custom CMK. For more information, see
     #     [Key Terms][2]. For more examples, see [KeyId][3] in the *AWS Key
     #     Management Service API Reference*.
     #
     #   ^
     #
+    #   The following attribute applies only to [FIFO topics][4]\:
+    #
+    #   * `ContentBasedDeduplication` – Enables content-based deduplication
+    #     for FIFO topics.
+    #
+    #     * By default, `ContentBasedDeduplication` is set to `false`. If
+    #       you create a FIFO topic and this attribute is `false`, you must
+    #       specify a value for the `MessageDeduplicationId` parameter for
+    #       the [Publish][5] action.
+    #
+    #     * When you set `ContentBasedDeduplication` to `true`, Amazon SNS
+    #       uses a SHA-256 hash to generate the `MessageDeduplicationId`
+    #       using the body of the message (but not the attributes of the
+    #       message).
+    #
+    #       (Optional) To override the generated value, you can specify a
+    #       value for the the `MessageDeduplicationId` parameter for the
+    #       `Publish` action.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
     #   [2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
     #   [3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
+    #   [4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
+    #   [5]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
     #   @return [String]
     #
     # @!attribute [rw] attribute_value
@@ -1840,6 +2068,7 @@ module Aws::SNS
       :topic_arn,
       :attribute_name,
       :attribute_value)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1853,6 +2082,7 @@ module Aws::SNS
     #
     class StaleTagException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1876,7 +2106,7 @@ module Aws::SNS
     #   @return [String]
     #
     # @!attribute [rw] protocol
-    #   The protocol you want to use. Supported protocols include:
+    #   The protocol that you want to use. Supported protocols include:
     #
     #   * `http` – delivery of JSON-encoded message via HTTP POST
     #
@@ -1891,37 +2121,43 @@ module Aws::SNS
     #   * `sqs` – delivery of JSON-encoded message to an Amazon SQS queue
     #
     #   * `application` – delivery of JSON-encoded message to an EndpointArn
-    #     for a mobile app and device.
+    #     for a mobile app and device
     #
-    #   * `lambda` – delivery of JSON-encoded message to an Amazon Lambda
-    #     function.
+    #   * `lambda` – delivery of JSON-encoded message to an AWS Lambda
+    #     function
+    #
+    #   * `firehose` – delivery of JSON-encoded message to an Amazon Kinesis
+    #     Data Firehose delivery stream.
     #   @return [String]
     #
     # @!attribute [rw] endpoint
     #   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
+    #   * For the `email` protocol, the endpoint is an email address.
     #
-    #   * For the `email-json` protocol, the endpoint is an email address
+    #   * For the `email-json` protocol, the endpoint is an email address.
     #
     #   * For the `sms` protocol, the endpoint is a phone number of an
-    #     SMS-enabled device
+    #     SMS-enabled device.
     #
     #   * For the `sqs` protocol, the endpoint is the ARN of an Amazon SQS
-    #     queue
+    #     queue.
     #
     #   * 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 Amazon
+    #   * For the `lambda` protocol, the endpoint is the ARN of an AWS
     #     Lambda function.
+    #
+    #   * For the `firehose` protocol, the endpoint is the ARN of an Amazon
+    #     Kinesis Data Firehose delivery stream.
     #   @return [String]
     #
     # @!attribute [rw] attributes
@@ -1950,24 +2186,40 @@ module Aws::SNS
     #     when the service that powers the subscribed endpoint becomes
     #     unavailable) are held in the dead-letter queue for further
     #     analysis or reprocessing.
+    #
+    #   The following attribute applies only to Amazon Kinesis Data Firehose
+    #   delivery stream subscriptions:
+    #
+    #   * `SubscriptionRoleArn` – The ARN of the IAM role that has the
+    #     following:
+    #
+    #     * Permission to write to the Kinesis Data Firehose delivery stream
+    #
+    #     * Amazon SNS listed as a trusted entity
+    #
+    #     Specifying a valid ARN for this attribute is required for Kinesis
+    #     Data Firehose delivery stream subscriptions. For more information,
+    #     see [Fanout to Kinesis Data Firehose delivery streams][1] in the
+    #     *Amazon SNS Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-kinesis-subscriber.html
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] 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 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`.
     #   @return [Boolean]
@@ -1980,6 +2232,7 @@ module Aws::SNS
       :endpoint,
       :attributes,
       :return_subscription_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1997,6 +2250,7 @@ module Aws::SNS
     #
     class SubscribeResponse < Struct.new(
       :subscription_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2030,6 +2284,7 @@ module Aws::SNS
       :protocol,
       :endpoint,
       :topic_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2043,6 +2298,7 @@ module Aws::SNS
     #
     class SubscriptionLimitExceededException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2069,6 +2325,7 @@ module Aws::SNS
     class Tag < Struct.new(
       :key,
       :value)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2081,6 +2338,7 @@ module Aws::SNS
     #
     class TagLimitExceededException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2094,6 +2352,7 @@ module Aws::SNS
     #
     class TagPolicyException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2124,6 +2383,7 @@ module Aws::SNS
     class TagResourceRequest < Struct.new(
       :resource_arn,
       :tags)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2142,6 +2402,7 @@ module Aws::SNS
     #
     class ThrottledException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2156,6 +2417,7 @@ module Aws::SNS
     #
     class Topic < Struct.new(
       :topic_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2169,6 +2431,7 @@ module Aws::SNS
     #
     class TopicLimitExceededException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2189,6 +2452,7 @@ module Aws::SNS
     #
     class UnsubscribeInput < Struct.new(
       :subscription_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -2213,6 +2477,7 @@ module Aws::SNS
     class UntagResourceRequest < Struct.new(
       :resource_arn,
       :tag_keys)
+      SENSITIVE = []
       include Aws::Structure
     end