aws-sdk-comprehend 1.51.0 → 1.52.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a9828628812834dcbad9932c47945231e7ba7f05b3948b59a349d0c7058f09f
-  data.tar.gz: 5141ec47d75e05488aa0fd4304c573d2e903b4072d7215f45aa30b1a42c33f80
+  metadata.gz: 898e5a918006930ceaa12fc25e788b334d8e98be0d636f8716de7aae54c00d31
+  data.tar.gz: b2c62a018c670a264105a95c9fb5e872c50aa18345d85a7788a05529de05a153
 SHA512:
-  metadata.gz: 1f350f13013eb12272326dc8aea2df7dbf74d5e2ee2810febfcfd2badd7ae7169f1a68cff10b8dde8a8bdce477064169bf61a26f3bbf4e5b57077cf0ddd2fc1b
-  data.tar.gz: 4d40609712cf892f49e69f14b20e7a4f4c781b4803336e0bc2803eb4839d5ff072e8143c3d31b74ae10a02b6055349a22374ee72b9123b25c2af5cc5ebcf472d
+  metadata.gz: c05b640caaa2ae7691e376f64125c0156373d531da1e844b1a813195e9a10fc19cee0b7cb43faf221e82482fdeb1a7f0ff8318a12030606f7408683a5936f29f
+  data.tar.gz: ffd392ec11d5a383df1608720d1215b1b257bb234594995661b22f074c032bc48b55d7b3060adde1d88b2fbf06915b6eb699cbd316338b0a752c5b6d0eb16963

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.52.0 (2021-09-21)
+------------------
+
+* Feature - Amazon Comprehend now supports versioning of custom models, improved training with ONE_DOC_PER_FILE text documents for custom entity recognition, ability to provide specific test sets during training, and live migration to new model endpoints.
+
 1.51.0 (2021-09-14)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.51.0
+1.52.0

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

@@ -669,6 +669,13 @@ module Aws::Comprehend
     # @option params [required, String] :document_classifier_name
     #   The name of the document classifier.
     #
+    # @option params [String] :version_name
+    #   The version name given to the newly created classifier. Version names
+    #   can have a maximum of 256 characters. Alphanumeric characters, hyphens
+    #   (-) and underscores (\_) are allowed. The version name must be unique
+    #   among all models with the same classifier name in the account/AWS
+    #   Region.
+    #
     # @option params [required, String] :data_access_role_arn
     #   The Amazon Resource Name (ARN) of the AWS Identity and Management
     #   (IAM) role that grants Amazon Comprehend read access to your input
@@ -746,6 +753,7 @@ module Aws::Comprehend
     #
     #   resp = client.create_document_classifier({
     #     document_classifier_name: "ComprehendArnName", # required
+    #     version_name: "VersionName",
     #     data_access_role_arn: "IamRoleArn", # required
     #     tags: [
     #       {
@@ -756,10 +764,12 @@ module Aws::Comprehend
     #     input_data_config: { # required
     #       data_format: "COMPREHEND_CSV", # accepts COMPREHEND_CSV, AUGMENTED_MANIFEST
     #       s3_uri: "S3Uri",
+    #       test_s3_uri: "S3Uri",
     #       label_delimiter: "LabelDelimiter",
     #       augmented_manifests: [
     #         {
     #           s3_uri: "S3Uri", # required
+    #           split: "TRAIN", # accepts TRAIN, TEST
     #           attribute_names: ["AttributeNamesListItem"], # required
     #           annotation_data_s3_uri: "S3Uri",
     #           source_documents_s3_uri: "S3Uri",
@@ -874,6 +884,13 @@ module Aws::Comprehend
     #   and underscores (\_) are allowed. The name must be unique in the
     #   account/region.
     #
+    # @option params [String] :version_name
+    #   The version name given to the newly created recognizer. Version names
+    #   can be a maximum of 256 characters. Alphanumeric characters, hyphens
+    #   (-) and underscores (\_) are allowed. The version name must be unique
+    #   among all models with the same recognizer name in the account/ AWS
+    #   Region.
+    #
     # @option params [required, String] :data_access_role_arn
     #   The Amazon Resource Name (ARN) of the AWS Identity and Management
     #   (IAM) role that grants Amazon Comprehend read access to your input
@@ -941,6 +958,7 @@ module Aws::Comprehend
     #
     #   resp = client.create_entity_recognizer({
     #     recognizer_name: "ComprehendArnName", # required
+    #     version_name: "VersionName",
     #     data_access_role_arn: "IamRoleArn", # required
     #     tags: [
     #       {
@@ -957,9 +975,12 @@ module Aws::Comprehend
     #       ],
     #       documents: {
     #         s3_uri: "S3Uri", # required
+    #         test_s3_uri: "S3Uri",
+    #         input_format: "ONE_DOC_PER_FILE", # accepts ONE_DOC_PER_FILE, ONE_DOC_PER_LINE
     #       },
     #       annotations: {
     #         s3_uri: "S3Uri", # required
+    #         test_s3_uri: "S3Uri",
     #       },
     #       entity_list: {
     #         s3_uri: "S3Uri", # required
@@ -967,6 +988,7 @@ module Aws::Comprehend
     #       augmented_manifests: [
     #         {
     #           s3_uri: "S3Uri", # required
+    #           split: "TRAIN", # accepts TRAIN, TEST
     #           attribute_names: ["AttributeNamesListItem"], # required
     #           annotation_data_s3_uri: "S3Uri",
     #           source_documents_s3_uri: "S3Uri",
@@ -1163,9 +1185,11 @@ module Aws::Comprehend
     #   resp.document_classifier_properties.training_end_time #=> Time
     #   resp.document_classifier_properties.input_data_config.data_format #=> String, one of "COMPREHEND_CSV", "AUGMENTED_MANIFEST"
     #   resp.document_classifier_properties.input_data_config.s3_uri #=> String
+    #   resp.document_classifier_properties.input_data_config.test_s3_uri #=> String
     #   resp.document_classifier_properties.input_data_config.label_delimiter #=> String
     #   resp.document_classifier_properties.input_data_config.augmented_manifests #=> Array
     #   resp.document_classifier_properties.input_data_config.augmented_manifests[0].s3_uri #=> String
+    #   resp.document_classifier_properties.input_data_config.augmented_manifests[0].split #=> String, one of "TRAIN", "TEST"
     #   resp.document_classifier_properties.input_data_config.augmented_manifests[0].attribute_names #=> Array
     #   resp.document_classifier_properties.input_data_config.augmented_manifests[0].attribute_names[0] #=> String
     #   resp.document_classifier_properties.input_data_config.augmented_manifests[0].annotation_data_s3_uri #=> String
@@ -1192,6 +1216,7 @@ module Aws::Comprehend
     #   resp.document_classifier_properties.vpc_config.subnets[0] #=> String
     #   resp.document_classifier_properties.mode #=> String, one of "MULTI_CLASS", "MULTI_LABEL"
     #   resp.document_classifier_properties.model_kms_key_id #=> String
+    #   resp.document_classifier_properties.version_name #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DescribeDocumentClassifier AWS API Documentation
     #
@@ -1274,11 +1299,13 @@ module Aws::Comprehend
     #   resp.endpoint_properties.status #=> String, one of "CREATING", "DELETING", "FAILED", "IN_SERVICE", "UPDATING"
     #   resp.endpoint_properties.message #=> String
     #   resp.endpoint_properties.model_arn #=> String
+    #   resp.endpoint_properties.desired_model_arn #=> String
     #   resp.endpoint_properties.desired_inference_units #=> Integer
     #   resp.endpoint_properties.current_inference_units #=> Integer
     #   resp.endpoint_properties.creation_time #=> Time
     #   resp.endpoint_properties.last_modified_time #=> Time
     #   resp.endpoint_properties.data_access_role_arn #=> String
