aws-sdk-sns 1.56.0 → 1.57.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e517ee82c52585fbd4c2414e1788f6479c572cedb40eea6dfa1d502d00711206
-  data.tar.gz: f8b9442b62796acfbdaa0041bf41c66f82b2731cc7d3439341753a51539bf853
+  metadata.gz: '09d96c5064cfda3614ce1c8530e45e99d3dcbafc8063a8ac6077aa8eddea9d00'
+  data.tar.gz: ab592750055fa0bc03b8452295bc4ced0c60bda61ed8bca95a2fe3c61dc92aba
 SHA512:
-  metadata.gz: cecff7f053e5f86e0588f246f05a0eae92f3d8a5a40ebcfe26ac901d83fe5d7e6de71b6b8b2f239ee4af8525b2b34ff174d29b833196b215f40f945778563c4f
-  data.tar.gz: 3954d087958ae0a941af3555bbb58706cc529aecd98ded5915441a3ff584fd24f14a78b88a2440c4ed8e587357f548e9838ff4c2ff271561ddedb63b976ab47c
+  metadata.gz: 01c6e355f17207399c94be20dd2fa5286edd45e07a3b0ade21a33263b970c7dbea182cfd80c6082c44d1fc68e02d9d295184c4a8d8193161fb77900b50cad892
+  data.tar.gz: effe88a806965b33a6f691192a22ea60847ffa93755a5e5dd42c556171cee59de565d649aaa72c44431ebdf232ac02e6b80a40737cc1cb44183af354ce23a9a7

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.57.0 (2022-12-02)
+------------------
+
+* Feature - This release adds the message payload-filtering feature to the SNS Subscribe, SetSubscriptionAttributes, and GetSubscriptionAttributes API actions
+
 1.56.0 (2022-10-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.56.0
+1.57.0

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

@@ -372,6 +372,12 @@ module Aws::SNS
     # for the specified Amazon Web Services accounts to the specified
     # actions.
     #
+    # <note markdown="1"> To remove the ability to change topic permissions, you must deny
+    # permissions to the `AddPermission`, `RemovePermission`, and
+    # `SetTopicAttributes` actions in your IAM policy.
+    #
+    #  </note>
+    #
     # @option params [required, String] :topic_arn
     #   The ARN of the topic whose access control policy you wish to modify.
     #
@@ -720,6 +726,19 @@ module Aws::SNS
     #   * `Policy` – The policy that defines who can access your topic. By
     #     default, only the topic owner can publish or subscribe to the topic.
     #
+    #   * `SignatureVersion` – The signature version corresponds to the
+    #     hashing algorithm used while creating the signature of the
+    #     notifications, subscription confirmations, or unsubscribe
+    #     confirmation messages sent by Amazon SNS. By default,
+    #     `SignatureVersion` is set to 1.
+    #
+    #   * `TracingConfig` – Tracing mode of an Amazon SNS topic. By default
+    #     `TracingConfig` is set to `PassThrough`, and the topic passes
+    #     through the tracing header it receives from an Amazon SNS publisher
+    #     to its subscriptions. If set to Active, Amazon SNS will vend X-Ray
+    #     segment data to topic owner account if the sampled flag in the
+    #     tracing header is true. This is only supported on standard topics.
+    #
     #   The following attribute applies only to [server-side encryption][1]\:
     #
     #   * `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer
@@ -1940,6 +1959,12 @@ module Aws::SNS
 
     # Removes a statement from a topic's access control policy.
     #
+    # <note markdown="1"> To remove the ability to change topic permissions, you must deny
+    # permissions to the `AddPermission`, `RemovePermission`, and
+    # `SetTopicAttributes` actions in your IAM policy.
+    #
+    #  </note>
+    #
     # @option params [required, String] :topic_arn
     #   The ARN of the topic whose access control policy you wish to modify.
     #
@@ -2255,6 +2280,14 @@ module Aws::SNS
     #     receive only a subset of messages, rather than receiving every
     #     message published to the topic.
     #
+    #   * `FilterPolicyScope` – This attribute lets you choose the filtering
+    #     scope by using one of the following string value types:
+    #
+    #     * `MessageAttributes` (default) – The filter is applied on the
+    #       message attributes.
+    #
+    #     * `MessageBody` – The filter is applied on the message body.
+    #
     #   * `RawMessageDelivery` – When set to `true`, enables raw message
     #     delivery to Amazon SQS or HTTP/S endpoints. This eliminates the need
     #     for the endpoints to process JSON formatting, which is otherwise
@@ -2310,6 +2343,12 @@ module Aws::SNS
 
     # Allows a topic owner to set an attribute of the topic to a new value.
     #
+    # <note markdown="1"> To remove the ability to change topic permissions, you must deny
+    # permissions to the `AddPermission`, `RemovePermission`, and
+    # `SetTopicAttributes` actions in your IAM policy.
+    #
+    #  </note>
+    #
     # @option params [required, String] :topic_arn
     #   The ARN of the topic to modify.
     #
@@ -2328,6 +2367,13 @@ module Aws::SNS
     #   * `Policy` – The policy that defines who can access your topic. By
     #     default, only the topic owner can publish or subscribe to the topic.
     #
+    #   * `TracingConfig` – Tracing mode of an Amazon SNS topic. By default
+    #     `TracingConfig` is set to `PassThrough`, and the topic passes
+    #     through the tracing header it receives from an Amazon SNS publisher
+    #     to its subscriptions. If set to Active, Amazon SNS will vend X-Ray
+    #     segment data to topic owner account if the sampled flag in the
+    #     tracing header is true. This is only supported on standard topics.
+    #
     #   The following attribute applies only to [server-side-encryption][1]\:
     #
     #   * `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer
@@ -2335,7 +2381,10 @@ module Aws::SNS
     #     information, see [Key Terms][2]. For more examples, see [KeyId][3]
     #     in the *Key Management Service API Reference*.
     #
-    #   ^
+    #   * `SignatureVersion` – The signature version corresponds to the
+    #     hashing algorithm used while creating the signature of the
+    #     notifications, subscription confirmations, or unsubscribe
+    #     confirmation messages sent by Amazon SNS.
     #
     #   The following attribute applies only to [FIFO topics][4]\:
     #
@@ -2463,6 +2512,14 @@ module Aws::SNS
     #     receive only a subset of messages, rather than receiving every
     #     message published to the topic.
     #
+    #   * `FilterPolicyScope` – This attribute lets you choose the filtering
+    #     scope by using one of the following string value types:
+    #
+    #     * `MessageAttributes` (default) – The filter is applied on the
+    #       message attributes.
+    #
+    #     * `MessageBody` – The filter is applied on the message body.
+    #
     #   * `RawMessageDelivery` – When set to `true`, enables raw message
     #     delivery to Amazon SQS or HTTP/S endpoints. This eliminates the need
     #     for the endpoints to process JSON formatting, which is otherwise
@@ -2600,6 +2657,12 @@ module Aws::SNS
     # is delivered to the endpoint, so that the endpoint owner can easily
     # resubscribe to the topic if the `Unsubscribe` request was unintended.
     #
+    # <note markdown="1"> Amazon SQS queue subscriptions require authentication for deletion.
+    # Only the owner of the subscription, or the owner of the topic can
+    # unsubscribe using the required Amazon Web Services signature.
+    #
+    #  </note>
+    #
     # This action is throttled at 100 transactions per second (TPS).
     #
     # @option params [required, String] :subscription_arn
@@ -2708,7 +2771,7 @@ module Aws::SNS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-sns'
-      context[:gem_version] = '1.56.0'
+      context[:gem_version] = '1.57.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -86,12 +86,12 @@ QXR0ciIsImFyZ3YiOlt7InJlZiI6IlBhcnRpdGlvblJlc3VsdCJ9LCJzdXBw
 b3J0c0ZJUFMiXX1dfV0sInR5cGUiOiJ0cmVlIiwicnVsZXMiOlt7ImNvbmRp
 dGlvbnMiOltdLCJ0eXBlIjoidHJlZSIsInJ1bGVzIjpbeyJjb25kaXRpb25z
 IjpbeyJmbiI6InN0cmluZ0VxdWFscyIsImFyZ3YiOlt7InJlZiI6IlJlZ2lv
-biJ9LCJ1cy1nb3Ytd2VzdC0xIl19XSwiZW5kcG9pbnQiOnsidXJsIjoiaHR0
-cHM6Ly9zbnMudXMtZ292LXdlc3QtMS5hbWF6b25hd3MuY29tIiwicHJvcGVy
+biJ9LCJ1cy1nb3YtZWFzdC0xIl19XSwiZW5kcG9pbnQiOnsidXJsIjoiaHR0
+cHM6Ly9zbnMudXMtZ292LWVhc3QtMS5hbWF6b25hd3MuY29tIiwicHJvcGVy
 dGllcyI6e30sImhlYWRlcnMiOnt9fSwidHlwZSI6ImVuZHBvaW50In0seyJj
 b25kaXRpb25zIjpbeyJmbiI6InN0cmluZ0VxdWFscyIsImFyZ3YiOlt7InJl
-ZiI6IlJlZ2lvbiJ9LCJ1cy1nb3YtZWFzdC0xIl19XSwiZW5kcG9pbnQiOnsi
-dXJsIjoiaHR0cHM6Ly9zbnMudXMtZ292LWVhc3QtMS5hbWF6b25hd3MuY29t
+ZiI6IlJlZ2lvbiJ9LCJ1cy1nb3Ytd2VzdC0xIl19XSwiZW5kcG9pbnQiOnsi
+dXJsIjoiaHR0cHM6Ly9zbnMudXMtZ292LXdlc3QtMS5hbWF6b25hd3MuY29t
 IiwicHJvcGVydGllcyI6e30sImhlYWRlcnMiOnt9fSwidHlwZSI6ImVuZHBv
 aW50In0seyJjb25kaXRpb25zIjpbXSwiZW5kcG9pbnQiOnsidXJsIjoiaHR0
 cHM6Ly9zbnMtZmlwcy57UmVnaW9ufS57UGFydGl0aW9uUmVzdWx0I2Ruc1N1

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

@@ -110,6 +110,19 @@ module Aws::SNS
     #   * `Policy` – The policy that defines who can access your topic. By
     #     default, only the topic owner can publish or subscribe to the topic.
     #
+    #   * `SignatureVersion` – The signature version corresponds to the
+    #     hashing algorithm used while creating the signature of the
+    #     notifications, subscription confirmations, or unsubscribe
+    #     confirmation messages sent by Amazon SNS. By default,
+    #     `SignatureVersion` is set to 1.
+    #
+    #   * `TracingConfig` – Tracing mode of an Amazon SNS topic. By default
+    #     `TracingConfig` is set to `PassThrough`, and the topic passes
+    #     through the tracing header it receives from an Amazon SNS publisher
+    #     to its subscriptions. If set to Active, Amazon SNS will vend X-Ray
+    #     segment data to topic owner account if the sampled flag in the
+    #     tracing header is true. This is only supported on standard topics.
+    #
     #   The following attribute applies only to [server-side encryption][1]\:
     #
     #   * `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer

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

@@ -51,6 +51,14 @@ module Aws::SNS
     #   subscription. For more information, see [Amazon SNS Message
     #   Filtering][1] in the *Amazon SNS Developer Guide*.
     #
+    # * `FilterPolicyScope` – This attribute lets you choose the filtering
+    #   scope by using one of the following string value types:
+    #
+    #   * `MessageAttributes` (default) – The filter is applied on the
+    #     message attributes.
+    #
+    #   * `MessageBody` – The filter is applied on the message body.
+    #
     # * `Owner` – The Amazon Web Services account ID of the subscription's
     #   owner.
     #
@@ -165,6 +173,14 @@ module Aws::SNS
     #     receive only a subset of messages, rather than receiving every
     #     message published to the topic.
     #
+    #   * `FilterPolicyScope` – This attribute lets you choose the filtering
+    #     scope by using one of the following string value types:
+    #
+    #     * `MessageAttributes` (default) – The filter is applied on the
+    #       message attributes.
+    #
+    #     * `MessageBody` – The filter is applied on the message body.
+    #
     #   * `RawMessageDelivery` – When set to `true`, enables raw message
     #     delivery to Amazon SQS or HTTP/S endpoints. This eliminates the need
     #     for the endpoints to process JSON formatting, which is otherwise

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

@@ -43,11 +43,29 @@ module Aws::SNS
     # * `DisplayName` – The human-readable name used in the `From` field for
     #   notifications to `email` and `email-json` endpoints.
     #
+    # * `EffectiveDeliveryPolicy` – The JSON serialization of the effective
+    #   delivery policy, taking system defaults into account.
+    #
     # * `Owner` – The Amazon Web Services account ID of the topic's owner.
     #
     # * `Policy` – The JSON serialization of the topic's access control
     #   policy.
     #
+    # * `SignatureVersion` – The version of the Amazon SNS signature used
+    #   for the topic.
+    #
+    #   * By default, `SignatureVersion` is set to **1**. The signature is a
+    #     Base64-encoded **SHA1withRSA** signature.
+    #
+    #   * When you set `SignatureVersion` to **2**. Amazon SNS uses a
+    #     Base64-encoded **SHA256withRSA** signature.
+    #
+    #     <note markdown="1"> If the API response does not include the `SignatureVersion`
+    #     attribute, it means that the `SignatureVersion` for the topic has
+    #     value **1**.
+    #
+    #      </note>
+    #
     # * `SubscriptionsConfirmed` – The number of confirmed subscriptions for
     #   the topic.
     #
@@ -59,8 +77,12 @@ module Aws::SNS
     #
     # * `TopicArn` – The topic's ARN.
     #
-    # * `EffectiveDeliveryPolicy` – The JSON serialization of the effective
-    #   delivery policy, taking system defaults into account.
+    # * `TracingConfig` – Tracing mode of an Amazon SNS topic. By default
+    #   `TracingConfig` is set to `PassThrough`, and the topic passes
+    #   through the tracing header it receives from an Amazon SNS publisher
+    #   to its subscriptions. If set to Active, Amazon SNS will vend X-Ray
+    #   segment data to topic owner account if the sampled flag in the
+    #   tracing header is true. This is only supported on standard topics.
     #
     # The following attribute applies only to [server-side-encryption][1]\:
     #
@@ -380,6 +402,13 @@ module Aws::SNS
     #   * `Policy` – The policy that defines who can access your topic. By
     #     default, only the topic owner can publish or subscribe to the topic.
     #
+    #   * `TracingConfig` – Tracing mode of an Amazon SNS topic. By default
+    #     `TracingConfig` is set to `PassThrough`, and the topic passes
+    #     through the tracing header it receives from an Amazon SNS publisher
+    #     to its subscriptions. If set to Active, Amazon SNS will vend X-Ray
+    #     segment data to topic owner account if the sampled flag in the
+    #     tracing header is true. This is only supported on standard topics.
+    #
     #   The following attribute applies only to [server-side-encryption][1]\:
     #
     #   * `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer
@@ -387,7 +416,10 @@ module Aws::SNS
     #     information, see [Key Terms][2]. For more examples, see [KeyId][3]
     #     in the *Key Management Service API Reference*.
     #
-    #   ^
+    #   * `SignatureVersion` – The signature version corresponds to the
+    #     hashing algorithm used while creating the signature of the
+    #     notifications, subscription confirmations, or unsubscribe
+    #     confirmation messages sent by Amazon SNS.
     #
     #   The following attribute applies only to [FIFO topics][4]\:
     #
@@ -497,6 +529,14 @@ module Aws::SNS
     #     receive only a subset of messages, rather than receiving every
     #     message published to the topic.
     #
+    #   * `FilterPolicyScope` – This attribute lets you choose the filtering
+    #     scope by using one of the following string value types:
+    #
+    #     * `MessageAttributes` (default) – The filter is applied on the
+    #       message attributes.
+    #
+    #     * `MessageBody` – The filter is applied on the message body.
+    #
     #   * `RawMessageDelivery` – When set to `true`, enables raw message
     #     delivery to Amazon SQS or HTTP/S endpoints. This eliminates the need
     #     for the endpoints to process JSON formatting, which is otherwise

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

@@ -10,16 +10,6 @@
 module Aws::SNS
   module Types
 
-    # @note When making an API call, you may pass AddPermissionInput
-    #   data as a hash:
-    #
-    #       {
-    #         topic_arn: "topicARN", # required
-    #         label: "label", # required
-    #         aws_account_id: ["delegate"], # required
-    #         action_name: ["action"], # required
-    #       }
-    #
     # @!attribute [rw] topic_arn
     #   The ARN of the topic whose access control policy you wish to modify.
     #   @return [String]
@@ -125,13 +115,6 @@ module Aws::SNS
 
     # The input for the `CheckIfPhoneNumberIsOptedOut` action.
     #
-    # @note When making an API call, you may pass CheckIfPhoneNumberIsOptedOutInput
-    #   data as a hash:
-    #
-    #       {
-    #         phone_number: "PhoneNumber", # required
-    #       }
-    #
     # @!attribute [rw] phone_number
     #   The phone number for which you want to check the opt out status.
     #   @return [String]
@@ -180,15 +163,6 @@ module Aws::SNS
 
     # Input for ConfirmSubscription action.
     #
-    # @note When making an API call, you may pass ConfirmSubscriptionInput
-    #   data as a hash:
-    #
-    #       {
-    #         topic_arn: "topicARN", # required
-    #         token: "token", # required
-    #         authenticate_on_unsubscribe: "authenticateOnUnsubscribe",
-    #       }
-    #
     # @!attribute [rw] topic_arn
     #   The ARN of the topic for which you wish to confirm a subscription.
     #   @return [String]
@@ -245,17 +219,6 @@ module Aws::SNS
 
     # Input for CreatePlatformApplication action.
     #
-    # @note When making an API call, you may pass CreatePlatformApplicationInput
-    #   data as a hash:
-    #
-    #       {
-    #         name: "String", # required
-    #         platform: "String", # required
-    #         attributes: { # required
-    #           "String" => "String",
-    #         },
-    #       }
-    #
     # @!attribute [rw] name
     #   Application names must be made up of only uppercase and lowercase
     #   ASCII letters, numbers, underscores, hyphens, and periods, and must
@@ -302,18 +265,6 @@ module Aws::SNS
 
     # Input for CreatePlatformEndpoint action.
     #
-    # @note When making an API call, you may pass CreatePlatformEndpointInput
-    #   data as a hash:
-    #
-    #       {
-    #         platform_application_arn: "String", # required
-    #         token: "String", # required
-    #         custom_user_data: "String",
-    #         attributes: {
-    #           "String" => "String",
-    #         },
-    #       }
-    #
     # @!attribute [rw] platform_application_arn
     #   PlatformApplicationArn returned from CreatePlatformApplication is
     #   used to create a an endpoint.
@@ -353,14 +304,6 @@ module Aws::SNS
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass CreateSMSSandboxPhoneNumberInput
-    #   data as a hash:
-    #
-    #       {
-    #         phone_number: "PhoneNumberString", # required
-    #         language_code: "en-US", # accepts en-US, en-GB, es-419, es-ES, de-DE, fr-CA, fr-FR, it-IT, ja-JP, pt-BR, kr-KR, zh-CN, zh-TW
-    #       }
-    #
     # @!attribute [rw] phone_number
     #   The destination phone number to verify. On verification, Amazon SNS
     #   adds this phone number to the list of verified phone numbers that
@@ -387,23 +330,6 @@ module Aws::SNS
 
     # Input for CreateTopic action.
     #
-    # @note When making an API call, you may pass CreateTopicInput
-    #   data as a hash:
-    #
-    #       {
-    #         name: "topicName", # required
-    #         attributes: {
-    #           "attributeName" => "attributeValue",
-    #         },
-    #         tags: [
-    #           {
-    #             key: "TagKey", # required
-    #             value: "TagValue", # required
-    #           },
-    #         ],
-    #         data_protection_policy: "attributeValue",
-    #       }
-    #
     # @!attribute [rw] name
     #   The name of the topic you want to create.
     #
@@ -433,6 +359,20 @@ module Aws::SNS
     #     default, only the topic owner can publish or subscribe to the
     #     topic.
     #
+    #   * `SignatureVersion` – The signature version corresponds to the
+    #     hashing algorithm used while creating the signature of the
+    #     notifications, subscription confirmations, or unsubscribe
+    #     confirmation messages sent by Amazon SNS. By default,
+    #     `SignatureVersion` is set to 1.
+    #
+    #   * `TracingConfig` – Tracing mode of an Amazon SNS topic. By default
+    #     `TracingConfig` is set to `PassThrough`, and the topic passes
+    #     through the tracing header it receives from an Amazon SNS
+    #     publisher to its subscriptions. If set to Active, Amazon SNS will
+    #     vend X-Ray segment data to topic owner account if the sampled flag
+    #     in the tracing header is true. This is only supported on standard
+    #     topics.
+    #
     #   The following attribute applies only to [server-side
     #   encryption][1]\:
     #
@@ -519,13 +459,6 @@ module Aws::SNS
 
     # Input for DeleteEndpoint action.
     #
-    # @note When making an API call, you may pass DeleteEndpointInput
-    #   data as a hash:
-    #
-    #       {
-    #         endpoint_arn: "String", # required
-    #       }
-    #
     # @!attribute [rw] endpoint_arn
     #   EndpointArn of endpoint to delete.
     #   @return [String]
@@ -540,13 +473,6 @@ module Aws::SNS
 
     # Input for DeletePlatformApplication action.
     #
-    # @note When making an API call, you may pass DeletePlatformApplicationInput
-    #   data as a hash:
-    #
-    #       {
-    #         platform_application_arn: "String", # required
-    #       }
-    #
     # @!attribute [rw] platform_application_arn
     #   PlatformApplicationArn of platform application object to delete.
     #   @return [String]
@@ -559,13 +485,6 @@ module Aws::SNS
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass DeleteSMSSandboxPhoneNumberInput
-    #   data as a hash:
-    #
-    #       {
-    #         phone_number: "PhoneNumberString", # required
-    #       }
-    #
     # @!attribute [rw] phone_number
     #   The destination phone number to delete.
     #   @return [String]
@@ -582,13 +501,6 @@ module Aws::SNS
     #
     class DeleteSMSSandboxPhoneNumberResult < Aws::EmptyStructure; end
 
-    # @note When making an API call, you may pass DeleteTopicInput
-    #   data as a hash:
-    #
-    #       {
-    #         topic_arn: "topicARN", # required
-    #       }
-    #
     # @!attribute [rw] topic_arn
     #   The ARN of the topic you want to delete.
     #   @return [String]
@@ -663,13 +575,6 @@ module Aws::SNS
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetDataProtectionPolicyInput
-    #   data as a hash:
-    #
-    #       {
-    #         resource_arn: "topicARN", # required
-    #       }
-    #
     # @!attribute [rw] resource_arn
     #   The ARN of the topic whose `DataProtectionPolicy` you want to get.
     #
@@ -703,13 +608,6 @@ module Aws::SNS
 
     # Input for GetEndpointAttributes action.
     #
-    # @note When making an API call, you may pass GetEndpointAttributesInput
-    #   data as a hash:
-    #
-    #       {
-    #         endpoint_arn: "String", # required
-    #       }
-    #
     # @!attribute [rw] endpoint_arn
     #   EndpointArn for GetEndpointAttributes input.
     #   @return [String]
@@ -756,13 +654,6 @@ module Aws::SNS
 
     # Input for GetPlatformApplicationAttributes action.
     #
-    # @note When making an API call, you may pass GetPlatformApplicationAttributesInput
-    #   data as a hash:
-    #
-    #       {
-    #         platform_application_arn: "String", # required
-    #       }
-    #
     # @!attribute [rw] platform_application_arn
     #   PlatformApplicationArn for GetPlatformApplicationAttributesInput.
     #   @return [String]
@@ -813,13 +704,6 @@ module Aws::SNS
 
     # The input for the `GetSMSAttributes` request.
     #
-    # @note When making an API call, you may pass GetSMSAttributesInput
-    #   data as a hash:
-    #
-    #       {
-    #         attributes: ["String"],
-    #       }
-    #
     # @!attribute [rw] attributes
     #   A list of the individual attribute names, such as
     #   `MonthlySpendLimit`, for which you want values.
@@ -877,13 +761,6 @@ module Aws::SNS
 
     # Input for GetSubscriptionAttributes.
     #
-    # @note When making an API call, you may pass GetSubscriptionAttributesInput
-    #   data as a hash:
-    #
-    #       {
-    #         subscription_arn: "subscriptionARN", # required
-    #       }
-    #
     # @!attribute [rw] subscription_arn
     #   The ARN of the subscription whose properties you want to get.
     #   @return [String]
@@ -916,6 +793,14 @@ module Aws::SNS
     #     subscription. For more information, see [Amazon SNS Message
     #     Filtering][1] in the *Amazon SNS Developer Guide*.
     #
+    #   * `FilterPolicyScope` – This attribute lets you choose the filtering
+    #     scope by using one of the following string value types:
+    #
+    #     * `MessageAttributes` (default) – The filter is applied on the
+    #       message attributes.
+    #
+    #     * `MessageBody` – The filter is applied on the message body.
+    #
     #   * `Owner` – The Amazon Web Services account ID of the
     #     subscription's owner.
     #
@@ -971,13 +856,6 @@ module Aws::SNS
 
     # Input for GetTopicAttributes action.
     #
-    # @note When making an API call, you may pass GetTopicAttributesInput
-    #   data as a hash:
-    #
-    #       {
-    #         topic_arn: "topicARN", # required
-    #       }
-    #
     # @!attribute [rw] topic_arn
     #   The ARN of the topic whose properties you want to get.
     #   @return [String]
@@ -1002,12 +880,30 @@ module Aws::SNS
     #   * `DisplayName` – The human-readable name used in the `From` field
     #     for notifications to `email` and `email-json` endpoints.
     #
+    #   * `EffectiveDeliveryPolicy` – The JSON serialization of the
+    #     effective delivery policy, taking system defaults into account.
+    #
     #   * `Owner` – The Amazon Web Services account ID of the topic's
     #     owner.
     #
     #   * `Policy` – The JSON serialization of the topic's access control
     #     policy.
     #
+    #   * `SignatureVersion` – The version of the Amazon SNS signature used
+    #     for the topic.
+    #
+    #     * By default, `SignatureVersion` is set to **1**. The signature is
+    #       a Base64-encoded **SHA1withRSA** signature.
+    #
+    #     * When you set `SignatureVersion` to **2**. Amazon SNS uses a
+    #       Base64-encoded **SHA256withRSA** signature.
+    #
+    #       <note markdown="1"> If the API response does not include the `SignatureVersion`
+    #       attribute, it means that the `SignatureVersion` for the topic
+    #       has value **1**.
+    #
+    #        </note>
+    #
     #   * `SubscriptionsConfirmed` – The number of confirmed subscriptions
     #     for the topic.
     #
@@ -1019,8 +915,13 @@ module Aws::SNS
     #
     #   * `TopicArn` – The topic's ARN.
     #
-    #   * `EffectiveDeliveryPolicy` – The JSON serialization of the
-    #     effective delivery policy, taking system defaults into account.
+    #   * `TracingConfig` – Tracing mode of an Amazon SNS topic. By default
+    #     `TracingConfig` is set to `PassThrough`, and the topic passes
+    #     through the tracing header it receives from an Amazon SNS
+    #     publisher to its subscriptions. If set to Active, Amazon SNS will
+    #     vend X-Ray segment data to topic owner account if the sampled flag
+    #     in the tracing header is true. This is only supported on standard
+    #     topics.
     #
     #   The following attribute applies only to
     #   [server-side-encryption][1]\:
@@ -1238,14 +1139,6 @@ module Aws::SNS
 
     # Input for ListEndpointsByPlatformApplication action.
     #
-    # @note When making an API call, you may pass ListEndpointsByPlatformApplicationInput
-    #   data as a hash:
-    #
-    #       {
-    #         platform_application_arn: "String", # required
-    #         next_token: "String",
-    #       }
-    #
     # @!attribute [rw] platform_application_arn
     #   PlatformApplicationArn for ListEndpointsByPlatformApplicationInput
     #   action.
@@ -1287,14 +1180,6 @@ module Aws::SNS
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass ListOriginationNumbersRequest
-    #   data as a hash:
-    #
-    #       {
-    #         next_token: "nextToken",
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] next_token
     #   Token that the previous `ListOriginationNumbers` request returns.
     #   @return [String]
