aws-sdk-macie2 1.25.0 → 1.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1fd8b848a270fe36584d51fb7fdfbe74282e1d1282555424a7743533e4aa5fdf
-  data.tar.gz: 67e1694bd9d04a9c8dd8aae1c053f3065d6662e02dd2b0abeea9a26713ddc71d
+  metadata.gz: 8312d9a8cbab7c3b940504b68878ff52067f516b39387516c6730912248fc380
+  data.tar.gz: 9873072f2ffde814bdb325b7f0cfab36ce52b67edae78ec6fb5ffdeed700ee70
 SHA512:
-  metadata.gz: 9bbe56eef2cf88122e08ee3d512953656db5f066aee2bc4184ddcf38a85343a6f468a1d899740989a178ab0c45e81982aab6600e887e09471cf66150183bcc19
-  data.tar.gz: 1bf0c9717f89b213c32e078192352686aa4c764748d001cc4dcca47dd2ec94458f7dc105339939c02b6288596be4d46afdf0ea00f43a71209a2d5956c7193b06
+  metadata.gz: 66d1ad4f766cfe4b4c1a16022db47113b213faffe4f483da55f096d7687e486c3488d5748580093c807f7a0bbe84b0bd177fe9e9c2d30a395b83fdec707fe6af
+  data.tar.gz: 89326c79facb785cd6bb914ada9e970763c4e1201c7a4397938e6c7a96cad0053cb1952159a4a50dcb8ecf8c28df488367ce8537e4a0f3e4a5e5bbd910a761a8

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.26.0 (2021-03-22)
+------------------
+
+* Feature - This release of the Amazon Macie API adds support for publishing sensitive data findings to AWS Security Hub and specifying which categories of findings to publish to Security Hub.
+
 1.25.0 (2021-03-10)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.25.0
+1.26.0

data/lib/aws-sdk-macie2.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-macie2/customizations'
 # @!group service
 module Aws::Macie2
 
-  GEM_VERSION = '1.25.0'
+  GEM_VERSION = '1.26.0'
 
 end

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

@@ -1192,7 +1192,12 @@ module Aws::Macie2
     #   The frequency with which Amazon Macie publishes updates to policy
     #   findings for an account. This includes publishing updates to AWS
     #   Security Hub and Amazon EventBridge (formerly called Amazon CloudWatch
-    #   Events). Valid values are:
+    #   Events). For more information, see [Monitoring and processing
+    #   findings][1] in the *Amazon Macie User Guide*. Valid values are:
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/macie/latest/user/findings-monitor.html
     #
     # @option params [String] :status
     #   The status of an Amazon Macie account. Valid values are:
@@ -1714,6 +1719,27 @@ module Aws::Macie2
       req.send_request(options)
     end
 
+    # Retrieves the configuration settings for publishing findings to AWS
+    # Security Hub.
+    #
+    # @return [Types::GetFindingsPublicationConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetFindingsPublicationConfigurationResponse#security_hub_configuration #security_hub_configuration} => Types::SecurityHubConfiguration
+    #
+    # @example Response structure
+    #
+    #   resp.security_hub_configuration.publish_classification_findings #=> Boolean
+    #   resp.security_hub_configuration.publish_policy_findings #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/GetFindingsPublicationConfiguration AWS API Documentation
+    #
+    # @overload get_findings_publication_configuration(params = {})
+    # @param [Hash] params ({})
+    def get_findings_publication_configuration(params = {}, options = {})
+      req = build_request(:get_findings_publication_configuration, params)
+      req.send_request(options)
+    end
+
     # Retrieves the count of Amazon Macie membership invitations that were
     # received by an account.
     #
@@ -2342,6 +2368,44 @@ module Aws::Macie2
       req.send_request(options)
     end
 