+    #   resp.endpoint_properties.desired_data_access_role_arn #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DescribeEndpoint AWS API Documentation
     #
@@ -1372,10 +1399,14 @@ module Aws::Comprehend
     #   resp.entity_recognizer_properties.input_data_config.entity_types #=> Array
     #   resp.entity_recognizer_properties.input_data_config.entity_types[0].type #=> String
     #   resp.entity_recognizer_properties.input_data_config.documents.s3_uri #=> String
+    #   resp.entity_recognizer_properties.input_data_config.documents.test_s3_uri #=> String
+    #   resp.entity_recognizer_properties.input_data_config.documents.input_format #=> String, one of "ONE_DOC_PER_FILE", "ONE_DOC_PER_LINE"
     #   resp.entity_recognizer_properties.input_data_config.annotations.s3_uri #=> String
+    #   resp.entity_recognizer_properties.input_data_config.annotations.test_s3_uri #=> String
     #   resp.entity_recognizer_properties.input_data_config.entity_list.s3_uri #=> String
     #   resp.entity_recognizer_properties.input_data_config.augmented_manifests #=> Array
     #   resp.entity_recognizer_properties.input_data_config.augmented_manifests[0].s3_uri #=> String
+    #   resp.entity_recognizer_properties.input_data_config.augmented_manifests[0].split #=> String, one of "TRAIN", "TEST"
     #   resp.entity_recognizer_properties.input_data_config.augmented_manifests[0].attribute_names #=> Array
     #   resp.entity_recognizer_properties.input_data_config.augmented_manifests[0].attribute_names[0] #=> String
     #   resp.entity_recognizer_properties.input_data_config.augmented_manifests[0].annotation_data_s3_uri #=> String
@@ -1399,6 +1430,7 @@ module Aws::Comprehend
     #   resp.entity_recognizer_properties.vpc_config.subnets #=> Array
     #   resp.entity_recognizer_properties.vpc_config.subnets[0] #=> String
     #   resp.entity_recognizer_properties.model_kms_key_id #=> String
+    #   resp.entity_recognizer_properties.version_name #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DescribeEntityRecognizer AWS API Documentation
     #
@@ -1983,6 +2015,49 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Gets a list of summaries of the document classifiers that you have
+    # created
+    #
+    # @option params [String] :next_token
+    #   Identifies the next page of results to return.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return on each page. The default is
+    #   100.
+    #
+    # @return [Types::ListDocumentClassifierSummariesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListDocumentClassifierSummariesResponse#document_classifier_summaries_list #document_classifier_summaries_list} => Array<Types::DocumentClassifierSummary>
+    #   * {Types::ListDocumentClassifierSummariesResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_document_classifier_summaries({
+    #     next_token: "String",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.document_classifier_summaries_list #=> Array
+    #   resp.document_classifier_summaries_list[0].document_classifier_name #=> String
+    #   resp.document_classifier_summaries_list[0].number_of_versions #=> Integer
+    #   resp.document_classifier_summaries_list[0].latest_version_created_at #=> Time
+    #   resp.document_classifier_summaries_list[0].latest_version_name #=> String
+    #   resp.document_classifier_summaries_list[0].latest_version_status #=> String, one of "SUBMITTED", "TRAINING", "DELETING", "STOP_REQUESTED", "STOPPED", "IN_ERROR", "TRAINED"
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListDocumentClassifierSummaries AWS API Documentation
+    #
+    # @overload list_document_classifier_summaries(params = {})
+    # @param [Hash] params ({})
+    def list_document_classifier_summaries(params = {}, options = {})
+      req = build_request(:list_document_classifier_summaries, params)
+      req.send_request(options)
+    end
+
     # Gets a list of the document classifiers that you have created.
     #
     # @option params [Types::DocumentClassifierFilter] :filter
@@ -2009,6 +2084,7 @@ module Aws::Comprehend
     #   resp = client.list_document_classifiers({
     #     filter: {
     #       status: "SUBMITTED", # accepts SUBMITTED, TRAINING, DELETING, STOP_REQUESTED, STOPPED, IN_ERROR, TRAINED
+    #       document_classifier_name: "ComprehendArnName",
     #       submit_time_before: Time.now,
     #       submit_time_after: Time.now,
     #     },
@@ -2029,9 +2105,11 @@ module Aws::Comprehend
     #   resp.document_classifier_properties_list[0].training_end_time #=> Time
     #   resp.document_classifier_properties_list[0].input_data_config.data_format #=> String, one of "COMPREHEND_CSV", "AUGMENTED_MANIFEST"
     #   resp.document_classifier_properties_list[0].input_data_config.s3_uri #=> String
+    #   resp.document_classifier_properties_list[0].input_data_config.test_s3_uri #=> String
     #   resp.document_classifier_properties_list[0].input_data_config.label_delimiter #=> String
     #   resp.document_classifier_properties_list[0].input_data_config.augmented_manifests #=> Array
     #   resp.document_classifier_properties_list[0].input_data_config.augmented_manifests[0].s3_uri #=> String
+    #   resp.document_classifier_properties_list[0].input_data_config.augmented_manifests[0].split #=> String, one of "TRAIN", "TEST"
     #   resp.document_classifier_properties_list[0].input_data_config.augmented_manifests[0].attribute_names #=> Array
     #   resp.document_classifier_properties_list[0].input_data_config.augmented_manifests[0].attribute_names[0] #=> String
     #   resp.document_classifier_properties_list[0].input_data_config.augmented_manifests[0].annotation_data_s3_uri #=> String
@@ -2058,6 +2136,7 @@ module Aws::Comprehend
     #   resp.document_classifier_properties_list[0].vpc_config.subnets[0] #=> String
     #   resp.document_classifier_properties_list[0].mode #=> String, one of "MULTI_CLASS", "MULTI_LABEL"
     #   resp.document_classifier_properties_list[0].model_kms_key_id #=> String
+    #   resp.document_classifier_properties_list[0].version_name #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListDocumentClassifiers AWS API Documentation
@@ -2178,11 +2257,13 @@ module Aws::Comprehend
     #   resp.endpoint_properties_list[0].status #=> String, one of "CREATING", "DELETING", "FAILED", "IN_SERVICE", "UPDATING"
     #   resp.endpoint_properties_list[0].message #=> String
     #   resp.endpoint_properties_list[0].model_arn #=> String
+    #   resp.endpoint_properties_list[0].desired_model_arn #=> String
     #   resp.endpoint_properties_list[0].desired_inference_units #=> Integer
     #   resp.endpoint_properties_list[0].current_inference_units #=> Integer
     #   resp.endpoint_properties_list[0].creation_time #=> Time
     #   resp.endpoint_properties_list[0].last_modified_time #=> Time
     #   resp.endpoint_properties_list[0].data_access_role_arn #=> String
+    #   resp.endpoint_properties_list[0].desired_data_access_role_arn #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListEndpoints AWS API Documentation
@@ -2265,6 +2346,49 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Gets a list of summaries for the entity recognizers that you have
+    # created.
+    #
+    # @option params [String] :next_token
+    #   Identifies the next page of results to return.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return on each page. The default is
+    #   100.
+    #
+    # @return [Types::ListEntityRecognizerSummariesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListEntityRecognizerSummariesResponse#entity_recognizer_summaries_list #entity_recognizer_summaries_list} => Array<Types::EntityRecognizerSummary>
+    #   * {Types::ListEntityRecognizerSummariesResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_entity_recognizer_summaries({
+    #     next_token: "String",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.entity_recognizer_summaries_list #=> Array
+    #   resp.entity_recognizer_summaries_list[0].recognizer_name #=> String
+    #   resp.entity_recognizer_summaries_list[0].number_of_versions #=> Integer
+    #   resp.entity_recognizer_summaries_list[0].latest_version_created_at #=> Time
+    #   resp.entity_recognizer_summaries_list[0].latest_version_name #=> String
+    #   resp.entity_recognizer_summaries_list[0].latest_version_status #=> String, one of "SUBMITTED", "TRAINING", "DELETING", "STOP_REQUESTED", "STOPPED", "IN_ERROR", "TRAINED"
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListEntityRecognizerSummaries AWS API Documentation
+    #
+    # @overload list_entity_recognizer_summaries(params = {})
+    # @param [Hash] params ({})
+    def list_entity_recognizer_summaries(params = {}, options = {})
+      req = build_request(:list_entity_recognizer_summaries, params)
+      req.send_request(options)
+    end
+
     # Gets a list of the properties of all entity recognizers that you
     # created, including recognizers currently in training. Allows you to
     # filter the list of recognizers based on criteria such as status and