@@ -1334,13 +1219,6 @@ module Aws::SNS
 
     # The input for the `ListPhoneNumbersOptedOut` action.
     #
-    # @note When making an API call, you may pass ListPhoneNumbersOptedOutInput
-    #   data as a hash:
-    #
-    #       {
-    #         next_token: "string",
-    #       }
-    #
     # @!attribute [rw] next_token
     #   A `NextToken` string is used when you call the
     #   `ListPhoneNumbersOptedOut` action to retrieve additional records
@@ -1380,13 +1258,6 @@ module Aws::SNS
 
     # Input for ListPlatformApplications action.
     #
-    # @note When making an API call, you may pass ListPlatformApplicationsInput
-    #   data as a hash:
-    #
-    #       {
-    #         next_token: "String",
-    #       }
-    #
     # @!attribute [rw] next_token
     #   NextToken string is used when calling ListPlatformApplications
     #   action to retrieve additional records that are available after the
@@ -1423,14 +1294,6 @@ module Aws::SNS
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass ListSMSSandboxPhoneNumbersInput
-    #   data as a hash:
-    #
-    #       {
-    #         next_token: "nextToken",
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] next_token
     #   Token that the previous `ListSMSSandboxPhoneNumbersInput` request
     #   returns.
@@ -1470,14 +1333,6 @@ module Aws::SNS
 
     # Input for ListSubscriptionsByTopic action.
     #
