aws-sdk-macie2 1.33.0 → 1.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5970c044a58a35a3a1974169ef90e05bb5082d648bbbbb0e92b1d683f11f120
-  data.tar.gz: 2a9a7b68768fd34d7498e88d4d54bafe47f99428cf8b71495fd92c39bfefc0c7
+  metadata.gz: cff82eacab779eb1a6545659e010b456c06abdc2989b9827a480c7f15c451120
+  data.tar.gz: cadf174b74d815dcadad7e73dcf3f7a8bf5fc690fd13db67099a0dbd26d89aef
 SHA512:
-  metadata.gz: 6c0aefbc9028db2bc682098962e71bb436b24c0d8b3c01219214c1aa86694e72c3ca1c12011af0bb47df0a01fed55b2b0f72a5577825a34bc497fdc0468825de
-  data.tar.gz: a70315515babe4ee679a78396beed1aa8f2fd6cfb607779615b0455f8a2d25a1479ec84bc82af5595390012c52b8ff1c376666005b9a5d818ebca64e6a23bef0
+  metadata.gz: 84ae0ea49cdc18e1cab933d5c40eca7d1b0760d38bb166d1bf71a731480a50bd707d2f1ad5423065ea3193a981693b65bba9efe005571f769b0440cbd8d0d1c7
+  data.tar.gz: 3178b5f6b434b42fb9bded536cb3865c9a24c35c2ce0d793a8187e5060696680c101a55e558604cc49532fa383b3a575aa8860b7772613933315e4edd2a40e15

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.34.0 (2021-09-16)
+------------------
+
+* Feature - This release adds support for specifying which managed data identifiers are used by a classification job, and retrieving a list of managed data identifiers that are available.
+
 1.33.0 (2021-09-01)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.33.0
+1.34.0

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

@@ -406,6 +406,12 @@ module Aws::Macie2
     # @option params [required, String] :job_type
     #   The schedule for running a classification job. Valid values are:
     #
+    # @option params [Array<String>] :managed_data_identifier_ids
+    #
+    # @option params [String] :managed_data_identifier_selector
+    #   The selection type that determines which managed data identifiers a
+    #   classification job uses to analyze data. Valid values are:
+    #
     # @option params [required, String] :name
     #
     # @option params [required, Types::S3JobDefinition] :s3_job_definition
@@ -440,6 +446,8 @@ module Aws::Macie2
     #     description: "__string",
     #     initial_run: false,
     #     job_type: "ONE_TIME", # required, accepts ONE_TIME, SCHEDULED
+    #     managed_data_identifier_ids: ["__string"],
+    #     managed_data_identifier_selector: "ALL", # accepts ALL, EXCLUDE, INCLUDE, NONE
     #     name: "__string", # required
     #     s3_job_definition: { # required
     #       bucket_definitions: [
@@ -1044,6 +1052,8 @@ module Aws::Macie2
     #   * {Types::DescribeClassificationJobResponse#job_type #job_type} => String
     #   * {Types::DescribeClassificationJobResponse#last_run_error_status #last_run_error_status} => Types::LastRunErrorStatus
     #   * {Types::DescribeClassificationJobResponse#last_run_time #last_run_time} => Time
+    #   * {Types::DescribeClassificationJobResponse#managed_data_identifier_ids #managed_data_identifier_ids} => Array&lt;String&gt;
+    #   * {Types::DescribeClassificationJobResponse#managed_data_identifier_selector #managed_data_identifier_selector} => String
     #   * {Types::DescribeClassificationJobResponse#name #name} => String
     #   * {Types::DescribeClassificationJobResponse#s3_job_definition #s3_job_definition} => Types::S3JobDefinition
     #   * {Types::DescribeClassificationJobResponse#sampling_percentage #sampling_percentage} => Integer
@@ -1072,6 +1082,9 @@ module Aws::Macie2
     #   resp.job_type #=> String, one of "ONE_TIME", "SCHEDULED"
     #   resp.last_run_error_status.code #=> String, one of "NONE", "ERROR"
     #   resp.last_run_time #=> Time
+    #   resp.managed_data_identifier_ids #=> Array
+    #   resp.managed_data_identifier_ids[0] #=> String
+    #   resp.managed_data_identifier_selector #=> String, one of "ALL", "EXCLUDE", "INCLUDE", "NONE"
     #   resp.name #=> String
     #   resp.s3_job_definition.bucket_definitions #=> Array
     #   resp.s3_job_definition.bucket_definitions[0].account_id #=> String