@@ -2298,6 +2422,7 @@ module Aws::Comprehend
     #   resp = client.list_entity_recognizers({
     #     filter: {
     #       status: "SUBMITTED", # accepts SUBMITTED, TRAINING, DELETING, STOP_REQUESTED, STOPPED, IN_ERROR, TRAINED
+    #       recognizer_name: "ComprehendArnName",
     #       submit_time_before: Time.now,
     #       submit_time_after: Time.now,
     #     },
@@ -2320,10 +2445,14 @@ module Aws::Comprehend
     #   resp.entity_recognizer_properties_list[0].input_data_config.entity_types #=> Array
     #   resp.entity_recognizer_properties_list[0].input_data_config.entity_types[0].type #=> String
     #   resp.entity_recognizer_properties_list[0].input_data_config.documents.s3_uri #=> String
+    #   resp.entity_recognizer_properties_list[0].input_data_config.documents.test_s3_uri #=> String
+    #   resp.entity_recognizer_properties_list[0].input_data_config.documents.input_format #=> String, one of "ONE_DOC_PER_FILE", "ONE_DOC_PER_LINE"
     #   resp.entity_recognizer_properties_list[0].input_data_config.annotations.s3_uri #=> String
+    #   resp.entity_recognizer_properties_list[0].input_data_config.annotations.test_s3_uri #=> String
     #   resp.entity_recognizer_properties_list[0].input_data_config.entity_list.s3_uri #=> String
     #   resp.entity_recognizer_properties_list[0].input_data_config.augmented_manifests #=> Array
     #   resp.entity_recognizer_properties_list[0].input_data_config.augmented_manifests[0].s3_uri #=> String
+    #   resp.entity_recognizer_properties_list[0].input_data_config.augmented_manifests[0].split #=> String, one of "TRAIN", "TEST"
     #   resp.entity_recognizer_properties_list[0].input_data_config.augmented_manifests[0].attribute_names #=> Array
     #   resp.entity_recognizer_properties_list[0].input_data_config.augmented_manifests[0].attribute_names[0] #=> String
     #   resp.entity_recognizer_properties_list[0].input_data_config.augmented_manifests[0].annotation_data_s3_uri #=> String
@@ -2347,6 +2476,7 @@ module Aws::Comprehend
     #   resp.entity_recognizer_properties_list[0].vpc_config.subnets #=> Array
     #   resp.entity_recognizer_properties_list[0].vpc_config.subnets[0] #=> String
     #   resp.entity_recognizer_properties_list[0].model_kms_key_id #=> String
+    #   resp.entity_recognizer_properties_list[0].version_name #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListEntityRecognizers AWS API Documentation
@@ -3967,18 +4097,27 @@ module Aws::Comprehend
     # @option params [required, String] :endpoint_arn
     #   The Amazon Resource Number (ARN) of the endpoint being updated.
     #
-    # @option params [required, Integer] :desired_inference_units
+    # @option params [String] :desired_model_arn
+    #   The ARN of the new model to use when updating an existing endpoint.
+    #
+    # @option params [Integer] :desired_inference_units
     #   The desired number of inference units to be used by the model using
     #   this endpoint. Each inference unit represents of a throughput of 100
     #   characters per second.
     #
+    # @option params [String] :desired_data_access_role_arn
+    #   Data access role ARN to use in case the new model is encrypted with a
+    #   customer CMK.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_endpoint({
     #     endpoint_arn: "ComprehendEndpointArn", # required
-    #     desired_inference_units: 1, # required
+    #     desired_model_arn: "ComprehendModelArn",
+    #     desired_inference_units: 1,
+    #     desired_data_access_role_arn: "IamRoleArn",
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/UpdateEndpoint AWS API Documentation
@@ -4003,7 +4142,7 @@ module Aws::Comprehend
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-comprehend'
-      context[:gem_version] = '1.51.0'
+      context[:gem_version] = '1.52.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -111,6 +111,8 @@ module Aws::Comprehend
     DocumentClassifierOutputDataConfig = Shapes::StructureShape.new(name: 'DocumentClassifierOutputDataConfig')
     DocumentClassifierProperties = Shapes::StructureShape.new(name: 'DocumentClassifierProperties')
     DocumentClassifierPropertiesList = Shapes::ListShape.new(name: 'DocumentClassifierPropertiesList')
+    DocumentClassifierSummariesList = Shapes::ListShape.new(name: 'DocumentClassifierSummariesList')
+    DocumentClassifierSummary = Shapes::StructureShape.new(name: 'DocumentClassifierSummary')
     DocumentLabel = Shapes::StructureShape.new(name: 'DocumentLabel')
     DocumentReadAction = Shapes::StringShape.new(name: 'DocumentReadAction')
     DocumentReadFeatureTypes = Shapes::StringShape.new(name: 'DocumentReadFeatureTypes')
@@ -145,6 +147,8 @@ module Aws::Comprehend
     EntityRecognizerMetadataEntityTypesListItem = Shapes::StructureShape.new(name: 'EntityRecognizerMetadataEntityTypesListItem')
     EntityRecognizerProperties = Shapes::StructureShape.new(name: 'EntityRecognizerProperties')
     EntityRecognizerPropertiesList = Shapes::ListShape.new(name: 'EntityRecognizerPropertiesList')
+    EntityRecognizerSummariesList = Shapes::ListShape.new(name: 'EntityRecognizerSummariesList')
+    EntityRecognizerSummary = Shapes::StructureShape.new(name: 'EntityRecognizerSummary')
     EntityType = Shapes::StringShape.new(name: 'EntityType')
     EntityTypeName = Shapes::StringShape.new(name: 'EntityTypeName')
     EntityTypesEvaluationMetrics = Shapes::StructureShape.new(name: 'EntityTypesEvaluationMetrics')
@@ -177,6 +181,8 @@ module Aws::Comprehend
     LanguageCode = Shapes::StringShape.new(name: 'LanguageCode')
     ListDocumentClassificationJobsRequest = Shapes::StructureShape.new(name: 'ListDocumentClassificationJobsRequest')
     ListDocumentClassificationJobsResponse = Shapes::StructureShape.new(name: 'ListDocumentClassificationJobsResponse')
+    ListDocumentClassifierSummariesRequest = Shapes::StructureShape.new(name: 'ListDocumentClassifierSummariesRequest')
+    ListDocumentClassifierSummariesResponse = Shapes::StructureShape.new(name: 'ListDocumentClassifierSummariesResponse')
     ListDocumentClassifiersRequest = Shapes::StructureShape.new(name: 'ListDocumentClassifiersRequest')
     ListDocumentClassifiersResponse = Shapes::StructureShape.new(name: 'ListDocumentClassifiersResponse')
     ListDominantLanguageDetectionJobsRequest = Shapes::StructureShape.new(name: 'ListDominantLanguageDetectionJobsRequest')
@@ -185,6 +191,8 @@ module Aws::Comprehend
     ListEndpointsResponse = Shapes::StructureShape.new(name: 'ListEndpointsResponse')
     ListEntitiesDetectionJobsRequest = Shapes::StructureShape.new(name: 'ListEntitiesDetectionJobsRequest')
     ListEntitiesDetectionJobsResponse = Shapes::StructureShape.new(name: 'ListEntitiesDetectionJobsResponse')