-    # @note When making an API call, you may pass ListSubscriptionsByTopicInput
-    #   data as a hash:
-    #
-    #       {
-    #         topic_arn: "topicARN", # required
-    #         next_token: "nextToken",
-    #       }
-    #
     # @!attribute [rw] topic_arn
     #   The ARN of the topic for which you wish to find subscriptions.
     #   @return [String]
@@ -1518,13 +1373,6 @@ module Aws::SNS
 
     # Input for ListSubscriptions action.
     #
-    # @note When making an API call, you may pass ListSubscriptionsInput
-    #   data as a hash:
-    #
-    #       {
-    #         next_token: "nextToken",
-    #       }
-    #
     # @!attribute [rw] next_token
     #   Token returned by the previous `ListSubscriptions` request.
     #   @return [String]
@@ -1557,13 +1405,6 @@ module Aws::SNS
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass ListTagsForResourceRequest
-    #   data as a hash:
-    #
-    #       {
-    #         resource_arn: "AmazonResourceName", # required
-    #       }
-    #
     # @!attribute [rw] resource_arn
     #   The ARN of the topic for which to list tags.
     #   @return [String]
@@ -1588,13 +1429,6 @@ module Aws::SNS
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass ListTopicsInput
-    #   data as a hash:
-    #
-    #       {
-    #         next_token: "nextToken",
-    #       }
-    #
     # @!attribute [rw] next_token
     #   Token returned by the previous `ListTopics` request.
     #   @return [String]