@@ -2266,8 +2279,8 @@ module Aws::Macie2
       req.send_request(options)
     end
 
-    # Retrieves information about all the Amazon Macie membership
-    # invitations that were received by an account.
+    # Retrieves information about the Amazon Macie membership invitations
+    # that were received by an account.
     #
     # @option params [Integer] :max_results
     #
@@ -2305,6 +2318,38 @@ module Aws::Macie2
       req.send_request(options)
     end
 
+    # Retrieves information about all the managed data identifiers that
+    # Amazon Macie currently provides.
+    #
+    # @option params [String] :next_token
+    #
+    # @return [Types::ListManagedDataIdentifiersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListManagedDataIdentifiersResponse#items #items} => Array&lt;Types::ManagedDataIdentifierSummary&gt;
+    #   * {Types::ListManagedDataIdentifiersResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_managed_data_identifiers({
+    #     next_token: "__string",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.items #=> Array
+    #   resp.items[0].category #=> String, one of "FINANCIAL_INFORMATION", "PERSONAL_INFORMATION", "CREDENTIALS", "CUSTOM_IDENTIFIER"
+    #   resp.items[0].id #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/ListManagedDataIdentifiers AWS API Documentation
+    #
+    # @overload list_managed_data_identifiers(params = {})
+    # @param [Hash] params ({})
+    def list_managed_data_identifiers(params = {}, options = {})
+      req = build_request(:list_managed_data_identifiers, params)
+      req.send_request(options)
+    end
+
     # Retrieves information about the accounts that are associated with an
     # Amazon Macie administrator account.
     #
@@ -2892,7 +2937,7 @@ module Aws::Macie2
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-macie2'
-      context[:gem_version] = '1.33.0'
+      context[:gem_version] = '1.34.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -190,6 +190,8 @@ module Aws::Macie2
     ListJobsFilterTerm = Shapes::StructureShape.new(name: 'ListJobsFilterTerm')
     ListJobsSortAttributeName = Shapes::StringShape.new(name: 'ListJobsSortAttributeName')
     ListJobsSortCriteria = Shapes::StructureShape.new(name: 'ListJobsSortCriteria')
+    ListManagedDataIdentifiersRequest = Shapes::StructureShape.new(name: 'ListManagedDataIdentifiersRequest')
+    ListManagedDataIdentifiersResponse = Shapes::StructureShape.new(name: 'ListManagedDataIdentifiersResponse')
     ListMembersRequest = Shapes::StructureShape.new(name: 'ListMembersRequest')
     ListMembersResponse = Shapes::StructureShape.new(name: 'ListMembersResponse')
     ListOrganizationAdminAccountsRequest = Shapes::StructureShape.new(name: 'ListOrganizationAdminAccountsRequest')
@@ -197,6 +199,8 @@ module Aws::Macie2
     ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest')
     ListTagsForResourceResponse = Shapes::StructureShape.new(name: 'ListTagsForResourceResponse')
     MacieStatus = Shapes::StringShape.new(name: 'MacieStatus')
+    ManagedDataIdentifierSelector = Shapes::StringShape.new(name: 'ManagedDataIdentifierSelector')
+    ManagedDataIdentifierSummary = Shapes::StructureShape.new(name: 'ManagedDataIdentifierSummary')
     MatchingBucket = Shapes::StructureShape.new(name: 'MatchingBucket')
     MatchingResource = Shapes::StructureShape.new(name: 'MatchingResource')
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
@@ -320,6 +324,7 @@ module Aws::Macie2
     __listOfJobSummary = Shapes::ListShape.new(name: '__listOfJobSummary')
     __listOfKeyValuePair = Shapes::ListShape.new(name: '__listOfKeyValuePair')
     __listOfListJobsFilterTerm = Shapes::ListShape.new(name: '__listOfListJobsFilterTerm')
+    __listOfManagedDataIdentifierSummary = Shapes::ListShape.new(name: '__listOfManagedDataIdentifierSummary')
     __listOfMatchingResource = Shapes::ListShape.new(name: '__listOfMatchingResource')
     __listOfMember = Shapes::ListShape.new(name: '__listOfMember')
     __listOfS3BucketDefinitionForJob = Shapes::ListShape.new(name: '__listOfS3BucketDefinitionForJob')
@@ -525,6 +530,8 @@ module Aws::Macie2
     CreateClassificationJobRequest.add_member(:description, Shapes::ShapeRef.new(shape: __string, location_name: "description"))
     CreateClassificationJobRequest.add_member(:initial_run, Shapes::ShapeRef.new(shape: __boolean, location_name: "initialRun"))
     CreateClassificationJobRequest.add_member(:job_type, Shapes::ShapeRef.new(shape: JobType, required: true, location_name: "jobType"))
+    CreateClassificationJobRequest.add_member(:managed_data_identifier_ids, Shapes::ShapeRef.new(shape: __listOf__string, location_name: "managedDataIdentifierIds"))
+    CreateClassificationJobRequest.add_member(:managed_data_identifier_selector, Shapes::ShapeRef.new(shape: ManagedDataIdentifierSelector, location_name: "managedDataIdentifierSelector"))
     CreateClassificationJobRequest.add_member(:name, Shapes::ShapeRef.new(shape: __string, required: true, location_name: "name"))
     CreateClassificationJobRequest.add_member(:s3_job_definition, Shapes::ShapeRef.new(shape: S3JobDefinition, required: true, location_name: "s3JobDefinition"))
     CreateClassificationJobRequest.add_member(:sampling_percentage, Shapes::ShapeRef.new(shape: __integer, location_name: "samplingPercentage"))
@@ -680,6 +687,8 @@ module Aws::Macie2
     DescribeClassificationJobResponse.add_member(:job_type, Shapes::ShapeRef.new(shape: JobType, location_name: "jobType"))
     DescribeClassificationJobResponse.add_member(:last_run_error_status, Shapes::ShapeRef.new(shape: LastRunErrorStatus, location_name: "lastRunErrorStatus"))
     DescribeClassificationJobResponse.add_member(:last_run_time, Shapes::ShapeRef.new(shape: __timestampIso8601, location_name: "lastRunTime"))
+    DescribeClassificationJobResponse.add_member(:managed_data_identifier_ids, Shapes::ShapeRef.new(shape: __listOf__string, location_name: "managedDataIdentifierIds"))
+    DescribeClassificationJobResponse.add_member(:managed_data_identifier_selector, Shapes::ShapeRef.new(shape: ManagedDataIdentifierSelector, location_name: "managedDataIdentifierSelector"))
     DescribeClassificationJobResponse.add_member(:name, Shapes::ShapeRef.new(shape: __string, location_name: "name"))
     DescribeClassificationJobResponse.add_member(:s3_job_definition, Shapes::ShapeRef.new(shape: S3JobDefinition, location_name: "s3JobDefinition"))
     DescribeClassificationJobResponse.add_member(:sampling_percentage, Shapes::ShapeRef.new(shape: __integer, location_name: "samplingPercentage"))
@@ -1053,6 +1062,13 @@ module Aws::Macie2
     ListJobsSortCriteria.add_member(:order_by, Shapes::ShapeRef.new(shape: OrderBy, location_name: "orderBy"))
     ListJobsSortCriteria.struct_class = Types::ListJobsSortCriteria
 
+    ListManagedDataIdentifiersRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: __string, location_name: "nextToken"))
+    ListManagedDataIdentifiersRequest.struct_class = Types::ListManagedDataIdentifiersRequest
+
+    ListManagedDataIdentifiersResponse.add_member(:items, Shapes::ShapeRef.new(shape: __listOfManagedDataIdentifierSummary, location_name: "items"))
+    ListManagedDataIdentifiersResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: __string, location_name: "nextToken"))
+    ListManagedDataIdentifiersResponse.struct_class = Types::ListManagedDataIdentifiersResponse
+
     ListMembersRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location: "querystring", location_name: "maxResults"))
     ListMembersRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: __string, location: "querystring", location_name: "nextToken"))
     ListMembersRequest.add_member(:only_associated, Shapes::ShapeRef.new(shape: __string, location: "querystring", location_name: "onlyAssociated"))
@@ -1076,6 +1092,10 @@ module Aws::Macie2
     ListTagsForResourceResponse.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
     ListTagsForResourceResponse.struct_class = Types::ListTagsForResourceResponse
 
+    ManagedDataIdentifierSummary.add_member(:category, Shapes::ShapeRef.new(shape: SensitiveDataItemCategory, location_name: "category"))
+    ManagedDataIdentifierSummary.add_member(:id, Shapes::ShapeRef.new(shape: __string, location_name: "id"))
+    ManagedDataIdentifierSummary.struct_class = Types::ManagedDataIdentifierSummary
+
     MatchingBucket.add_member(:account_id, Shapes::ShapeRef.new(shape: __string, location_name: "accountId"))
     MatchingBucket.add_member(:bucket_name, Shapes::ShapeRef.new(shape: __string, location_name: "bucketName"))
     MatchingBucket.add_member(:classifiable_object_count, Shapes::ShapeRef.new(shape: __long, location_name: "classifiableObjectCount"))
@@ -1486,6 +1506,8 @@ module Aws::Macie2
 
     __listOfListJobsFilterTerm.member = Shapes::ShapeRef.new(shape: ListJobsFilterTerm)
 
+    __listOfManagedDataIdentifierSummary.member = Shapes::ShapeRef.new(shape: ManagedDataIdentifierSummary)
+
     __listOfMatchingResource.member = Shapes::ShapeRef.new(shape: MatchingResource)
 
     __listOfMember.member = Shapes::ShapeRef.new(shape: Member)
@@ -2202,6 +2224,14 @@ module Aws::Macie2
         )
       end)
 
+      api.add_operation(:list_managed_data_identifiers, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListManagedDataIdentifiers"
+        o.http_method = "POST"
+        o.http_request_uri = "/managed-data-identifiers/list"
+        o.input = Shapes::ShapeRef.new(shape: ListManagedDataIdentifiersRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListManagedDataIdentifiersResponse)
+      end)
+
       api.add_operation(:list_members, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListMembers"
         o.http_method = "GET"

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

@@ -959,6 +959,8 @@ module Aws::Macie2
     #         description: "__string",
     #         initial_run: false,
     #         job_type: "ONE_TIME", # required, accepts ONE_TIME, SCHEDULED
+    #         managed_data_identifier_ids: ["__string"],
+    #         managed_data_identifier_selector: "ALL", # accepts ALL, EXCLUDE, INCLUDE, NONE
     #         name: "__string", # required
     #         s3_job_definition: { # required
     #           bucket_definitions: [
@@ -1090,6 +1092,14 @@ module Aws::Macie2
     #   The schedule for running a classification job. Valid values are:
     #   @return [String]
     #
+    # @!attribute [rw] managed_data_identifier_ids
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] managed_data_identifier_selector
+    #   The selection type that determines which managed data identifiers a
+    #   classification job uses to analyze data. Valid values are:
+    #   @return [String]
+    #
     # @!attribute [rw] name
     #   @return [String]
     #
@@ -1124,6 +1134,8 @@ module Aws::Macie2
       :description,
       :initial_run,
       :job_type,
+      :managed_data_identifier_ids,
+      :managed_data_identifier_selector,
       :name,
       :s3_job_definition,
       :sampling_percentage,
@@ -1151,7 +1163,7 @@ module Aws::Macie2
       include Aws::Structure
     end
 
-    # Specifies the criteria and other settings for a new custom data
+    # Specifies the criteria and other settings for a custom data
     # identifier. You can't change a custom data identifier after you
     # create it. This helps ensure that you have an immutable history of
     # sensitive data findings and discovery results for data privacy and
@@ -1646,8 +1658,8 @@ module Aws::Macie2
     #
     # @!attribute [rw] occurrences
     #   Specifies the location of 1-15 occurrences of sensitive data that
-    #   was detected by managed data identifiers or a custom data identifier
-    #   and produced a sensitive data finding.
+    #   was detected by a managed data identifier or a custom data
+    #   identifier and produced a sensitive data finding.
     #   @return [Types::Occurrences]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/CustomDetection AWS API Documentation
@@ -1707,15 +1719,15 @@ module Aws::Macie2
     end
 
     # Provides information about a type of sensitive data that was detected
-    # by managed data identifiers and produced a sensitive data finding.
+    # by a managed data identifier and produced a sensitive data finding.
     #
     # @!attribute [rw] count
     #   @return [Integer]
     #
     # @!attribute [rw] occurrences
     #   Specifies the location of 1-15 occurrences of sensitive data that
-    #   was detected by managed data identifiers or a custom data identifier
-    #   and produced a sensitive data finding.
+    #   was detected by a managed data identifier or a custom data
+    #   identifier and produced a sensitive data finding.
     #   @return [Types::Occurrences]
     #
     # @!attribute [rw] type
@@ -1971,6 +1983,14 @@ module Aws::Macie2
     # @!attribute [rw] last_run_time
     #   @return [Time]
     #
+    # @!attribute [rw] managed_data_identifier_ids
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] managed_data_identifier_selector
+    #   The selection type that determines which managed data identifiers a
+    #   classification job uses to analyze data. Valid values are:
+    #   @return [String]
+    #
     # @!attribute [rw] name
     #   @return [String]
     #
@@ -2026,6 +2046,8 @@ module Aws::Macie2
       :job_type,
       :last_run_error_status,
       :last_run_time,
+      :managed_data_identifier_ids,
+      :managed_data_identifier_selector,
       :name,
       :s3_job_definition,
       :sampling_percentage,
@@ -4084,6 +4106,45 @@ module Aws::Macie2
       include Aws::Structure
     end
 
+    # Specifies criteria for paginating the results of a request for
+    # information about managed data identifiers.
+    #
+    # @note When making an API call, you may pass ListManagedDataIdentifiersRequest
+    #   data as a hash:
+    #
+    #       {
+    #         next_token: "__string",
+    #       }
+    #
+    # @!attribute [rw] next_token
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/ListManagedDataIdentifiersRequest AWS API Documentation
+    #
+    class ListManagedDataIdentifiersRequest < Struct.new(
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Provides information about the managed data identifiers that Amazon
+    # Macie currently provides.
+    #
+    # @!attribute [rw] items
+    #   @return [Array<Types::ManagedDataIdentifierSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/ListManagedDataIdentifiersResponse AWS API Documentation
+    #
+    class ListManagedDataIdentifiersResponse < Struct.new(
+      :items,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListMembersRequest
     #   data as a hash:
     #
@@ -4207,6 +4268,33 @@ module Aws::Macie2
       include Aws::Structure
     end
 
+    # Provides information about a managed data identifier. For additional
+    # information, see [Using managed data identifiers][1] in the *Amazon
+    # Macie User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/macie/latest/user/managed-data-identifiers.html
+    #
+    # @!attribute [rw] category
+    #   For a finding, the category of sensitive data that was detected and
+    #   produced the finding. For a managed data identifier, the category of
+    #   sensitive data that the managed data identifier detects. Possible
+    #   values are:
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/macie2-2020-01-01/ManagedDataIdentifierSummary AWS API Documentation
+    #
+    class ManagedDataIdentifierSummary < Struct.new(
+      :category,
+      :id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Provides statistical data and other information about an S3 bucket
     # that Amazon Macie monitors and analyzes.
     #
@@ -4431,7 +4519,7 @@ module Aws::Macie2
     end
 
     # Specifies the location of 1-15 occurrences of sensitive data that was
-    # detected by managed data identifiers or a custom data identifier and
+    # detected by a managed data identifier or a custom data identifier and
     # produced a sensitive data finding.
     #
     # @!attribute [rw] cells
@@ -4722,7 +4810,8 @@ module Aws::Macie2
     #   @return [String]
     #
     # @!attribute [rw] owner
-    #   Provides information about the user who owns an S3 bucket.
+    #   Provides information about the Amazon Web Services account that owns
+    #   an S3 bucket.
     #   @return [Types::S3BucketOwner]
     #
     # @!attribute [rw] public_access
@@ -4849,7 +4938,8 @@ module Aws::Macie2
       include Aws::Structure
     end
 
-    # Provides information about the user who owns an S3 bucket.
+    # Provides information about the Amazon Web Services account that owns
+    # an S3 bucket.
     #
     # @!attribute [rw] display_name
     #   @return [String]
@@ -5590,8 +5680,10 @@ module Aws::Macie2
     # sensitive data that produced a sensitive data finding.
     #
     # @!attribute [rw] category
-    #   The category of sensitive data that was detected and produced the
-    #   finding. Possible values are:
+    #   For a finding, the category of sensitive data that was detected and
+    #   produced the finding. For a managed data identifier, the category of
+    #   sensitive data that the managed data identifier detects. Possible
+    #   values are:
     #   @return [String]
     #
     # @!attribute [rw] detections

data/lib/aws-sdk-macie2.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-macie2
 version: !ruby/object:Gem::Version
-  version: 1.33.0
+  version: 1.34.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-01 00:00:00.000000000 Z
+date: 2021-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core