+    ListEntityRecognizerSummariesRequest = Shapes::StructureShape.new(name: 'ListEntityRecognizerSummariesRequest')
+    ListEntityRecognizerSummariesResponse = Shapes::StructureShape.new(name: 'ListEntityRecognizerSummariesResponse')
     ListEntityRecognizersRequest = Shapes::StructureShape.new(name: 'ListEntityRecognizersRequest')
     ListEntityRecognizersResponse = Shapes::StructureShape.new(name: 'ListEntityRecognizersResponse')
     ListEventsDetectionJobsRequest = Shapes::StructureShape.new(name: 'ListEventsDetectionJobsRequest')
@@ -242,6 +250,7 @@ module Aws::Comprehend
     SentimentDetectionJobPropertiesList = Shapes::ListShape.new(name: 'SentimentDetectionJobPropertiesList')
     SentimentScore = Shapes::StructureShape.new(name: 'SentimentScore')
     SentimentType = Shapes::StringShape.new(name: 'SentimentType')
+    Split = Shapes::StringShape.new(name: 'Split')
     StartDocumentClassificationJobRequest = Shapes::StructureShape.new(name: 'StartDocumentClassificationJobRequest')
     StartDocumentClassificationJobResponse = Shapes::StructureShape.new(name: 'StartDocumentClassificationJobResponse')
     StartDominantLanguageDetectionJobRequest = Shapes::StructureShape.new(name: 'StartDominantLanguageDetectionJobRequest')
@@ -300,11 +309,13 @@ module Aws::Comprehend
     UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
     UpdateEndpointRequest = Shapes::StructureShape.new(name: 'UpdateEndpointRequest')
     UpdateEndpointResponse = Shapes::StructureShape.new(name: 'UpdateEndpointResponse')
+    VersionName = Shapes::StringShape.new(name: 'VersionName')
     VpcConfig = Shapes::StructureShape.new(name: 'VpcConfig')
 
     AttributeNamesList.member = Shapes::ShapeRef.new(shape: AttributeNamesListItem)
 
     AugmentedManifestsListItem.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
+    AugmentedManifestsListItem.add_member(:split, Shapes::ShapeRef.new(shape: Split, location_name: "Split"))
     AugmentedManifestsListItem.add_member(:attribute_names, Shapes::ShapeRef.new(shape: AttributeNamesList, required: true, location_name: "AttributeNames"))
     AugmentedManifestsListItem.add_member(:annotation_data_s3_uri, Shapes::ShapeRef.new(shape: S3Uri, location_name: "AnnotationDataS3Uri"))
     AugmentedManifestsListItem.add_member(:source_documents_s3_uri, Shapes::ShapeRef.new(shape: S3Uri, location_name: "SourceDocumentsS3Uri"))
@@ -416,6 +427,7 @@ module Aws::Comprehend
     ContainsPiiEntitiesResponse.struct_class = Types::ContainsPiiEntitiesResponse
 
     CreateDocumentClassifierRequest.add_member(:document_classifier_name, Shapes::ShapeRef.new(shape: ComprehendArnName, required: true, location_name: "DocumentClassifierName"))
+    CreateDocumentClassifierRequest.add_member(:version_name, Shapes::ShapeRef.new(shape: VersionName, location_name: "VersionName"))
     CreateDocumentClassifierRequest.add_member(:data_access_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, required: true, location_name: "DataAccessRoleArn"))
     CreateDocumentClassifierRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     CreateDocumentClassifierRequest.add_member(:input_data_config, Shapes::ShapeRef.new(shape: DocumentClassifierInputDataConfig, required: true, location_name: "InputDataConfig"))
@@ -443,6 +455,7 @@ module Aws::Comprehend
     CreateEndpointResponse.struct_class = Types::CreateEndpointResponse
 
     CreateEntityRecognizerRequest.add_member(:recognizer_name, Shapes::ShapeRef.new(shape: ComprehendArnName, required: true, location_name: "RecognizerName"))
+    CreateEntityRecognizerRequest.add_member(:version_name, Shapes::ShapeRef.new(shape: VersionName, location_name: "VersionName"))
     CreateEntityRecognizerRequest.add_member(:data_access_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, required: true, location_name: "DataAccessRoleArn"))
     CreateEntityRecognizerRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     CreateEntityRecognizerRequest.add_member(:input_data_config, Shapes::ShapeRef.new(shape: EntityRecognizerInputDataConfig, required: true, location_name: "InputDataConfig"))
@@ -612,12 +625,14 @@ module Aws::Comprehend
     DocumentClassifierAugmentedManifestsList.member = Shapes::ShapeRef.new(shape: AugmentedManifestsListItem)
 
     DocumentClassifierFilter.add_member(:status, Shapes::ShapeRef.new(shape: ModelStatus, location_name: "Status"))
+    DocumentClassifierFilter.add_member(:document_classifier_name, Shapes::ShapeRef.new(shape: ComprehendArnName, location_name: "DocumentClassifierName"))
     DocumentClassifierFilter.add_member(:submit_time_before, Shapes::ShapeRef.new(shape: Timestamp, location_name: "SubmitTimeBefore"))
     DocumentClassifierFilter.add_member(:submit_time_after, Shapes::ShapeRef.new(shape: Timestamp, location_name: "SubmitTimeAfter"))
     DocumentClassifierFilter.struct_class = Types::DocumentClassifierFilter
 
     DocumentClassifierInputDataConfig.add_member(:data_format, Shapes::ShapeRef.new(shape: DocumentClassifierDataFormat, location_name: "DataFormat"))
     DocumentClassifierInputDataConfig.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, location_name: "S3Uri"))
+    DocumentClassifierInputDataConfig.add_member(:test_s3_uri, Shapes::ShapeRef.new(shape: S3Uri, location_name: "TestS3Uri"))
     DocumentClassifierInputDataConfig.add_member(:label_delimiter, Shapes::ShapeRef.new(shape: LabelDelimiter, location_name: "LabelDelimiter"))
     DocumentClassifierInputDataConfig.add_member(:augmented_manifests, Shapes::ShapeRef.new(shape: DocumentClassifierAugmentedManifestsList, location_name: "AugmentedManifests"))
     DocumentClassifierInputDataConfig.struct_class = Types::DocumentClassifierInputDataConfig
@@ -642,10 +657,20 @@ module Aws::Comprehend
     DocumentClassifierProperties.add_member(:vpc_config, Shapes::ShapeRef.new(shape: VpcConfig, location_name: "VpcConfig"))
     DocumentClassifierProperties.add_member(:mode, Shapes::ShapeRef.new(shape: DocumentClassifierMode, location_name: "Mode"))
     DocumentClassifierProperties.add_member(:model_kms_key_id, Shapes::ShapeRef.new(shape: KmsKeyId, location_name: "ModelKmsKeyId"))
+    DocumentClassifierProperties.add_member(:version_name, Shapes::ShapeRef.new(shape: VersionName, location_name: "VersionName"))
     DocumentClassifierProperties.struct_class = Types::DocumentClassifierProperties
 
     DocumentClassifierPropertiesList.member = Shapes::ShapeRef.new(shape: DocumentClassifierProperties)
 
+    DocumentClassifierSummariesList.member = Shapes::ShapeRef.new(shape: DocumentClassifierSummary)
+
+    DocumentClassifierSummary.add_member(:document_classifier_name, Shapes::ShapeRef.new(shape: ComprehendArnName, location_name: "DocumentClassifierName"))
+    DocumentClassifierSummary.add_member(:number_of_versions, Shapes::ShapeRef.new(shape: Integer, location_name: "NumberOfVersions"))
+    DocumentClassifierSummary.add_member(:latest_version_created_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LatestVersionCreatedAt"))
+    DocumentClassifierSummary.add_member(:latest_version_name, Shapes::ShapeRef.new(shape: VersionName, location_name: "LatestVersionName"))
+    DocumentClassifierSummary.add_member(:latest_version_status, Shapes::ShapeRef.new(shape: ModelStatus, location_name: "LatestVersionStatus"))
+    DocumentClassifierSummary.struct_class = Types::DocumentClassifierSummary
+
     DocumentLabel.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
     DocumentLabel.add_member(:score, Shapes::ShapeRef.new(shape: Float, location_name: "Score"))
     DocumentLabel.struct_class = Types::DocumentLabel
@@ -691,11 +716,13 @@ module Aws::Comprehend
     EndpointProperties.add_member(:status, Shapes::ShapeRef.new(shape: EndpointStatus, location_name: "Status"))
     EndpointProperties.add_member(:message, Shapes::ShapeRef.new(shape: AnyLengthString, location_name: "Message"))
     EndpointProperties.add_member(:model_arn, Shapes::ShapeRef.new(shape: ComprehendModelArn, location_name: "ModelArn"))
+    EndpointProperties.add_member(:desired_model_arn, Shapes::ShapeRef.new(shape: ComprehendModelArn, location_name: "DesiredModelArn"))
     EndpointProperties.add_member(:desired_inference_units, Shapes::ShapeRef.new(shape: InferenceUnitsInteger, location_name: "DesiredInferenceUnits"))
     EndpointProperties.add_member(:current_inference_units, Shapes::ShapeRef.new(shape: InferenceUnitsInteger, location_name: "CurrentInferenceUnits"))
     EndpointProperties.add_member(:creation_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreationTime"))
     EndpointProperties.add_member(:last_modified_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastModifiedTime"))
     EndpointProperties.add_member(:data_access_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, location_name: "DataAccessRoleArn"))
+    EndpointProperties.add_member(:desired_data_access_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, location_name: "DesiredDataAccessRoleArn"))
     EndpointProperties.struct_class = Types::EndpointProperties
 
     EndpointPropertiesList.member = Shapes::ShapeRef.new(shape: EndpointProperties)
@@ -736,11 +763,14 @@ module Aws::Comprehend
     EntityLabel.struct_class = Types::EntityLabel
 
     EntityRecognizerAnnotations.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
+    EntityRecognizerAnnotations.add_member(:test_s3_uri, Shapes::ShapeRef.new(shape: S3Uri, location_name: "TestS3Uri"))
     EntityRecognizerAnnotations.struct_class = Types::EntityRecognizerAnnotations
 
     EntityRecognizerAugmentedManifestsList.member = Shapes::ShapeRef.new(shape: AugmentedManifestsListItem)
 
     EntityRecognizerDocuments.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
+    EntityRecognizerDocuments.add_member(:test_s3_uri, Shapes::ShapeRef.new(shape: S3Uri, location_name: "TestS3Uri"))
+    EntityRecognizerDocuments.add_member(:input_format, Shapes::ShapeRef.new(shape: InputFormat, location_name: "InputFormat"))
     EntityRecognizerDocuments.struct_class = Types::EntityRecognizerDocuments
 
     EntityRecognizerEntityList.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
@@ -752,6 +782,7 @@ module Aws::Comprehend
     EntityRecognizerEvaluationMetrics.struct_class = Types::EntityRecognizerEvaluationMetrics
 
     EntityRecognizerFilter.add_member(:status, Shapes::ShapeRef.new(shape: ModelStatus, location_name: "Status"))
+    EntityRecognizerFilter.add_member(:recognizer_name, Shapes::ShapeRef.new(shape: ComprehendArnName, location_name: "RecognizerName"))
     EntityRecognizerFilter.add_member(:submit_time_before, Shapes::ShapeRef.new(shape: Timestamp, location_name: "SubmitTimeBefore"))
     EntityRecognizerFilter.add_member(:submit_time_after, Shapes::ShapeRef.new(shape: Timestamp, location_name: "SubmitTimeAfter"))
     EntityRecognizerFilter.struct_class = Types::EntityRecognizerFilter
@@ -791,10 +822,20 @@ module Aws::Comprehend
     EntityRecognizerProperties.add_member(:volume_kms_key_id, Shapes::ShapeRef.new(shape: KmsKeyId, location_name: "VolumeKmsKeyId"))
     EntityRecognizerProperties.add_member(:vpc_config, Shapes::ShapeRef.new(shape: VpcConfig, location_name: "VpcConfig"))
     EntityRecognizerProperties.add_member(:model_kms_key_id, Shapes::ShapeRef.new(shape: KmsKeyId, location_name: "ModelKmsKeyId"))
+    EntityRecognizerProperties.add_member(:version_name, Shapes::ShapeRef.new(shape: VersionName, location_name: "VersionName"))
     EntityRecognizerProperties.struct_class = Types::EntityRecognizerProperties
 
     EntityRecognizerPropertiesList.member = Shapes::ShapeRef.new(shape: EntityRecognizerProperties)
 
+    EntityRecognizerSummariesList.member = Shapes::ShapeRef.new(shape: EntityRecognizerSummary)
+
+    EntityRecognizerSummary.add_member(:recognizer_name, Shapes::ShapeRef.new(shape: ComprehendArnName, location_name: "RecognizerName"))
+    EntityRecognizerSummary.add_member(:number_of_versions, Shapes::ShapeRef.new(shape: Integer, location_name: "NumberOfVersions"))
+    EntityRecognizerSummary.add_member(:latest_version_created_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LatestVersionCreatedAt"))
+    EntityRecognizerSummary.add_member(:latest_version_name, Shapes::ShapeRef.new(shape: VersionName, location_name: "LatestVersionName"))
+    EntityRecognizerSummary.add_member(:latest_version_status, Shapes::ShapeRef.new(shape: ModelStatus, location_name: "LatestVersionStatus"))
+    EntityRecognizerSummary.struct_class = Types::EntityRecognizerSummary
+
     EntityTypesEvaluationMetrics.add_member(:precision, Shapes::ShapeRef.new(shape: Double, location_name: "Precision"))
     EntityTypesEvaluationMetrics.add_member(:recall, Shapes::ShapeRef.new(shape: Double, location_name: "Recall"))
     EntityTypesEvaluationMetrics.add_member(:f1_score, Shapes::ShapeRef.new(shape: Double, location_name: "F1Score"))
@@ -885,6 +926,14 @@ module Aws::Comprehend
     ListDocumentClassificationJobsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
     ListDocumentClassificationJobsResponse.struct_class = Types::ListDocumentClassificationJobsResponse
 
+    ListDocumentClassifierSummariesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
+    ListDocumentClassifierSummariesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResultsInteger, location_name: "MaxResults"))
+    ListDocumentClassifierSummariesRequest.struct_class = Types::ListDocumentClassifierSummariesRequest
+
+    ListDocumentClassifierSummariesResponse.add_member(:document_classifier_summaries_list, Shapes::ShapeRef.new(shape: DocumentClassifierSummariesList, location_name: "DocumentClassifierSummariesList"))
+    ListDocumentClassifierSummariesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
+    ListDocumentClassifierSummariesResponse.struct_class = Types::ListDocumentClassifierSummariesResponse
+
     ListDocumentClassifiersRequest.add_member(:filter, Shapes::ShapeRef.new(shape: DocumentClassifierFilter, location_name: "Filter"))
     ListDocumentClassifiersRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
     ListDocumentClassifiersRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResultsInteger, location_name: "MaxResults"))
@@ -921,6 +970,14 @@ module Aws::Comprehend
     ListEntitiesDetectionJobsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
     ListEntitiesDetectionJobsResponse.struct_class = Types::ListEntitiesDetectionJobsResponse
 
+    ListEntityRecognizerSummariesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
+    ListEntityRecognizerSummariesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResultsInteger, location_name: "MaxResults"))
+    ListEntityRecognizerSummariesRequest.struct_class = Types::ListEntityRecognizerSummariesRequest
+
+    ListEntityRecognizerSummariesResponse.add_member(:entity_recognizer_summaries_list, Shapes::ShapeRef.new(shape: EntityRecognizerSummariesList, location_name: "EntityRecognizerSummariesList"))
+    ListEntityRecognizerSummariesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
+    ListEntityRecognizerSummariesResponse.struct_class = Types::ListEntityRecognizerSummariesResponse
+
     ListEntityRecognizersRequest.add_member(:filter, Shapes::ShapeRef.new(shape: EntityRecognizerFilter, location_name: "Filter"))
     ListEntityRecognizersRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
     ListEntityRecognizersRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResultsInteger, location_name: "MaxResults"))
@@ -1350,7 +1407,9 @@ module Aws::Comprehend
     UntagResourceResponse.struct_class = Types::UntagResourceResponse
 
     UpdateEndpointRequest.add_member(:endpoint_arn, Shapes::ShapeRef.new(shape: ComprehendEndpointArn, required: true, location_name: "EndpointArn"))
-    UpdateEndpointRequest.add_member(:desired_inference_units, Shapes::ShapeRef.new(shape: InferenceUnitsInteger, required: true, location_name: "DesiredInferenceUnits"))
+    UpdateEndpointRequest.add_member(:desired_model_arn, Shapes::ShapeRef.new(shape: ComprehendModelArn, location_name: "DesiredModelArn"))
+    UpdateEndpointRequest.add_member(:desired_inference_units, Shapes::ShapeRef.new(shape: InferenceUnitsInteger, location_name: "DesiredInferenceUnits"))
+    UpdateEndpointRequest.add_member(:desired_data_access_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, location_name: "DesiredDataAccessRoleArn"))
     UpdateEndpointRequest.struct_class = Types::UpdateEndpointRequest
 
     UpdateEndpointResponse.struct_class = Types::UpdateEndpointResponse
@@ -1777,6 +1836,23 @@ module Aws::Comprehend
         )
       end)
 
+      api.add_operation(:list_document_classifier_summaries, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListDocumentClassifierSummaries"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListDocumentClassifierSummariesRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListDocumentClassifierSummariesResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_document_classifiers, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListDocumentClassifiers"
         o.http_method = "POST"
@@ -1842,6 +1918,23 @@ module Aws::Comprehend
         )
       end)
 
+      api.add_operation(:list_entity_recognizer_summaries, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListEntityRecognizerSummaries"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListEntityRecognizerSummariesRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListEntityRecognizerSummariesResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_entity_recognizers, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListEntityRecognizers"
         o.http_method = "POST"

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

@@ -19,6 +19,7 @@ module Aws::Comprehend
     #
     #       {
     #         s3_uri: "S3Uri", # required
+    #         split: "TRAIN", # accepts TRAIN, TEST
     #         attribute_names: ["AttributeNamesListItem"], # required
     #         annotation_data_s3_uri: "S3Uri",
     #         source_documents_s3_uri: "S3Uri",
@@ -29,6 +30,20 @@ module Aws::Comprehend
     #   The Amazon S3 location of the augmented manifest file.
     #   @return [String]
     #
+    # @!attribute [rw] split
+    #   The purpose of the data you've provided in the augmented manifest.
+    #   You can either train or test this data. If you don't specify, the
+    #   default is train.
+    #
+    #   TRAIN - all of the documents in the manifest will be used for
+    #   training. If no test documents are provided, Amazon Comprehend will
+    #   automatically reserve a portion of the training documents for
+    #   testing.
+    #
+    #   TEST - all of the documents in the manifest will be used for
+    #   testing.
+    #   @return [String]
+    #
     # @!attribute [rw] attribute_names
     #   The JSON attribute that contains the annotations for your training
     #   documents. The number of attribute names that you specify depends on
@@ -73,6 +88,7 @@ module Aws::Comprehend
     #
     class AugmentedManifestsListItem < Struct.new(
       :s3_uri,
+      :split,
       :attribute_names,
       :annotation_data_s3_uri,
       :source_documents_s3_uri,
@@ -707,6 +723,7 @@ module Aws::Comprehend
     #
     #       {
     #         document_classifier_name: "ComprehendArnName", # required
+    #         version_name: "VersionName",
     #         data_access_role_arn: "IamRoleArn", # required
     #         tags: [
     #           {
@@ -717,10 +734,12 @@ module Aws::Comprehend
     #         input_data_config: { # required
     #           data_format: "COMPREHEND_CSV", # accepts COMPREHEND_CSV, AUGMENTED_MANIFEST
     #           s3_uri: "S3Uri",
+    #           test_s3_uri: "S3Uri",
     #           label_delimiter: "LabelDelimiter",
     #           augmented_manifests: [
     #             {
     #               s3_uri: "S3Uri", # required
+    #               split: "TRAIN", # accepts TRAIN, TEST
     #               attribute_names: ["AttributeNamesListItem"], # required
     #               annotation_data_s3_uri: "S3Uri",
     #               source_documents_s3_uri: "S3Uri",
@@ -747,6 +766,14 @@ module Aws::Comprehend
     #   The name of the document classifier.
     #   @return [String]
     #
+    # @!attribute [rw] version_name
+    #   The version name given to the newly created classifier. Version
+    #   names can have a maximum of 256 characters. Alphanumeric characters,
+    #   hyphens (-) and underscores (\_) are allowed. The version name must
+    #   be unique among all models with the same classifier name in the
+    #   account/AWS Region.
+    #   @return [String]
+    #
     # @!attribute [rw] data_access_role_arn
     #   The Amazon Resource Name (ARN) of the AWS Identity and Management
     #   (IAM) role that grants Amazon Comprehend read access to your input
@@ -832,6 +859,7 @@ module Aws::Comprehend
     #
     class CreateDocumentClassifierRequest < Struct.new(
       :document_classifier_name,
+      :version_name,
       :data_access_role_arn,
       :tags,
       :input_data_config,
@@ -945,6 +973,7 @@ module Aws::Comprehend
     #
     #       {
     #         recognizer_name: "ComprehendArnName", # required
+    #         version_name: "VersionName",
     #         data_access_role_arn: "IamRoleArn", # required
     #         tags: [
     #           {
@@ -961,9 +990,12 @@ module Aws::Comprehend
     #           ],
     #           documents: {
     #             s3_uri: "S3Uri", # required
+    #             test_s3_uri: "S3Uri",
+    #             input_format: "ONE_DOC_PER_FILE", # accepts ONE_DOC_PER_FILE, ONE_DOC_PER_LINE
     #           },
     #           annotations: {
     #             s3_uri: "S3Uri", # required
+    #             test_s3_uri: "S3Uri",
     #           },
     #           entity_list: {
     #             s3_uri: "S3Uri", # required
@@ -971,6 +1003,7 @@ module Aws::Comprehend
     #           augmented_manifests: [
     #             {
     #               s3_uri: "S3Uri", # required
+    #               split: "TRAIN", # accepts TRAIN, TEST
     #               attribute_names: ["AttributeNamesListItem"], # required
     #               annotation_data_s3_uri: "S3Uri",
     #               source_documents_s3_uri: "S3Uri",
@@ -995,6 +1028,14 @@ module Aws::Comprehend
     #   account/region.
     #   @return [String]
     #
+    # @!attribute [rw] version_name
+    #   The version name given to the newly created recognizer. Version
+    #   names can be a maximum of 256 characters. Alphanumeric characters,
+    #   hyphens (-) and underscores (\_) are allowed. The version name must
+    #   be unique among all models with the same recognizer name in the
+    #   account/ AWS Region.
+    #   @return [String]
+    #
     # @!attribute [rw] data_access_role_arn
     #   The Amazon Resource Name (ARN) of the AWS Identity and Management
     #   (IAM) role that grants Amazon Comprehend read access to your input
@@ -1067,6 +1108,7 @@ module Aws::Comprehend
     #
     class CreateEntityRecognizerRequest < Struct.new(
       :recognizer_name,
+      :version_name,
       :data_access_role_arn,
       :tags,
       :input_data_config,
@@ -1984,6 +2026,7 @@ module Aws::Comprehend
     #
     #       {
     #         status: "SUBMITTED", # accepts SUBMITTED, TRAINING, DELETING, STOP_REQUESTED, STOPPED, IN_ERROR, TRAINED
+    #         document_classifier_name: "ComprehendArnName",
     #         submit_time_before: Time.now,
     #         submit_time_after: Time.now,
     #       }
@@ -1992,6 +2035,10 @@ module Aws::Comprehend
     #   Filters the list of classifiers based on status.
     #   @return [String]
     #
+    # @!attribute [rw] document_classifier_name
+    #   The name that you assigned to the document classifier
+    #   @return [String]
+    #
     # @!attribute [rw] submit_time_before
     #   Filters the list of classifiers based on the time that the
     #   classifier was submitted for processing. Returns only classifiers
@@ -2010,6 +2057,7 @@ module Aws::Comprehend
     #
     class DocumentClassifierFilter < Struct.new(
       :status,
+      :document_classifier_name,
       :submit_time_before,
       :submit_time_after)
       SENSITIVE = []
@@ -2027,10 +2075,12 @@ module Aws::Comprehend
     #       {
     #         data_format: "COMPREHEND_CSV", # accepts COMPREHEND_CSV, AUGMENTED_MANIFEST
     #         s3_uri: "S3Uri",
+    #         test_s3_uri: "S3Uri",
     #         label_delimiter: "LabelDelimiter",
     #         augmented_manifests: [
     #           {
     #             s3_uri: "S3Uri", # required
+    #             split: "TRAIN", # accepts TRAIN, TEST
     #             attribute_names: ["AttributeNamesListItem"], # required
     #             annotation_data_s3_uri: "S3Uri",
     #             source_documents_s3_uri: "S3Uri",
@@ -2074,6 +2124,13 @@ module Aws::Comprehend
     #   `COMPREHEND_CSV`.
     #   @return [String]
     #
+    # @!attribute [rw] test_s3_uri
+    #   The Amazon S3 URI for the input data. The Amazon S3 bucket must be
+    #   in the same AWS Region as the API endpoint that you are calling. The
+    #   URI can point to a single input file or it can provide the prefix
+    #   for a collection of input files.
+    #   @return [String]
+    #
     # @!attribute [rw] label_delimiter
     #   Indicates the delimiter used to separate each label for training a
     #   multi-label classifier. The default delimiter between labels is a
@@ -2098,6 +2155,7 @@ module Aws::Comprehend
     class DocumentClassifierInputDataConfig < Struct.new(
       :data_format,
       :s3_uri,
+      :test_s3_uri,
       :label_delimiter,
       :augmented_manifests)
       SENSITIVE = []
@@ -2259,6 +2317,10 @@ module Aws::Comprehend
     #     `"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"`
     #   @return [String]
     #
+    # @!attribute [rw] version_name
+    #   The version name that you assigned to the document classifier.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DocumentClassifierProperties AWS API Documentation
     #
     class DocumentClassifierProperties < Struct.new(
@@ -2277,11 +2339,48 @@ module Aws::Comprehend
       :volume_kms_key_id,
       :vpc_config,
       :mode,
-      :model_kms_key_id)
+      :model_kms_key_id,
+      :version_name)
       SENSITIVE = [:classifier_metadata]
       include Aws::Structure
     end
 
+    # Describes information about a document classifier and its versions.
+    #
+    # @!attribute [rw] document_classifier_name
+    #   The name that you assigned the document classifier.
+    #   @return [String]
+    #
+    # @!attribute [rw] number_of_versions
+    #   The number of versions you created.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] latest_version_created_at
+    #   The time that the latest document classifier version was submitted
+    #   for processing.
+    #   @return [Time]
+    #
+    # @!attribute [rw] latest_version_name
+    #   The version name you assigned to the latest document classifier
+    #   version.
+    #   @return [String]
+    #
+    # @!attribute [rw] latest_version_status
+    #   Provides the status of the latest document classifier version.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DocumentClassifierSummary AWS API Documentation
+    #
+    class DocumentClassifierSummary < Struct.new(
+      :document_classifier_name,
+      :number_of_versions,
+      :latest_version_created_at,
+      :latest_version_name,
+      :latest_version_status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Specifies one of the label or labels that categorize the document
     # being analyzed.
     #
@@ -2588,6 +2687,12 @@ module Aws::Comprehend
     #   is attached.
     #   @return [String]
     #
+    # @!attribute [rw] desired_model_arn
+    #   ARN of the new model to use for updating an existing endpoint. This
+    #   ARN is going to be different from the model ARN when the update is
+    #   in progress
+    #   @return [String]
+    #
     # @!attribute [rw] desired_inference_units
     #   The desired number of inference units to be used by the model using
     #   this endpoint. Each inference unit represents of a throughput of 100
@@ -2614,6 +2719,11 @@ module Aws::Comprehend
     #   (ModelKmsKeyId).
     #   @return [String]
     #
+    # @!attribute [rw] desired_data_access_role_arn
+    #   Data access role ARN to use in case the new model is encrypted with
+    #   a customer KMS key.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EndpointProperties AWS API Documentation
     #
     class EndpointProperties < Struct.new(
@@ -2621,11 +2731,13 @@ module Aws::Comprehend
       :status,
       :message,
       :model_arn,
+      :desired_model_arn,
       :desired_inference_units,
       :current_inference_units,
       :creation_time,
       :last_modified_time,
-      :data_access_role_arn)
+      :data_access_role_arn,
+      :desired_data_access_role_arn)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2857,6 +2969,7 @@ module Aws::Comprehend
     #
     #       {
     #         s3_uri: "S3Uri", # required
+    #         test_s3_uri: "S3Uri",
     #       }
     #
     # @!attribute [rw] s3_uri
@@ -2865,10 +2978,17 @@ module Aws::Comprehend
     #   API endpoint that you are calling.
     #   @return [String]
     #
+    # @!attribute [rw] test_s3_uri
+    #   This specifies the Amazon S3 location where the test annotations for
+    #   an entity recognizer are located. The URI must be in the same AWS
+    #   Region as the API endpoint that you are calling.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerAnnotations AWS API Documentation
     #
     class EntityRecognizerAnnotations < Struct.new(
-      :s3_uri)
+      :s3_uri,
+      :test_s3_uri)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2880,6 +3000,8 @@ module Aws::Comprehend
     #
     #       {
     #         s3_uri: "S3Uri", # required
+    #         test_s3_uri: "S3Uri",
+    #         input_format: "ONE_DOC_PER_FILE", # accepts ONE_DOC_PER_FILE, ONE_DOC_PER_LINE
     #       }
     #
     # @!attribute [rw] s3_uri
@@ -2888,10 +3010,28 @@ module Aws::Comprehend
     #   the API endpoint that you are calling.
     #   @return [String]
     #
+    # @!attribute [rw] test_s3_uri
+    #   Specifies the Amazon S3 location where the test documents for an
+    #   entity recognizer are located. The URI must be in the same AWS
+    #   Region as the API endpoint that you are calling.
+    #   @return [String]
+    #
+    # @!attribute [rw] input_format
+    #   Specifies how the text in an input file should be processed. This is
+    #   optional, and the default is ONE\_DOC\_PER\_LINE.
+    #   ONE\_DOC\_PER\_FILE - Each file is considered a separate document.
+    #   Use this option when you are processing large documents, such as
+    #   newspaper articles or scientific papers. ONE\_DOC\_PER\_LINE - Each
+    #   line in a file is considered a separate document. Use this option
+    #   when you are processing many short documents, such as text messages.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerDocuments AWS API Documentation
     #
     class EntityRecognizerDocuments < Struct.new(
-      :s3_uri)
+      :s3_uri,
+      :test_s3_uri,
+      :input_format)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2959,6 +3099,7 @@ module Aws::Comprehend
     #
     #       {
     #         status: "SUBMITTED", # accepts SUBMITTED, TRAINING, DELETING, STOP_REQUESTED, STOPPED, IN_ERROR, TRAINED
+    #         recognizer_name: "ComprehendArnName",
     #         submit_time_before: Time.now,
     #         submit_time_after: Time.now,
     #       }
@@ -2967,6 +3108,10 @@ module Aws::Comprehend
     #   The status of an entity recognizer.
     #   @return [String]
     #
+    # @!attribute [rw] recognizer_name
+    #   The name that you assigned the entity recognizer.
+    #   @return [String]
+    #
     # @!attribute [rw] submit_time_before
     #   Filters the list of entities based on the time that the list was
     #   submitted for processing. Returns only jobs submitted before the
@@ -2985,6 +3130,7 @@ module Aws::Comprehend
     #
     class EntityRecognizerFilter < Struct.new(
       :status,
+      :recognizer_name,
       :submit_time_before,
       :submit_time_after)
       SENSITIVE = []
@@ -3005,9 +3151,12 @@ module Aws::Comprehend
     #         ],
     #         documents: {
     #           s3_uri: "S3Uri", # required
+    #           test_s3_uri: "S3Uri",
+    #           input_format: "ONE_DOC_PER_FILE", # accepts ONE_DOC_PER_FILE, ONE_DOC_PER_LINE
     #         },
     #         annotations: {
     #           s3_uri: "S3Uri", # required
+    #           test_s3_uri: "S3Uri",
     #         },
     #         entity_list: {
     #           s3_uri: "S3Uri", # required
@@ -3015,6 +3164,7 @@ module Aws::Comprehend
     #         augmented_manifests: [
     #           {
     #             s3_uri: "S3Uri", # required
+    #             split: "TRAIN", # accepts TRAIN, TEST
     #             attribute_names: ["AttributeNamesListItem"], # required
     #             annotation_data_s3_uri: "S3Uri",
     #             source_documents_s3_uri: "S3Uri",
@@ -3246,6 +3396,10 @@ module Aws::Comprehend
     #     `"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"`
     #   @return [String]
     #
+    # @!attribute [rw] version_name
+    #   The version name you assigned to the entity recognizer.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerProperties AWS API Documentation
     #
     class EntityRecognizerProperties < Struct.new(
@@ -3262,11 +3416,48 @@ module Aws::Comprehend
       :data_access_role_arn,
       :volume_kms_key_id,
       :vpc_config,
-      :model_kms_key_id)
+      :model_kms_key_id,
+      :version_name)
       SENSITIVE = [:recognizer_metadata]
       include Aws::Structure
     end
 