@@ -1644,15 +1478,6 @@ module Aws::SNS
     # [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:
-    #
-    #       {
-    #         data_type: "String", # required
-    #         string_value: "String",
-    #         binary_value: "data",
-    #       }
-    #
     # @!attribute [rw] data_type
     #   Amazon SNS supports the following logical data types: String,
     #   String.Array, Number, and Binary. For more information, see [Message
@@ -1702,13 +1527,6 @@ module Aws::SNS
 
     # Input for the OptInPhoneNumber action.
     #
-    # @note When making an API call, you may pass OptInPhoneNumberInput
-    #   data as a hash:
-    #
-    #       {
-    #         phone_number: "PhoneNumber", # required
-    #       }
-    #
     # @!attribute [rw] phone_number
     #   The phone number to opt in. Use E.164 format.
     #   @return [String]
@@ -1815,30 +1633,6 @@ module Aws::SNS
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass PublishBatchInput
-    #   data as a hash:
-    #
-    #       {
-    #         topic_arn: "topicARN", # required
-    #         publish_batch_request_entries: [ # required
-    #           {
-    #             id: "String", # required
-    #             message: "message", # required
-    #             subject: "subject",
-    #             message_structure: "messageStructure",
-    #             message_attributes: {
-    #               "String" => {
-    #                 data_type: "String", # required
-    #                 string_value: "String",
-    #                 binary_value: "data",
-    #               },
-    #             },
-    #             message_deduplication_id: "String",
-    #             message_group_id: "String",
-    #           },
-    #         ],
-    #       }
-    #
     # @!attribute [rw] topic_arn
     #   The Amazon resource name (ARN) of the topic you want to batch
     #   publish to.