+    # Updates the configuration settings for publishing findings to AWS
+    # Security Hub.
+    #
+    # @option params [String] :client_token
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @option params [Types::SecurityHubConfiguration] :security_hub_configuration
+    #   Specifies configuration settings that determine which findings are
+    #   published to AWS Security Hub automatically. For information about how
+    #   Macie publishes findings to Security Hub, see [Amazon Macie
+    #   integration with Security Hub][1] in the *Amazon Macie User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/macie/latest/user/securityhub-integration.html
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_findings_publication_configuration({
+    #     client_token: "__string",
+    #     security_hub_configuration: {
+    #       publish_classification_findings: false, # required
+    #       publish_policy_findings: false, # required
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/PutFindingsPublicationConfiguration AWS API Documentation
+    #
+    # @overload put_findings_publication_configuration(params = {})
+    # @param [Hash] params ({})
+    def put_findings_publication_configuration(params = {}, options = {})
+      req = build_request(:put_findings_publication_configuration, params)
+      req.send_request(options)
+    end
+
     # Adds or updates one or more tags (keys and values) that are associated
     # with a classification job, custom data identifier, findings filter, or
     # member account.
@@ -2530,7 +2594,12 @@ module Aws::Macie2
     #   The frequency with which Amazon Macie publishes updates to policy
     #   findings for an account. This includes publishing updates to AWS
     #   Security Hub and Amazon EventBridge (formerly called Amazon CloudWatch
-    #   Events). Valid values are:
+    #   Events). For more information, see [Monitoring and processing
+    #   findings][1] in the *Amazon Macie User Guide*. Valid values are:
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/macie/latest/user/findings-monitor.html
     #
     # @option params [String] :status
     #   The status of an Amazon Macie account. Valid values are:
@@ -2614,7 +2683,7 @@ module Aws::Macie2
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-macie2'
-      context[:gem_version] = '1.25.0'
+      context[:gem_version] = '1.26.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -131,6 +131,8 @@ module Aws::Macie2
     GetFindingStatisticsResponse = Shapes::StructureShape.new(name: 'GetFindingStatisticsResponse')
     GetFindingsFilterRequest = Shapes::StructureShape.new(name: 'GetFindingsFilterRequest')
     GetFindingsFilterResponse = Shapes::StructureShape.new(name: 'GetFindingsFilterResponse')
+    GetFindingsPublicationConfigurationRequest = Shapes::StructureShape.new(name: 'GetFindingsPublicationConfigurationRequest')
+    GetFindingsPublicationConfigurationResponse = Shapes::StructureShape.new(name: 'GetFindingsPublicationConfigurationResponse')
     GetFindingsRequest = Shapes::StructureShape.new(name: 'GetFindingsRequest')
     GetFindingsResponse = Shapes::StructureShape.new(name: 'GetFindingsResponse')
     GetInvitationsCountRequest = Shapes::StructureShape.new(name: 'GetInvitationsCountRequest')
@@ -203,6 +205,8 @@ module Aws::Macie2
     PolicyDetails = Shapes::StructureShape.new(name: 'PolicyDetails')
     PutClassificationExportConfigurationRequest = Shapes::StructureShape.new(name: 'PutClassificationExportConfigurationRequest')
     PutClassificationExportConfigurationResponse = Shapes::StructureShape.new(name: 'PutClassificationExportConfigurationResponse')
+    PutFindingsPublicationConfigurationRequest = Shapes::StructureShape.new(name: 'PutFindingsPublicationConfigurationRequest')
+    PutFindingsPublicationConfigurationResponse = Shapes::StructureShape.new(name: 'PutFindingsPublicationConfigurationResponse')
     Range = Shapes::StructureShape.new(name: 'Range')
     Ranges = Shapes::ListShape.new(name: 'Ranges')
     Record = Shapes::StructureShape.new(name: 'Record')
@@ -219,6 +223,7 @@ module Aws::Macie2
     S3Object = Shapes::StructureShape.new(name: 'S3Object')
     ScopeFilterKey = Shapes::StringShape.new(name: 'ScopeFilterKey')
     Scoping = Shapes::StructureShape.new(name: 'Scoping')
+    SecurityHubConfiguration = Shapes::StructureShape.new(name: 'SecurityHubConfiguration')
     SensitiveData = Shapes::ListShape.new(name: 'SensitiveData')
     SensitiveDataItem = Shapes::StructureShape.new(name: 'SensitiveDataItem')
     SensitiveDataItemCategory = Shapes::StringShape.new(name: 'SensitiveDataItemCategory')
@@ -803,6 +808,11 @@ module Aws::Macie2
     GetFindingsFilterResponse.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
     GetFindingsFilterResponse.struct_class = Types::GetFindingsFilterResponse
 
+    GetFindingsPublicationConfigurationRequest.struct_class = Types::GetFindingsPublicationConfigurationRequest
+
+    GetFindingsPublicationConfigurationResponse.add_member(:security_hub_configuration, Shapes::ShapeRef.new(shape: SecurityHubConfiguration, location_name: "securityHubConfiguration"))
+    GetFindingsPublicationConfigurationResponse.struct_class = Types::GetFindingsPublicationConfigurationResponse
+
     GetFindingsRequest.add_member(:finding_ids, Shapes::ShapeRef.new(shape: __listOf__string, required: true, location_name: "findingIds"))
     GetFindingsRequest.add_member(:sort_criteria, Shapes::ShapeRef.new(shape: SortCriteria, location_name: "sortCriteria"))
     GetFindingsRequest.struct_class = Types::GetFindingsRequest
@@ -1071,6 +1081,12 @@ module Aws::Macie2
     PutClassificationExportConfigurationResponse.add_member(:configuration, Shapes::ShapeRef.new(shape: ClassificationExportConfiguration, location_name: "configuration"))
     PutClassificationExportConfigurationResponse.struct_class = Types::PutClassificationExportConfigurationResponse
 
+    PutFindingsPublicationConfigurationRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: __string, location_name: "clientToken", metadata: {"idempotencyToken"=>true}))
+    PutFindingsPublicationConfigurationRequest.add_member(:security_hub_configuration, Shapes::ShapeRef.new(shape: SecurityHubConfiguration, location_name: "securityHubConfiguration"))
+    PutFindingsPublicationConfigurationRequest.struct_class = Types::PutFindingsPublicationConfigurationRequest
+
+    PutFindingsPublicationConfigurationResponse.struct_class = Types::PutFindingsPublicationConfigurationResponse
+
     Range.add_member(:end, Shapes::ShapeRef.new(shape: __long, location_name: "end"))
     Range.add_member(:start, Shapes::ShapeRef.new(shape: __long, location_name: "start"))
     Range.add_member(:start_column, Shapes::ShapeRef.new(shape: __long, location_name: "startColumn"))