+    # Describes the information about an entity recognizer and its versions.
+    #
+    # @!attribute [rw] recognizer_name
+    #   The name that you assigned the entity recognizer.
+    #   @return [String]
+    #
+    # @!attribute [rw] number_of_versions
+    #   The number of versions you created.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] latest_version_created_at
+    #   The time that the latest entity recognizer version was submitted for
+    #   processing.
+    #   @return [Time]
+    #
+    # @!attribute [rw] latest_version_name
+    #   The version name you assigned to the latest entity recognizer
+    #   version.
+    #   @return [String]
+    #
+    # @!attribute [rw] latest_version_status
+    #   Provides the status of the latest entity recognizer version.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerSummary AWS API Documentation
+    #
+    class EntityRecognizerSummary < Struct.new(
+      :recognizer_name,
+      :number_of_versions,
+      :latest_version_created_at,
+      :latest_version_name,
+      :latest_version_status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Detailed information about the accuracy of an entity recognizer for a
     # specific entity type.
     #
@@ -3825,12 +4016,56 @@ module Aws::Comprehend
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ListDocumentClassifierSummariesRequest
+    #   data as a hash:
+    #
+    #       {
+    #         next_token: "String",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] next_token
+    #   Identifies the next page of results to return.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return on each page. The default is
+    #   100.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListDocumentClassifierSummariesRequest AWS API Documentation
+    #
+    class ListDocumentClassifierSummariesRequest < Struct.new(
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] document_classifier_summaries_list
+    #   The list of summaries of document classifiers.
+    #   @return [Array<Types::DocumentClassifierSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   Identifies the next page of results to return.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListDocumentClassifierSummariesResponse AWS API Documentation
+    #
+    class ListDocumentClassifierSummariesResponse < Struct.new(
+      :document_classifier_summaries_list,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListDocumentClassifiersRequest
     #   data as a hash:
     #
     #       {
     #         filter: {
     #           status: "SUBMITTED", # accepts SUBMITTED, TRAINING, DELETING, STOP_REQUESTED, STOPPED, IN_ERROR, TRAINED
+    #           document_classifier_name: "ComprehendArnName",
     #           submit_time_before: Time.now,
     #           submit_time_after: Time.now,
     #         },
@@ -4049,12 +4284,56 @@ module Aws::Comprehend
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ListEntityRecognizerSummariesRequest
+    #   data as a hash:
+    #
+    #       {
+    #         next_token: "String",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] next_token
+    #   Identifies the next page of results to return.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return on each page. The default is
+    #   100.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListEntityRecognizerSummariesRequest AWS API Documentation
+    #
+    class ListEntityRecognizerSummariesRequest < Struct.new(
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] entity_recognizer_summaries_list
+    #   The list entity recognizer summaries.
+    #   @return [Array<Types::EntityRecognizerSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   The list entity recognizer summaries.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListEntityRecognizerSummariesResponse AWS API Documentation
+    #
+    class ListEntityRecognizerSummariesResponse < Struct.new(
+      :entity_recognizer_summaries_list,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListEntityRecognizersRequest
     #   data as a hash:
     #
     #       {
     #         filter: {
     #           status: "SUBMITTED", # accepts SUBMITTED, TRAINING, DELETING, STOP_REQUESTED, STOPPED, IN_ERROR, TRAINED
+    #           recognizer_name: "ComprehendArnName",
     #           submit_time_before: Time.now,
     #           submit_time_after: Time.now,
     #         },
@@ -6829,24 +7108,37 @@ module Aws::Comprehend
     #
     #       {
     #         endpoint_arn: "ComprehendEndpointArn", # required
-    #         desired_inference_units: 1, # required
+    #         desired_model_arn: "ComprehendModelArn",
+    #         desired_inference_units: 1,
+    #         desired_data_access_role_arn: "IamRoleArn",
     #       }
     #
     # @!attribute [rw] endpoint_arn
     #   The Amazon Resource Number (ARN) of the endpoint being updated.
     #   @return [String]
     #
+    # @!attribute [rw] desired_model_arn
+    #   The ARN of the new model to use when updating an existing endpoint.
+    #   @return [String]
+    #
     # @!attribute [rw] desired_inference_units
     #   The desired number of inference units to be used by the model using
     #   this endpoint. Each inference unit represents of a throughput of 100
     #   characters per second.
     #   @return [Integer]
     #
+    # @!attribute [rw] desired_data_access_role_arn
+    #   Data access role ARN to use in case the new model is encrypted with
+    #   a customer CMK.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/UpdateEndpointRequest AWS API Documentation
     #
     class UpdateEndpointRequest < Struct.new(
       :endpoint_arn,
-      :desired_inference_units)
+      :desired_model_arn,
+      :desired_inference_units,
+      :desired_data_access_role_arn)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-comprehend.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-comprehend/customizations'
 # @!group service
 module Aws::Comprehend
 
-  GEM_VERSION = '1.51.0'
+  GEM_VERSION = '1.52.0'
 
 end

metadata

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