@@ -1861,25 +1655,6 @@ module Aws::SNS
     # Contains the details of a single Amazon SNS message along with an `Id`
     # that identifies a message within the batch.
     #
-    # @note When making an API call, you may pass PublishBatchRequestEntry
-    #   data as a hash:
-    #
-    #       {
-    #         id: "String", # required
-    #         message: "message", # required
-    #         subject: "subject",
-    #         message_structure: "messageStructure",
-    #         message_attributes: {
-    #           "String" => {
-    #             data_type: "String", # required
-    #             string_value: "String",
-    #             binary_value: "data",
-    #           },
-    #         },
-    #         message_deduplication_id: "String",
-    #         message_group_id: "String",
-    #       }
-    #
     # @!attribute [rw] id
     #   An identifier for the message in this batch.
     #
@@ -2071,27 +1846,6 @@ module Aws::SNS
 
     # Input for Publish action.
     #
-    # @note When making an API call, you may pass PublishInput
-    #   data as a hash:
-    #
-    #       {
-    #         topic_arn: "topicARN",
-    #         target_arn: "String",
-    #         phone_number: "String",
-    #         message: "message", # required
-    #         subject: "subject",
-    #         message_structure: "messageStructure",
-    #         message_attributes: {
-    #           "String" => {
-    #             data_type: "String", # required
-    #             string_value: "String",
-    #             binary_value: "data",
-    #           },
-    #         },
-    #         message_deduplication_id: "String",
-    #         message_group_id: "String",
-    #       }
-    #
     # @!attribute [rw] topic_arn
     #   The topic you want to publish to.
     #
@@ -2277,14 +2031,6 @@ module Aws::SNS
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass PutDataProtectionPolicyInput
-    #   data as a hash:
-    #
-    #       {
-    #         resource_arn: "topicARN", # required
-    #         data_protection_policy: "attributeValue", # required
-    #       }
-    #
     # @!attribute [rw] resource_arn
     #   The ARN of the topic whose `DataProtectionPolicy` you want to add or
     #   update.
@@ -2316,14 +2062,6 @@ module Aws::SNS
 
     # Input for RemovePermission action.
     #
-    # @note When making an API call, you may pass RemovePermissionInput
-    #   data as a hash:
-    #
-    #       {
-    #         topic_arn: "topicARN", # required
-    #         label: "label", # required
-    #       }
-    #
     # @!attribute [rw] topic_arn
     #   The ARN of the topic whose access control policy you wish to modify.
     #   @return [String]
@@ -2390,16 +2128,6 @@ module Aws::SNS
 
     # Input for SetEndpointAttributes action.
     #
-    # @note When making an API call, you may pass SetEndpointAttributesInput
-    #   data as a hash:
-    #
-    #       {
-    #         endpoint_arn: "String", # required
-    #         attributes: { # required
-    #           "String" => "String",
-    #         },
-    #       }
-    #
     # @!attribute [rw] endpoint_arn
     #   EndpointArn used for SetEndpointAttributes action.
     #   @return [String]
@@ -2434,16 +2162,6 @@ module Aws::SNS
 
     # Input for SetPlatformApplicationAttributes action.
     #
-    # @note When making an API call, you may pass SetPlatformApplicationAttributesInput
-    #   data as a hash:
-    #
-    #       {
-    #         platform_application_arn: "String", # required
-    #         attributes: { # required
-    #           "String" => "String",
-    #         },
-    #       }
-    #
     # @!attribute [rw] platform_application_arn
     #   PlatformApplicationArn for SetPlatformApplicationAttributes action.
     #   @return [String]
@@ -2525,15 +2243,6 @@ module Aws::SNS
 
     # The input for the SetSMSAttributes action.
     #
-    # @note When making an API call, you may pass SetSMSAttributesInput
-    #   data as a hash:
-    #
-    #       {
-    #         attributes: { # required
-    #           "String" => "String",
-    #         },
-    #       }
-    #
     # @!attribute [rw] attributes
     #   The default settings for sending SMS messages from your Amazon Web
     #   Services account. You can set values for the following attribute
@@ -2636,15 +2345,6 @@ module Aws::SNS
 
     # Input for SetSubscriptionAttributes action.
     #
-    # @note When making an API call, you may pass SetSubscriptionAttributesInput
-    #   data as a hash:
-    #
-    #       {
-    #         subscription_arn: "subscriptionARN", # required
-    #         attribute_name: "attributeName", # required
-    #         attribute_value: "attributeValue",
-    #       }
-    #
     # @!attribute [rw] subscription_arn
     #   The ARN of the subscription to modify.
     #   @return [String]
@@ -2662,6 +2362,14 @@ module Aws::SNS
     #     receive only a subset of messages, rather than receiving every
     #     message published to the topic.
     #
+    #   * `FilterPolicyScope` – This attribute lets you choose the filtering
+    #     scope by using one of the following string value types:
+    #
+    #     * `MessageAttributes` (default) – The filter is applied on the
+    #       message attributes.
+    #
+    #     * `MessageBody` – The filter is applied on the message body.
+    #
     #   * `RawMessageDelivery` – When set to `true`, enables raw message
     #     delivery to Amazon SQS or HTTP/S endpoints. This eliminates the
     #     need for the endpoints to process JSON formatting, which is