@@ -1140,6 +1156,10 @@ module Aws::Macie2
     Scoping.add_member(:includes, Shapes::ShapeRef.new(shape: JobScopingBlock, location_name: "includes"))
     Scoping.struct_class = Types::Scoping
 
+    SecurityHubConfiguration.add_member(:publish_classification_findings, Shapes::ShapeRef.new(shape: __boolean, required: true, location_name: "publishClassificationFindings"))
+    SecurityHubConfiguration.add_member(:publish_policy_findings, Shapes::ShapeRef.new(shape: __boolean, required: true, location_name: "publishPolicyFindings"))
+    SecurityHubConfiguration.struct_class = Types::SecurityHubConfiguration
+
     SensitiveData.member = Shapes::ShapeRef.new(shape: SensitiveDataItem)
 
     SensitiveDataItem.add_member(:category, Shapes::ShapeRef.new(shape: SensitiveDataItemCategory, location_name: "category"))
@@ -1837,6 +1857,21 @@ module Aws::Macie2
         o.errors << Shapes::ShapeRef.new(shape: ConflictException)
       end)
 
+      api.add_operation(:get_findings_publication_configuration, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetFindingsPublicationConfiguration"
+        o.http_method = "GET"
+        o.http_request_uri = "/findings-publication-configuration"
+        o.input = Shapes::ShapeRef.new(shape: GetFindingsPublicationConfigurationRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetFindingsPublicationConfigurationResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+      end)
+
       api.add_operation(:get_invitations_count, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetInvitationsCount"
         o.http_method = "GET"
@@ -2103,6 +2138,21 @@ module Aws::Macie2
         o.errors << Shapes::ShapeRef.new(shape: ConflictException)
       end)
 
+      api.add_operation(:put_findings_publication_configuration, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutFindingsPublicationConfiguration"
+        o.http_method = "PUT"
+        o.http_request_uri = "/findings-publication-configuration"
+        o.input = Shapes::ShapeRef.new(shape: PutFindingsPublicationConfigurationRequest)
+        o.output = Shapes::ShapeRef.new(shape: PutFindingsPublicationConfigurationResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+      end)
+
       api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o|
         o.name = "TagResource"
         o.http_method = "POST"

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

@@ -1999,7 +1999,13 @@ module Aws::Macie2
     #   The frequency with which Amazon Macie publishes updates to policy
     #   findings for an account. This includes publishing updates to AWS
     #   Security Hub and Amazon EventBridge (formerly called Amazon
-    #   CloudWatch Events). Valid values are:
+    #   CloudWatch Events). For more information, see [Monitoring and
+    #   processing findings][1] in the *Amazon Macie User Guide*. Valid
+    #   values are:
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/macie/latest/user/findings-monitor.html
     #   @return [String]
     #
     # @!attribute [rw] status
@@ -2698,6 +2704,34 @@ module Aws::Macie2
       include Aws::Structure
     end
 
+    # @api private
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/GetFindingsPublicationConfigurationRequest AWS API Documentation
+    #
+    class GetFindingsPublicationConfigurationRequest < Aws::EmptyStructure; end
+
+    # Provides information about the current configuration settings for
+    # publishing findings to AWS Security Hub automatically.
+    #
+    # @!attribute [rw] security_hub_configuration
+    #   Specifies configuration settings that determine which findings are
+    #   published to AWS Security Hub automatically. For information about
+    #   how Macie publishes findings to Security Hub, see [Amazon Macie
+    #   integration with Security Hub][1] in the *Amazon Macie User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/macie/latest/user/securityhub-integration.html
+    #   @return [Types::SecurityHubConfiguration]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/GetFindingsPublicationConfigurationResponse AWS API Documentation
+    #
+    class GetFindingsPublicationConfigurationResponse < Struct.new(
+      :security_hub_configuration)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Specifies one or more findings to retrieve.
     #
     # @note When making an API call, you may pass GetFindingsRequest
@@ -2778,7 +2812,13 @@ module Aws::Macie2
     #   The frequency with which Amazon Macie publishes updates to policy
     #   findings for an account. This includes publishing updates to AWS
     #   Security Hub and Amazon EventBridge (formerly called Amazon
-    #   CloudWatch Events). Valid values are:
+    #   CloudWatch Events). For more information, see [Monitoring and
+    #   processing findings][1] in the *Amazon Macie User Guide*. Valid
+    #   values are:
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/macie/latest/user/findings-monitor.html
     #   @return [String]
     #
     # @!attribute [rw] service_role
@@ -4228,6 +4268,49 @@ module Aws::Macie2
       include Aws::Structure
     end
 
+    # Specifies configuration settings for publishing findings to AWS
+    # Security Hub automatically.
+    #
+    # @note When making an API call, you may pass PutFindingsPublicationConfigurationRequest
+    #   data as a hash:
+    #
+    #       {
+    #         client_token: "__string",
+    #         security_hub_configuration: {
+    #           publish_classification_findings: false, # required
+    #           publish_policy_findings: false, # required
+    #         },
+    #       }
+    #
+    # @!attribute [rw] client_token
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    # @!attribute [rw] security_hub_configuration
+    #   Specifies configuration settings that determine which findings are
+    #   published to AWS Security Hub automatically. For information about
+    #   how Macie publishes findings to Security Hub, see [Amazon Macie
+    #   integration with Security Hub][1] in the *Amazon Macie User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/macie/latest/user/securityhub-integration.html
+    #   @return [Types::SecurityHubConfiguration]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/PutFindingsPublicationConfigurationRequest AWS API Documentation
+    #
+    class PutFindingsPublicationConfigurationRequest < Struct.new(
+      :client_token,
+      :security_hub_configuration)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/PutFindingsPublicationConfigurationResponse AWS API Documentation
+    #
+    class PutFindingsPublicationConfigurationResponse < Aws::EmptyStructure; end
+
     # Provides details about the location of an occurrence of sensitive data
     # in an Adobe Portable Document Format file, Microsoft Word document, or
     # non-binary text file.
@@ -4665,6 +4748,38 @@ module Aws::Macie2
       include Aws::Structure
     end
 
+    # Specifies configuration settings that determine which findings are
+    # published to AWS Security Hub automatically. For information about how
+    # Macie publishes findings to Security Hub, see [Amazon Macie
+    # integration with Security Hub][1] in the *Amazon Macie User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/macie/latest/user/securityhub-integration.html
+    #
+    # @note When making an API call, you may pass SecurityHubConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         publish_classification_findings: false, # required
+    #         publish_policy_findings: false, # required
+    #       }
+    #
+    # @!attribute [rw] publish_classification_findings
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] publish_policy_findings
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/SecurityHubConfiguration AWS API Documentation
+    #
+    class SecurityHubConfiguration < Struct.new(
+      :publish_classification_findings,
+      :publish_policy_findings)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Provides information about the category, types, and occurrences of
     # sensitive data that produced a sensitive data finding.
     #
@@ -5273,7 +5388,13 @@ module Aws::Macie2
     #   The frequency with which Amazon Macie publishes updates to policy
     #   findings for an account. This includes publishing updates to AWS
     #   Security Hub and Amazon EventBridge (formerly called Amazon
-    #   CloudWatch Events). Valid values are:
+    #   CloudWatch Events). For more information, see [Monitoring and
+    #   processing findings][1] in the *Amazon Macie User Guide*. Valid
+    #   values are:
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/macie/latest/user/findings-monitor.html
     #   @return [String]
     #
     # @!attribute [rw] status

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-macie2
 version: !ruby/object:Gem::Version
-  version: 1.25.0
+  version: 1.26.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-10 00:00:00.000000000 Z
+date: 2021-03-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -66,8 +66,8 @@ homepage: https://github.com/aws/aws-sdk-ruby
 licenses:
 - Apache-2.0
 metadata:
-  source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/master/gems/aws-sdk-macie2
-  changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/master/gems/aws-sdk-macie2/CHANGELOG.md
+  source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-macie2
+  changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-macie2/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths: