aws-sdk-sns 1.54.0 → 1.55.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 383b2dbe66be2da64df9234092d71187dbc18592809f34b1e53ba88d9cd893c7
-  data.tar.gz: f2aa8f1ecdc003e86d566959091e3666d3f26bb32411d9fef8de108367b8fef6
+  metadata.gz: 8c71df1b2aa3b87d7830d1f1f0da8d3f0e77cd4a47bfefcbd0103b5b6345a0e0
+  data.tar.gz: 94e9f8682965568bb34b3390edbda1e837169b7f8b7c71cc0ee5dc21697b734c
 SHA512:
-  metadata.gz: 5a47088977b4883aa12a4092501962b27b0b06f114a43ad93161abef1b944d986b8432efd837be6ff96f4356618c6abf27bde30ef888f9f2bc1998de022ed808
-  data.tar.gz: e87dab42cef1a28c641cb16b23add12ce6669bd7694e373ae72da8b6b4c369ddddb0c60d950e3fbc51d76169e693cdb7497343385cc2571fa0bdb2d3a9872ed6
+  metadata.gz: 1748ac289a9df669017f6a77869f5cf04b5c5e91f4576d6519d0c24e5628b2be2e22f526df0f1337930a88e0ea783878bfaa5ed2a7f9ad07eaa8890a59617a12
+  data.tar.gz: '0994ffbc6518f135eeed5877540a3d30ddc42c9d4aef3f155780c22b3cecab8da234890882859f54624969aaab12d8aa84c63cddbee5158b71520f4eaf277d0e'

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.55.0 (2022-09-07)
+------------------
+
+* Feature - Amazon SNS introduces the Data Protection Policy APIs, which enable customers to attach a data protection policy to an SNS topic. This allows topic owners to enable the new message data protection feature to audit and block sensitive data that is exchanged through their topics.
+
 1.54.0 (2022-08-22)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.54.0
+1.55.0

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

@@ -748,6 +748,15 @@ module Aws::SNS
     #
     #    </note>
     #
+    # @option params [String] :data_protection_policy
+    #   The body of the policy document you want to use for this topic.
+    #
+    #   You can only add one policy per topic.
+    #
+    #   The policy must be in JSON string format.
+    #
+    #   Length Constraints: Maximum length of 30,720.
+    #
     # @return [Types::CreateTopicResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateTopicResponse#topic_arn #topic_arn} => String
@@ -765,6 +774,7 @@ module Aws::SNS
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     data_protection_policy: "attributeValue",
     #   })
     #
     # @example Response structure
@@ -902,6 +912,42 @@ module Aws::SNS
       req.send_request(options)
     end
 
+    # Retrieves the specified inline `DataProtectionPolicy` document that is
+    # stored in the specified Amazon SNS topic.
+    #
+    # @option params [required, String] :resource_arn
+    #   The ARN of the topic whose `DataProtectionPolicy` you want to get.
+    #
+    #   For more information about ARNs, see [Amazon Resource Names (ARNs)][1]
+    #   in the Amazon Web Services General Reference.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
+    #
+    # @return [Types::GetDataProtectionPolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetDataProtectionPolicyResponse#data_protection_policy #data_protection_policy} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_data_protection_policy({
+    #     resource_arn: "topicARN", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.data_protection_policy #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/GetDataProtectionPolicy AWS API Documentation
+    #
+    # @overload get_data_protection_policy(params = {})
+    # @param [Hash] params ({})
+    def get_data_protection_policy(params = {}, options = {})
+      req = build_request(:get_data_protection_policy, params)
+      req.send_request(options)
+    end
+
     # Retrieves the endpoint attributes for a device on one of the supported
     # push notification services, such as GCM (Firebase Cloud Messaging) and
     # APNS. For more information, see [Using Amazon SNS Mobile Push
@@ -1836,6 +1882,45 @@ module Aws::SNS
       req.send_request(options)
     end
 
+    # Adds or updates an inline policy document that is stored in the
+    # specified Amazon SNS topic.
+    #
+    # @option params [required, String] :resource_arn
+    #   The ARN of the topic whose `DataProtectionPolicy` you want to add or
+    #   update.
+    #
+    #   For more information about ARNs, see [Amazon Resource Names (ARNs)][1]
+    #   in the Amazon Web Services General Reference.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
+    #
+    # @option params [required, String] :data_protection_policy
+    #   The JSON serialization of the topic's `DataProtectionPolicy`.
+    #
+    #   The `DataProtectionPolicy` must be in JSON string format.
+    #
+    #   Length Constraints: Maximum length of 30,720.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_data_protection_policy({
+    #     resource_arn: "topicARN", # required
+    #     data_protection_policy: "attributeValue", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/PutDataProtectionPolicy AWS API Documentation
+    #
+    # @overload put_data_protection_policy(params = {})
+    # @param [Hash] params ({})
+    def put_data_protection_policy(params = {}, options = {})
+      req = build_request(:put_data_protection_policy, params)
+      req.send_request(options)
+    end
+
     # Removes a statement from a topic's access control policy.
     #
     # @option params [required, String] :topic_arn
@@ -2606,7 +2691,7 @@ module Aws::SNS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-sns'
-      context[:gem_version] = '1.54.0'
+      context[:gem_version] = '1.55.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -45,6 +45,8 @@ module Aws::SNS
     Endpoint = Shapes::StructureShape.new(name: 'Endpoint')
     EndpointDisabledException = Shapes::StructureShape.new(name: 'EndpointDisabledException')
     FilterPolicyLimitExceededException = Shapes::StructureShape.new(name: 'FilterPolicyLimitExceededException')
+    GetDataProtectionPolicyInput = Shapes::StructureShape.new(name: 'GetDataProtectionPolicyInput')
+    GetDataProtectionPolicyResponse = Shapes::StructureShape.new(name: 'GetDataProtectionPolicyResponse')
     GetEndpointAttributesInput = Shapes::StructureShape.new(name: 'GetEndpointAttributesInput')
     GetEndpointAttributesResponse = Shapes::StructureShape.new(name: 'GetEndpointAttributesResponse')
     GetPlatformApplicationAttributesInput = Shapes::StructureShape.new(name: 'GetPlatformApplicationAttributesInput')
@@ -118,6 +120,7 @@ module Aws::SNS
     PublishBatchResultEntryList = Shapes::ListShape.new(name: 'PublishBatchResultEntryList')
     PublishInput = Shapes::StructureShape.new(name: 'PublishInput')
     PublishResponse = Shapes::StructureShape.new(name: 'PublishResponse')
+    PutDataProtectionPolicyInput = Shapes::StructureShape.new(name: 'PutDataProtectionPolicyInput')
     RemovePermissionInput = Shapes::StructureShape.new(name: 'RemovePermissionInput')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     RouteType = Shapes::StringShape.new(name: 'RouteType')
@@ -251,6 +254,7 @@ module Aws::SNS
     CreateTopicInput.add_member(:name, Shapes::ShapeRef.new(shape: topicName, required: true, location_name: "Name"))
     CreateTopicInput.add_member(:attributes, Shapes::ShapeRef.new(shape: TopicAttributesMap, location_name: "Attributes"))
     CreateTopicInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
+    CreateTopicInput.add_member(:data_protection_policy, Shapes::ShapeRef.new(shape: attributeValue, location_name: "DataProtectionPolicy"))
     CreateTopicInput.struct_class = Types::CreateTopicInput
 
     CreateTopicResponse.add_member(:topic_arn, Shapes::ShapeRef.new(shape: topicARN, location_name: "TopicArn"))
@@ -285,6 +289,12 @@ module Aws::SNS
     FilterPolicyLimitExceededException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "message"))
     FilterPolicyLimitExceededException.struct_class = Types::FilterPolicyLimitExceededException
 
+    GetDataProtectionPolicyInput.add_member(:resource_arn, Shapes::ShapeRef.new(shape: topicARN, required: true, location_name: "ResourceArn"))
+    GetDataProtectionPolicyInput.struct_class = Types::GetDataProtectionPolicyInput
+
+    GetDataProtectionPolicyResponse.add_member(:data_protection_policy, Shapes::ShapeRef.new(shape: attributeValue, location_name: "DataProtectionPolicy"))
+    GetDataProtectionPolicyResponse.struct_class = Types::GetDataProtectionPolicyResponse
+
     GetEndpointAttributesInput.add_member(:endpoint_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "EndpointArn"))
     GetEndpointAttributesInput.struct_class = Types::GetEndpointAttributesInput
 
@@ -509,6 +519,10 @@ module Aws::SNS
     PublishResponse.add_member(:sequence_number, Shapes::ShapeRef.new(shape: String, location_name: "SequenceNumber"))
     PublishResponse.struct_class = Types::PublishResponse
 
+    PutDataProtectionPolicyInput.add_member(:resource_arn, Shapes::ShapeRef.new(shape: topicARN, required: true, location_name: "ResourceArn"))
+    PutDataProtectionPolicyInput.add_member(:data_protection_policy, Shapes::ShapeRef.new(shape: attributeValue, required: true, location_name: "DataProtectionPolicy"))
+    PutDataProtectionPolicyInput.struct_class = Types::PutDataProtectionPolicyInput
+
     RemovePermissionInput.add_member(:topic_arn, Shapes::ShapeRef.new(shape: topicARN, required: true, location_name: "TopicArn"))
     RemovePermissionInput.add_member(:label, Shapes::ShapeRef.new(shape: label, required: true, location_name: "Label"))
     RemovePermissionInput.struct_class = Types::RemovePermissionInput
@@ -796,6 +810,19 @@ module Aws::SNS
         o.errors << Shapes::ShapeRef.new(shape: ConcurrentAccessException)
       end)
 
+      api.add_operation(:get_data_protection_policy, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetDataProtectionPolicy"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetDataProtectionPolicyInput)
+        o.output = Shapes::ShapeRef.new(shape: GetDataProtectionPolicyResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: AuthorizationErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidSecurityException)
+      end)
+
       api.add_operation(:get_endpoint_attributes, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetEndpointAttributes"
         o.http_method = "POST"
@@ -1050,6 +1077,7 @@ module Aws::SNS
         o.errors << Shapes::ShapeRef.new(shape: KMSThrottlingException)
         o.errors << Shapes::ShapeRef.new(shape: KMSAccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidSecurityException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
       end)
 
       api.add_operation(:publish_batch, Seahorse::Model::Operation.new.tap do |o|
@@ -1077,6 +1105,20 @@ module Aws::SNS
         o.errors << Shapes::ShapeRef.new(shape: KMSThrottlingException)
         o.errors << Shapes::ShapeRef.new(shape: KMSAccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidSecurityException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+      end)
+
+      api.add_operation(:put_data_protection_policy, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutDataProtectionPolicy"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: PutDataProtectionPolicyInput)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: AuthorizationErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidSecurityException)
       end)
 
       api.add_operation(:remove_permission, Seahorse::Model::Operation.new.tap do |o|

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

@@ -81,6 +81,7 @@ module Aws::SNS
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     data_protection_policy: "attributeValue",
     #   })
     # @param [Hash] options ({})
     # @option options [required, String] :name
@@ -152,6 +153,14 @@ module Aws::SNS
     #   `sns:CreateTopic` and `sns:TagResource` permissions.
     #
     #    </note>
+    # @option options [String] :data_protection_policy
+    #   The body of the policy document you want to use for this topic.
+    #
+    #   You can only add one policy per topic.
+    #
+    #   The policy must be in JSON string format.
+    #
+    #   Length Constraints: Maximum length of 30,720.
     # @return [Topic]
     def create_topic(options = {})
       resp = @client.create_topic(options)

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

@@ -401,6 +401,7 @@ module Aws::SNS
     #             value: "TagValue", # required
     #           },
     #         ],
+    #         data_protection_policy: "attributeValue",
     #       }
     #
     # @!attribute [rw] name
@@ -481,12 +482,23 @@ module Aws::SNS
     #    </note>
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] data_protection_policy
+    #   The body of the policy document you want to use for this topic.
+    #
+    #   You can only add one policy per topic.
+    #
+    #   The policy must be in JSON string format.
+    #
+    #   Length Constraints: Maximum length of 30,720.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/CreateTopicInput AWS API Documentation
     #
     class CreateTopicInput < Struct.new(
       :name,
       :attributes,
-      :tags)
+      :tags,
+      :data_protection_policy)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -651,6 +663,44 @@ 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.
+    #
+    #   For more information about ARNs, see [Amazon Resource Names
+    #   (ARNs)][1] in the Amazon Web Services General Reference.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/GetDataProtectionPolicyInput AWS API Documentation
+    #
+    class GetDataProtectionPolicyInput < Struct.new(
+      :resource_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] data_protection_policy
+    #   Retrieves the `DataProtectionPolicy` in JSON string format.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/GetDataProtectionPolicyResponse AWS API Documentation
+    #
+    class GetDataProtectionPolicyResponse < Struct.new(
+      :data_protection_policy)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Input for GetEndpointAttributes action.
     #
     # @note When making an API call, you may pass GetEndpointAttributesInput
@@ -2227,6 +2277,43 @@ 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.
+    #
+    #   For more information about ARNs, see [Amazon Resource Names
+    #   (ARNs)][1] in the Amazon Web Services General Reference.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
+    #   @return [String]
+    #
+    # @!attribute [rw] data_protection_policy
+    #   The JSON serialization of the topic's `DataProtectionPolicy`.
+    #
+    #   The `DataProtectionPolicy` must be in JSON string format.
+    #
+    #   Length Constraints: Maximum length of 30,720.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/PutDataProtectionPolicyInput AWS API Documentation
+    #
+    class PutDataProtectionPolicyInput < Struct.new(
+      :resource_arn,
+      :data_protection_policy)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Input for RemovePermission action.
     #
     # @note When making an API call, you may pass RemovePermissionInput

data/lib/aws-sdk-sns.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-sns/customizations'
 # @!group service
 module Aws::SNS
 
-  GEM_VERSION = '1.54.0'
+  GEM_VERSION = '1.55.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-sns
 version: !ruby/object:Gem::Version
-  version: 1.54.0
+  version: 1.55.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-08-22 00:00:00.000000000 Z
+date: 2022-09-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core