@@ -2711,15 +2419,6 @@ module Aws::SNS
 
     # Input for SetTopicAttributes action.
     #
-    # @note When making an API call, you may pass SetTopicAttributesInput
-    #   data as a hash:
-    #
-    #       {
-    #         topic_arn: "topicARN", # required
-    #         attribute_name: "attributeName", # required
-    #         attribute_value: "attributeValue",
-    #       }
-    #
     # @!attribute [rw] topic_arn
     #   The ARN of the topic to modify.
     #   @return [String]
@@ -2741,6 +2440,14 @@ module Aws::SNS
     #     default, only the topic owner can publish or subscribe to the
     #     topic.
     #
+    #   * `TracingConfig` – Tracing mode of an Amazon SNS topic. By default
+    #     `TracingConfig` is set to `PassThrough`, and the topic passes
+    #     through the tracing header it receives from an Amazon SNS
+    #     publisher to its subscriptions. If set to Active, Amazon SNS will
+    #     vend X-Ray segment data to topic owner account if the sampled flag
+    #     in the tracing header is true. This is only supported on standard
+    #     topics.
+    #
     #   The following attribute applies only to
     #   [server-side-encryption][1]\:
     #
@@ -2749,7 +2456,10 @@ module Aws::SNS
     #     information, see [Key Terms][2]. For more examples, see [KeyId][3]
     #     in the *Key Management Service API Reference*.
     #
-    #   ^
+    #   * `SignatureVersion` – The signature version corresponds to the
+    #     hashing algorithm used while creating the signature of the
+    #     notifications, subscription confirmations, or unsubscribe
+    #     confirmation messages sent by Amazon SNS.
     #
     #   The following attribute applies only to [FIFO topics][4]\:
     #
@@ -2809,19 +2519,6 @@ module Aws::SNS
 
     # Input for Subscribe action.
     #
-    # @note When making an API call, you may pass SubscribeInput
-    #   data as a hash:
-    #
-    #       {
-    #         topic_arn: "topicARN", # required
-    #         protocol: "protocol", # required
-    #         endpoint: "endpoint",
-    #         attributes: {
-    #           "attributeName" => "attributeValue",
-    #         },
-    #         return_subscription_arn: false,
-    #       }
-    #
     # @!attribute [rw] topic_arn
     #   The ARN of the topic you want to subscribe to.
     #   @return [String]
@@ -2893,6 +2590,14 @@ module Aws::SNS
     #     receive only a subset of messages, rather than receiving every
     #     message published to the topic.
     #
+    #   * `FilterPolicyScope` – This attribute lets you choose the filtering
+    #     scope by using one of the following string value types:
+    #
+    #     * `MessageAttributes` (default) – The filter is applied on the
+    #       message attributes.
+    #
+    #     * `MessageBody` – The filter is applied on the message body.
+    #
     #   * `RawMessageDelivery` – When set to `true`, enables raw message
     #     delivery to Amazon SQS or HTTP/S endpoints. This eliminates the
     #     need for the endpoints to process JSON formatting, which is
@@ -3023,14 +2728,6 @@ module Aws::SNS
 
     # The list of tags to be added to the specified topic.
     #
-    # @note When making an API call, you may pass Tag
-    #   data as a hash:
-    #
-    #       {
-    #         key: "TagKey", # required
-    #         value: "TagValue", # required
-    #       }
-    #
     # @!attribute [rw] key
     #   The required key portion of the tag.
     #   @return [String]
@@ -3075,19 +2772,6 @@ module Aws::SNS
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass TagResourceRequest
-    #   data as a hash:
-    #
-    #       {
-    #         resource_arn: "AmazonResourceName", # required
-    #         tags: [ # required
-    #           {
-    #             key: "TagKey", # required
-    #             value: "TagValue", # required
-    #           },
-    #         ],
-    #       }
-    #
     # @!attribute [rw] resource_arn
     #   The ARN of the topic to which to add tags.
     #   @return [String]
@@ -3169,13 +2853,6 @@ module Aws::SNS
 
     # Input for Unsubscribe action.
     #
-    # @note When making an API call, you may pass UnsubscribeInput
-    #   data as a hash:
-    #
-    #       {
-    #         subscription_arn: "subscriptionARN", # required
-    #       }
-    #
     # @!attribute [rw] subscription_arn
     #   The ARN of the subscription to be deleted.
     #   @return [String]
@@ -3188,14 +2865,6 @@ module Aws::SNS
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass UntagResourceRequest
-    #   data as a hash:
-    #
-    #       {
-    #         resource_arn: "AmazonResourceName", # required
-    #         tag_keys: ["TagKey"], # required
-    #       }
-    #
     # @!attribute [rw] resource_arn
     #   The ARN of the topic from which to remove tags.
     #   @return [String]
@@ -3263,14 +2932,6 @@ module Aws::SNS
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass VerifySMSSandboxPhoneNumberInput
-    #   data as a hash:
-    #
-    #       {
-    #         phone_number: "PhoneNumberString", # required
-    #         one_time_password: "OTPCode", # required
-    #       }
-    #
     # @!attribute [rw] phone_number
     #   The destination phone number to verify.
     #   @return [String]

data/lib/aws-sdk-sns.rb

@@ -56,6 +56,6 @@ require_relative 'aws-sdk-sns/customizations'
 # @!group service
 module Aws::SNS
 
-  GEM_VERSION = '1.56.0'
+  GEM_VERSION = '1.57.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-sns
 version: !ruby/object:Gem::Version
-  version: 1.56.0
+  version: 1.57.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-25 00:00:00.000000000 Z
+date: 2022-12-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core