aws-sdk-comprehend 1.9.1 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 465cbb3851c64711fdf3d1cfc14b9e31d2b9cc2e
-  data.tar.gz: bd6a0ef366bbfb1bda69928c702ccd893048571d
+  metadata.gz: 1ff698f23e428babdf46677df1ed14091184087b
+  data.tar.gz: be59a27ec5bde173cf8007d908c01fe527ce36f1
 SHA512:
-  metadata.gz: 36f6731210a7c7b963e3d3679bf05cf1947af060326350f84c44ac69b07246a8749a68db9aec93a7f38f0563d23c312598bcab54dc68ce6a3805a56d3568efc6
-  data.tar.gz: 2a34ee9f2896ffe390f2344edd25a366b2310f0ca8b3c9313965128083b8e0967abcfe77802dc52902dd1018e31f95cfef10126a085a4eca0645c66e5575fe1f
+  metadata.gz: 9d6a3c0d8170fc4d06b638b4422459efe54a11dfffa7b3c79b4c16a4d67793504575b2520d10522e864131decd65521eb2bbc163068e7282f730313a358d4f10
+  data.tar.gz: 356a3d50467d1902624216353f8bc1a8eba2c4640479659b525baf9d6142783bdfd8ab8358c9f990e4f361c68cae9e25b7af4bcabd3c79915bac6809fa2792ee

data/lib/aws-sdk-comprehend.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-comprehend/customizations'
 # @service
 module Aws::Comprehend
 
-  GEM_VERSION = '1.9.1'
+  GEM_VERSION = '1.10.0'
 
 end

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

@@ -450,9 +450,9 @@ module Aws::Comprehend
 
     # Creates a new document classifier that you can use to categorize
     # documents. To create a classifier you provide a set of training
-    # documents that are labeled with the categories that you want to use.
-    # After the classifier is trained you can use it to categorize a set of
-    # unlabeled documents into those categories.
+    # documents that labeled with the categories that you want to use. After
+    # the classifier is trained you can use it to categorize a set of
+    # labeled documents into the categories.
     #
     # @option params [required, String] :document_classifier_name
     #   The name of the document classifier.
@@ -473,9 +473,8 @@ module Aws::Comprehend
     #   not need to pass this option.**
     #
     # @option params [required, String] :language_code
-    #   The language of the input documents. You can create a document
-    #   classifier in any of the languages supported by Amazon Comprehend.
-    #   However, all documents must be in the same language.
+    #   The language of the input documents. You can specify English ("en")
+    #   or Spanish ("es"). All documents must be in the same language.
     #
     # @return [Types::CreateDocumentClassifierResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -506,6 +505,79 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Creates an entity recognizer using submitted files. After your
+    # `CreateEntityRecognizer` request is submitted, you can check job
+    # status using the API.
+    #
+    # @option params [required, String] :recognizer_name
+    #   The name given to the newly created recognizer. Recognizer names can
+    #   be a maximum of 256 characters. Alphanumeric characters, hyphens (-)
+    #   and underscores (\_) are allowed. The name must be unique in the
+    #   account/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
+    #   data.
+    #
+    # @option params [required, Types::EntityRecognizerInputDataConfig] :input_data_config
+    #   Specifies the format and location of the input data. The S3 bucket
+    #   containing the input data must be located in the same region as the
+    #   entity recognizer being created.
+    #
+    # @option params [String] :client_request_token
+    #   A unique identifier for the request. If you don't set the client
+    #   request token, Amazon Comprehend generates one.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @option params [required, String] :language_code
+    #   The language of the input documents. All documents must be in the same
+    #   language. Only English ("en") is currently supported.
+    #
+    # @return [Types::CreateEntityRecognizerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateEntityRecognizerResponse#entity_recognizer_arn #entity_recognizer_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_entity_recognizer({
+    #     recognizer_name: "ComprehendArnName", # required
+    #     data_access_role_arn: "IamRoleArn", # required
+    #     input_data_config: { # required
+    #       entity_types: [ # required
+    #         {
+    #           type: "EntityTypeName", # required
+    #         },
+    #       ],
+    #       documents: { # required
+    #         s3_uri: "S3Uri", # required
+    #       },
+    #       annotations: {
+    #         s3_uri: "S3Uri", # required
+    #       },
+    #       entity_list: {
+    #         s3_uri: "S3Uri", # required
+    #       },
+    #     },
+    #     client_request_token: "ClientRequestTokenString",
+    #     language_code: "en", # required, accepts en, es, fr, de, it, pt
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.entity_recognizer_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/CreateEntityRecognizer AWS API Documentation
+    #
+    # @overload create_entity_recognizer(params = {})
+    # @param [Hash] params ({})
+    def create_entity_recognizer(params = {}, options = {})
+      req = build_request(:create_entity_recognizer, params)
+      req.send_request(options)
+    end
+
     # Deletes a previously created document classifier
     #
     # Only those classifiers that are in terminated states (IN\_ERROR,
@@ -538,6 +610,37 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Deletes an entity recognizer.
+    #
+    # Only those recognizers that are in terminated states (IN\_ERROR,
+    # TRAINED) will be deleted. If an active inference job is using the
+    # model, a `ResourceInUseException` will be returned.
+    #
+    # This is an asynchronous action that puts the recognizer into a
+    # DELETING state, and it is then removed by a background job. Once
+    # removed, the recognizer disappears from your account and is no longer
+    # available for use.
+    #
+    # @option params [required, String] :entity_recognizer_arn
+    #   The Amazon Resource Name (ARN) that identifies the entity recognizer.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_entity_recognizer({
+    #     entity_recognizer_arn: "EntityRecognizerArn", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DeleteEntityRecognizer AWS API Documentation
+    #
+    # @overload delete_entity_recognizer(params = {})
+    # @param [Hash] params ({})
+    def delete_entity_recognizer(params = {}, options = {})
+      req = build_request(:delete_entity_recognizer, params)
+      req.send_request(options)
+    end
+
     # Gets the properties associated with a document classification job. Use
     # this operation to get the status of a classification job.
     #
@@ -687,6 +790,7 @@ module Aws::Comprehend
     #   resp.entities_detection_job_properties.message #=> String
     #   resp.entities_detection_job_properties.submit_time #=> Time
     #   resp.entities_detection_job_properties.end_time #=> Time
+    #   resp.entities_detection_job_properties.entity_recognizer_arn #=> String
     #   resp.entities_detection_job_properties.input_data_config.s3_uri #=> String
     #   resp.entities_detection_job_properties.input_data_config.input_format #=> String, one of "ONE_DOC_PER_FILE", "ONE_DOC_PER_LINE"
     #   resp.entities_detection_job_properties.output_data_config.s3_uri #=> String
@@ -702,6 +806,56 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Provides details about an entity recognizer including status, S3
+    # buckets containing training data, recognizer metadata, metrics, and so
+    # on.
+    #
+    # @option params [required, String] :entity_recognizer_arn
+    #   The Amazon Resource Name (ARN) that identifies the entity recognizer.
+    #
+    # @return [Types::DescribeEntityRecognizerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeEntityRecognizerResponse#entity_recognizer_properties #entity_recognizer_properties} => Types::EntityRecognizerProperties
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_entity_recognizer({
+    #     entity_recognizer_arn: "EntityRecognizerArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.entity_recognizer_properties.entity_recognizer_arn #=> String
+    #   resp.entity_recognizer_properties.language_code #=> String, one of "en", "es", "fr", "de", "it", "pt"
+    #   resp.entity_recognizer_properties.status #=> String, one of "SUBMITTED", "TRAINING", "DELETING", "IN_ERROR", "TRAINED"
+    #   resp.entity_recognizer_properties.message #=> String
+    #   resp.entity_recognizer_properties.submit_time #=> Time
+    #   resp.entity_recognizer_properties.end_time #=> Time
+    #   resp.entity_recognizer_properties.training_start_time #=> Time
+    #   resp.entity_recognizer_properties.training_end_time #=> Time
+    #   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.annotations.s3_uri #=> String
+    #   resp.entity_recognizer_properties.input_data_config.entity_list.s3_uri #=> String
+    #   resp.entity_recognizer_properties.recognizer_metadata.number_of_trained_documents #=> Integer
+    #   resp.entity_recognizer_properties.recognizer_metadata.number_of_test_documents #=> Integer
+    #   resp.entity_recognizer_properties.recognizer_metadata.evaluation_metrics.precision #=> Float
+    #   resp.entity_recognizer_properties.recognizer_metadata.evaluation_metrics.recall #=> Float
+    #   resp.entity_recognizer_properties.recognizer_metadata.evaluation_metrics.f1_score #=> Float
+    #   resp.entity_recognizer_properties.recognizer_metadata.entity_types #=> Array
+    #   resp.entity_recognizer_properties.recognizer_metadata.entity_types[0].type #=> String
+    #   resp.entity_recognizer_properties.data_access_role_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DescribeEntityRecognizer AWS API Documentation
+    #
+    # @overload describe_entity_recognizer(params = {})
+    # @param [Hash] params ({})
+    def describe_entity_recognizer(params = {}, options = {})
+      req = build_request(:describe_entity_recognizer, params)
+      req.send_request(options)
+    end
+
     # Gets the properties associated with a key phrases detection job. Use
     # this operation to get the status of a detection job.
     #
@@ -1234,6 +1388,7 @@ module Aws::Comprehend
     #   resp.entities_detection_job_properties_list[0].message #=> String
     #   resp.entities_detection_job_properties_list[0].submit_time #=> Time
     #   resp.entities_detection_job_properties_list[0].end_time #=> Time
+    #   resp.entities_detection_job_properties_list[0].entity_recognizer_arn #=> String
     #   resp.entities_detection_job_properties_list[0].input_data_config.s3_uri #=> String
     #   resp.entities_detection_job_properties_list[0].input_data_config.input_format #=> String, one of "ONE_DOC_PER_FILE", "ONE_DOC_PER_LINE"
     #   resp.entities_detection_job_properties_list[0].output_data_config.s3_uri #=> String
@@ -1250,6 +1405,79 @@ module Aws::Comprehend
       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
+    # submission time. This call returns up to 500 entity recognizers in the
+    # list, with a default number of 100 recognizers in the list.
+    #
+    # The results of this list are not in any particular order. Please get
+    # the list and sort locally if needed.
+    #
+    # @option params [Types::EntityRecognizerFilter] :filter
+    #   Filters the list of entities returned. You can filter on `Status`,
+    #   `SubmitTimeBefore`, or `SubmitTimeAfter`. You can only set one filter
+    #   at a time.
+    #
+    # @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::ListEntityRecognizersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListEntityRecognizersResponse#entity_recognizer_properties_list #entity_recognizer_properties_list} => Array<Types::EntityRecognizerProperties>
+    #   * {Types::ListEntityRecognizersResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_entity_recognizers({
+    #     filter: {
+    #       status: "SUBMITTED", # accepts SUBMITTED, TRAINING, DELETING, IN_ERROR, TRAINED
+    #       submit_time_before: Time.now,
+    #       submit_time_after: Time.now,
+    #     },
+    #     next_token: "String",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.entity_recognizer_properties_list #=> Array
+    #   resp.entity_recognizer_properties_list[0].entity_recognizer_arn #=> String
+    #   resp.entity_recognizer_properties_list[0].language_code #=> String, one of "en", "es", "fr", "de", "it", "pt"
+    #   resp.entity_recognizer_properties_list[0].status #=> String, one of "SUBMITTED", "TRAINING", "DELETING", "IN_ERROR", "TRAINED"
+    #   resp.entity_recognizer_properties_list[0].message #=> String
+    #   resp.entity_recognizer_properties_list[0].submit_time #=> Time
+    #   resp.entity_recognizer_properties_list[0].end_time #=> Time
+    #   resp.entity_recognizer_properties_list[0].training_start_time #=> Time
+    #   resp.entity_recognizer_properties_list[0].training_end_time #=> Time
+    #   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.annotations.s3_uri #=> String
+    #   resp.entity_recognizer_properties_list[0].input_data_config.entity_list.s3_uri #=> String
+    #   resp.entity_recognizer_properties_list[0].recognizer_metadata.number_of_trained_documents #=> Integer
+    #   resp.entity_recognizer_properties_list[0].recognizer_metadata.number_of_test_documents #=> Integer
+    #   resp.entity_recognizer_properties_list[0].recognizer_metadata.evaluation_metrics.precision #=> Float
+    #   resp.entity_recognizer_properties_list[0].recognizer_metadata.evaluation_metrics.recall #=> Float
+    #   resp.entity_recognizer_properties_list[0].recognizer_metadata.evaluation_metrics.f1_score #=> Float
+    #   resp.entity_recognizer_properties_list[0].recognizer_metadata.entity_types #=> Array
+    #   resp.entity_recognizer_properties_list[0].recognizer_metadata.entity_types[0].type #=> String
+    #   resp.entity_recognizer_properties_list[0].data_access_role_arn #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListEntityRecognizers AWS API Documentation
+    #
+    # @overload list_entity_recognizers(params = {})
+    # @param [Hash] params ({})
+    def list_entity_recognizers(params = {}, options = {})
+      req = build_request(:list_entity_recognizers, params)
+      req.send_request(options)
+    end
+
     # Get a list of key phrase detection jobs that you have submitted.
     #
     # @option params [Types::KeyPhrasesDetectionJobFilter] :filter
@@ -1550,6 +1778,11 @@ module Aws::Comprehend
     # Starts an asynchronous entity detection job for a collection of
     # documents. Use the operation to track the status of a job.
     #
+    # This API can be used for either standard entity detection or custom
+    # entity recognition. In order to be used for custom entity recognition,
+    # the optional `EntityRecognizerArn` must be used in order to provide
+    # access to the recognizer being used to detect the custom entity.
+    #
     # @option params [required, Types::InputDataConfig] :input_data_config
     #   Specifies the format and location of the input data for the job.
     #
@@ -1569,6 +1802,11 @@ module Aws::Comprehend
     # @option params [String] :job_name
     #   The identifier of the job.
     #
+    # @option params [String] :entity_recognizer_arn
+    #   The Amazon Resource Name (ARN) that identifies the specific entity
+    #   recognizer to be used by the `StartEntitiesDetectionJob`. This ARN is
+    #   optional and is only used for a custom entity recognition job.
+    #
     # @option params [required, String] :language_code
     #   The language of the input documents. All documents must be in the same
     #   language. You can specify any of the languages supported by Amazon
@@ -1601,6 +1839,7 @@ module Aws::Comprehend
     #     },
     #     data_access_role_arn: "IamRoleArn", # required
     #     job_name: "JobName",
+    #     entity_recognizer_arn: "EntityRecognizerArn",
     #     language_code: "en", # required, accepts en, es, fr, de, it, pt
     #     client_request_token: "ClientRequestTokenString",
     #   })
@@ -2006,7 +2245,7 @@ module Aws::Comprehend
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-comprehend'
-      context[:gem_version] = '1.9.1'
+      context[:gem_version] = '1.10.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -36,8 +36,12 @@ module Aws::Comprehend
     ComprehendArnName = Shapes::StringShape.new(name: 'ComprehendArnName')
     CreateDocumentClassifierRequest = Shapes::StructureShape.new(name: 'CreateDocumentClassifierRequest')
     CreateDocumentClassifierResponse = Shapes::StructureShape.new(name: 'CreateDocumentClassifierResponse')
+    CreateEntityRecognizerRequest = Shapes::StructureShape.new(name: 'CreateEntityRecognizerRequest')
+    CreateEntityRecognizerResponse = Shapes::StructureShape.new(name: 'CreateEntityRecognizerResponse')
     DeleteDocumentClassifierRequest = Shapes::StructureShape.new(name: 'DeleteDocumentClassifierRequest')
     DeleteDocumentClassifierResponse = Shapes::StructureShape.new(name: 'DeleteDocumentClassifierResponse')
+    DeleteEntityRecognizerRequest = Shapes::StructureShape.new(name: 'DeleteEntityRecognizerRequest')
+    DeleteEntityRecognizerResponse = Shapes::StructureShape.new(name: 'DeleteEntityRecognizerResponse')
     DescribeDocumentClassificationJobRequest = Shapes::StructureShape.new(name: 'DescribeDocumentClassificationJobRequest')
     DescribeDocumentClassificationJobResponse = Shapes::StructureShape.new(name: 'DescribeDocumentClassificationJobResponse')
     DescribeDocumentClassifierRequest = Shapes::StructureShape.new(name: 'DescribeDocumentClassifierRequest')
@@ -46,6 +50,8 @@ module Aws::Comprehend
     DescribeDominantLanguageDetectionJobResponse = Shapes::StructureShape.new(name: 'DescribeDominantLanguageDetectionJobResponse')
     DescribeEntitiesDetectionJobRequest = Shapes::StructureShape.new(name: 'DescribeEntitiesDetectionJobRequest')
     DescribeEntitiesDetectionJobResponse = Shapes::StructureShape.new(name: 'DescribeEntitiesDetectionJobResponse')
+    DescribeEntityRecognizerRequest = Shapes::StructureShape.new(name: 'DescribeEntityRecognizerRequest')
+    DescribeEntityRecognizerResponse = Shapes::StructureShape.new(name: 'DescribeEntityRecognizerResponse')
     DescribeKeyPhrasesDetectionJobRequest = Shapes::StructureShape.new(name: 'DescribeKeyPhrasesDetectionJobRequest')
     DescribeKeyPhrasesDetectionJobResponse = Shapes::StructureShape.new(name: 'DescribeKeyPhrasesDetectionJobResponse')
     DescribeSentimentDetectionJobRequest = Shapes::StructureShape.new(name: 'DescribeSentimentDetectionJobRequest')
@@ -79,7 +85,22 @@ module Aws::Comprehend
     EntitiesDetectionJobProperties = Shapes::StructureShape.new(name: 'EntitiesDetectionJobProperties')
     EntitiesDetectionJobPropertiesList = Shapes::ListShape.new(name: 'EntitiesDetectionJobPropertiesList')
     Entity = Shapes::StructureShape.new(name: 'Entity')
+    EntityRecognizerAnnotations = Shapes::StructureShape.new(name: 'EntityRecognizerAnnotations')
+    EntityRecognizerArn = Shapes::StringShape.new(name: 'EntityRecognizerArn')
+    EntityRecognizerDocuments = Shapes::StructureShape.new(name: 'EntityRecognizerDocuments')
+    EntityRecognizerEntityList = Shapes::StructureShape.new(name: 'EntityRecognizerEntityList')
+    EntityRecognizerEvaluationMetrics = Shapes::StructureShape.new(name: 'EntityRecognizerEvaluationMetrics')
+    EntityRecognizerFilter = Shapes::StructureShape.new(name: 'EntityRecognizerFilter')
+    EntityRecognizerInputDataConfig = Shapes::StructureShape.new(name: 'EntityRecognizerInputDataConfig')
+    EntityRecognizerMetadata = Shapes::StructureShape.new(name: 'EntityRecognizerMetadata')
+    EntityRecognizerMetadataEntityTypesList = Shapes::ListShape.new(name: 'EntityRecognizerMetadataEntityTypesList')
+    EntityRecognizerMetadataEntityTypesListItem = Shapes::StructureShape.new(name: 'EntityRecognizerMetadataEntityTypesListItem')
+    EntityRecognizerProperties = Shapes::StructureShape.new(name: 'EntityRecognizerProperties')
+    EntityRecognizerPropertiesList = Shapes::ListShape.new(name: 'EntityRecognizerPropertiesList')
     EntityType = Shapes::StringShape.new(name: 'EntityType')
+    EntityTypeName = Shapes::StringShape.new(name: 'EntityTypeName')
+    EntityTypesList = Shapes::ListShape.new(name: 'EntityTypesList')
+    EntityTypesListItem = Shapes::StructureShape.new(name: 'EntityTypesListItem')
     Float = Shapes::FloatShape.new(name: 'Float')
     IamRoleArn = Shapes::StringShape.new(name: 'IamRoleArn')
     InputDataConfig = Shapes::StructureShape.new(name: 'InputDataConfig')
@@ -105,6 +126,8 @@ module Aws::Comprehend
     ListDominantLanguageDetectionJobsResponse = Shapes::StructureShape.new(name: 'ListDominantLanguageDetectionJobsResponse')
     ListEntitiesDetectionJobsRequest = Shapes::StructureShape.new(name: 'ListEntitiesDetectionJobsRequest')
     ListEntitiesDetectionJobsResponse = Shapes::StructureShape.new(name: 'ListEntitiesDetectionJobsResponse')
+    ListEntityRecognizersRequest = Shapes::StructureShape.new(name: 'ListEntityRecognizersRequest')
+    ListEntityRecognizersResponse = Shapes::StructureShape.new(name: 'ListEntityRecognizersResponse')
     ListKeyPhrasesDetectionJobsRequest = Shapes::StructureShape.new(name: 'ListKeyPhrasesDetectionJobsRequest')
     ListKeyPhrasesDetectionJobsResponse = Shapes::StructureShape.new(name: 'ListKeyPhrasesDetectionJobsResponse')
     ListOfDetectDominantLanguageResult = Shapes::ListShape.new(name: 'ListOfDetectDominantLanguageResult')
@@ -257,11 +280,26 @@ module Aws::Comprehend
     CreateDocumentClassifierResponse.add_member(:document_classifier_arn, Shapes::ShapeRef.new(shape: DocumentClassifierArn, location_name: "DocumentClassifierArn"))
     CreateDocumentClassifierResponse.struct_class = Types::CreateDocumentClassifierResponse
 
+    CreateEntityRecognizerRequest.add_member(:recognizer_name, Shapes::ShapeRef.new(shape: ComprehendArnName, required: true, location_name: "RecognizerName"))
+    CreateEntityRecognizerRequest.add_member(:data_access_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, required: true, location_name: "DataAccessRoleArn"))
+    CreateEntityRecognizerRequest.add_member(:input_data_config, Shapes::ShapeRef.new(shape: EntityRecognizerInputDataConfig, required: true, location_name: "InputDataConfig"))
+    CreateEntityRecognizerRequest.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestTokenString, location_name: "ClientRequestToken", metadata: {"idempotencyToken"=>true}))
+    CreateEntityRecognizerRequest.add_member(:language_code, Shapes::ShapeRef.new(shape: LanguageCode, required: true, location_name: "LanguageCode"))
+    CreateEntityRecognizerRequest.struct_class = Types::CreateEntityRecognizerRequest
+
+    CreateEntityRecognizerResponse.add_member(:entity_recognizer_arn, Shapes::ShapeRef.new(shape: EntityRecognizerArn, location_name: "EntityRecognizerArn"))
+    CreateEntityRecognizerResponse.struct_class = Types::CreateEntityRecognizerResponse
+
     DeleteDocumentClassifierRequest.add_member(:document_classifier_arn, Shapes::ShapeRef.new(shape: DocumentClassifierArn, required: true, location_name: "DocumentClassifierArn"))
     DeleteDocumentClassifierRequest.struct_class = Types::DeleteDocumentClassifierRequest
 
     DeleteDocumentClassifierResponse.struct_class = Types::DeleteDocumentClassifierResponse
 
+    DeleteEntityRecognizerRequest.add_member(:entity_recognizer_arn, Shapes::ShapeRef.new(shape: EntityRecognizerArn, required: true, location_name: "EntityRecognizerArn"))
+    DeleteEntityRecognizerRequest.struct_class = Types::DeleteEntityRecognizerRequest
+
+    DeleteEntityRecognizerResponse.struct_class = Types::DeleteEntityRecognizerResponse
+
     DescribeDocumentClassificationJobRequest.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, required: true, location_name: "JobId"))
     DescribeDocumentClassificationJobRequest.struct_class = Types::DescribeDocumentClassificationJobRequest
 
@@ -286,6 +324,12 @@ module Aws::Comprehend
     DescribeEntitiesDetectionJobResponse.add_member(:entities_detection_job_properties, Shapes::ShapeRef.new(shape: EntitiesDetectionJobProperties, location_name: "EntitiesDetectionJobProperties"))
     DescribeEntitiesDetectionJobResponse.struct_class = Types::DescribeEntitiesDetectionJobResponse
 
+    DescribeEntityRecognizerRequest.add_member(:entity_recognizer_arn, Shapes::ShapeRef.new(shape: EntityRecognizerArn, required: true, location_name: "EntityRecognizerArn"))
+    DescribeEntityRecognizerRequest.struct_class = Types::DescribeEntityRecognizerRequest
+
+    DescribeEntityRecognizerResponse.add_member(:entity_recognizer_properties, Shapes::ShapeRef.new(shape: EntityRecognizerProperties, location_name: "EntityRecognizerProperties"))
+    DescribeEntityRecognizerResponse.struct_class = Types::DescribeEntityRecognizerResponse
+
     DescribeKeyPhrasesDetectionJobRequest.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, required: true, location_name: "JobId"))
     DescribeKeyPhrasesDetectionJobRequest.struct_class = Types::DescribeKeyPhrasesDetectionJobRequest
 
@@ -417,6 +461,7 @@ module Aws::Comprehend
     EntitiesDetectionJobProperties.add_member(:message, Shapes::ShapeRef.new(shape: AnyLengthString, location_name: "Message"))
     EntitiesDetectionJobProperties.add_member(:submit_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "SubmitTime"))
     EntitiesDetectionJobProperties.add_member(:end_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "EndTime"))
+    EntitiesDetectionJobProperties.add_member(:entity_recognizer_arn, Shapes::ShapeRef.new(shape: EntityRecognizerArn, location_name: "EntityRecognizerArn"))
     EntitiesDetectionJobProperties.add_member(:input_data_config, Shapes::ShapeRef.new(shape: InputDataConfig, location_name: "InputDataConfig"))
     EntitiesDetectionJobProperties.add_member(:output_data_config, Shapes::ShapeRef.new(shape: OutputDataConfig, location_name: "OutputDataConfig"))
     EntitiesDetectionJobProperties.add_member(:language_code, Shapes::ShapeRef.new(shape: LanguageCode, location_name: "LanguageCode"))
@@ -432,6 +477,62 @@ module Aws::Comprehend
     Entity.add_member(:end_offset, Shapes::ShapeRef.new(shape: Integer, location_name: "EndOffset"))
     Entity.struct_class = Types::Entity
 
+    EntityRecognizerAnnotations.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
+    EntityRecognizerAnnotations.struct_class = Types::EntityRecognizerAnnotations
+
+    EntityRecognizerDocuments.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
+    EntityRecognizerDocuments.struct_class = Types::EntityRecognizerDocuments
+
+    EntityRecognizerEntityList.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
+    EntityRecognizerEntityList.struct_class = Types::EntityRecognizerEntityList
+
+    EntityRecognizerEvaluationMetrics.add_member(:precision, Shapes::ShapeRef.new(shape: Double, location_name: "Precision"))
+    EntityRecognizerEvaluationMetrics.add_member(:recall, Shapes::ShapeRef.new(shape: Double, location_name: "Recall"))
+    EntityRecognizerEvaluationMetrics.add_member(:f1_score, Shapes::ShapeRef.new(shape: Double, location_name: "F1Score"))
+    EntityRecognizerEvaluationMetrics.struct_class = Types::EntityRecognizerEvaluationMetrics
+
+    EntityRecognizerFilter.add_member(:status, Shapes::ShapeRef.new(shape: ModelStatus, location_name: "Status"))
+    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
+
+    EntityRecognizerInputDataConfig.add_member(:entity_types, Shapes::ShapeRef.new(shape: EntityTypesList, required: true, location_name: "EntityTypes"))
+    EntityRecognizerInputDataConfig.add_member(:documents, Shapes::ShapeRef.new(shape: EntityRecognizerDocuments, required: true, location_name: "Documents"))
+    EntityRecognizerInputDataConfig.add_member(:annotations, Shapes::ShapeRef.new(shape: EntityRecognizerAnnotations, location_name: "Annotations"))
+    EntityRecognizerInputDataConfig.add_member(:entity_list, Shapes::ShapeRef.new(shape: EntityRecognizerEntityList, location_name: "EntityList"))
+    EntityRecognizerInputDataConfig.struct_class = Types::EntityRecognizerInputDataConfig
+
+    EntityRecognizerMetadata.add_member(:number_of_trained_documents, Shapes::ShapeRef.new(shape: Integer, location_name: "NumberOfTrainedDocuments"))
+    EntityRecognizerMetadata.add_member(:number_of_test_documents, Shapes::ShapeRef.new(shape: Integer, location_name: "NumberOfTestDocuments"))
+    EntityRecognizerMetadata.add_member(:evaluation_metrics, Shapes::ShapeRef.new(shape: EntityRecognizerEvaluationMetrics, location_name: "EvaluationMetrics"))
+    EntityRecognizerMetadata.add_member(:entity_types, Shapes::ShapeRef.new(shape: EntityRecognizerMetadataEntityTypesList, location_name: "EntityTypes"))
+    EntityRecognizerMetadata.struct_class = Types::EntityRecognizerMetadata
+
+    EntityRecognizerMetadataEntityTypesList.member = Shapes::ShapeRef.new(shape: EntityRecognizerMetadataEntityTypesListItem)
+
+    EntityRecognizerMetadataEntityTypesListItem.add_member(:type, Shapes::ShapeRef.new(shape: AnyLengthString, location_name: "Type"))
+    EntityRecognizerMetadataEntityTypesListItem.struct_class = Types::EntityRecognizerMetadataEntityTypesListItem
+
+    EntityRecognizerProperties.add_member(:entity_recognizer_arn, Shapes::ShapeRef.new(shape: EntityRecognizerArn, location_name: "EntityRecognizerArn"))
+    EntityRecognizerProperties.add_member(:language_code, Shapes::ShapeRef.new(shape: LanguageCode, location_name: "LanguageCode"))
+    EntityRecognizerProperties.add_member(:status, Shapes::ShapeRef.new(shape: ModelStatus, location_name: "Status"))
+    EntityRecognizerProperties.add_member(:message, Shapes::ShapeRef.new(shape: AnyLengthString, location_name: "Message"))
+    EntityRecognizerProperties.add_member(:submit_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "SubmitTime"))
+    EntityRecognizerProperties.add_member(:end_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "EndTime"))
+    EntityRecognizerProperties.add_member(:training_start_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "TrainingStartTime"))
+    EntityRecognizerProperties.add_member(:training_end_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "TrainingEndTime"))
+    EntityRecognizerProperties.add_member(:input_data_config, Shapes::ShapeRef.new(shape: EntityRecognizerInputDataConfig, location_name: "InputDataConfig"))
+    EntityRecognizerProperties.add_member(:recognizer_metadata, Shapes::ShapeRef.new(shape: EntityRecognizerMetadata, location_name: "RecognizerMetadata"))
+    EntityRecognizerProperties.add_member(:data_access_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, location_name: "DataAccessRoleArn"))
+    EntityRecognizerProperties.struct_class = Types::EntityRecognizerProperties
+
+    EntityRecognizerPropertiesList.member = Shapes::ShapeRef.new(shape: EntityRecognizerProperties)
+
+    EntityTypesList.member = Shapes::ShapeRef.new(shape: EntityTypesListItem)
+
+    EntityTypesListItem.add_member(:type, Shapes::ShapeRef.new(shape: EntityTypeName, required: true, location_name: "Type"))
+    EntityTypesListItem.struct_class = Types::EntityTypesListItem
+
     InputDataConfig.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
     InputDataConfig.add_member(:input_format, Shapes::ShapeRef.new(shape: InputFormat, location_name: "InputFormat"))
     InputDataConfig.struct_class = Types::InputDataConfig
@@ -498,6 +599,15 @@ module Aws::Comprehend
     ListEntitiesDetectionJobsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
     ListEntitiesDetectionJobsResponse.struct_class = Types::ListEntitiesDetectionJobsResponse
 
+    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"))
+    ListEntityRecognizersRequest.struct_class = Types::ListEntityRecognizersRequest
+
+    ListEntityRecognizersResponse.add_member(:entity_recognizer_properties_list, Shapes::ShapeRef.new(shape: EntityRecognizerPropertiesList, location_name: "EntityRecognizerPropertiesList"))
+    ListEntityRecognizersResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
+    ListEntityRecognizersResponse.struct_class = Types::ListEntityRecognizersResponse
+
     ListKeyPhrasesDetectionJobsRequest.add_member(:filter, Shapes::ShapeRef.new(shape: KeyPhrasesDetectionJobFilter, location_name: "Filter"))
     ListKeyPhrasesDetectionJobsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
     ListKeyPhrasesDetectionJobsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResultsInteger, location_name: "MaxResults"))
@@ -603,6 +713,7 @@ module Aws::Comprehend
     StartEntitiesDetectionJobRequest.add_member(:output_data_config, Shapes::ShapeRef.new(shape: OutputDataConfig, required: true, location_name: "OutputDataConfig"))
     StartEntitiesDetectionJobRequest.add_member(:data_access_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, required: true, location_name: "DataAccessRoleArn"))
     StartEntitiesDetectionJobRequest.add_member(:job_name, Shapes::ShapeRef.new(shape: JobName, location_name: "JobName"))
+    StartEntitiesDetectionJobRequest.add_member(:entity_recognizer_arn, Shapes::ShapeRef.new(shape: EntityRecognizerArn, location_name: "EntityRecognizerArn"))
     StartEntitiesDetectionJobRequest.add_member(:language_code, Shapes::ShapeRef.new(shape: LanguageCode, required: true, location_name: "LanguageCode"))
     StartEntitiesDetectionJobRequest.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestTokenString, location_name: "ClientRequestToken", metadata: {"idempotencyToken"=>true}))
     StartEntitiesDetectionJobRequest.struct_class = Types::StartEntitiesDetectionJobRequest
@@ -800,6 +911,20 @@ module Aws::Comprehend
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:create_entity_recognizer, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "CreateEntityRecognizer"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: CreateEntityRecognizerRequest)
+        o.output = Shapes::ShapeRef.new(shape: CreateEntityRecognizerResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceLimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedLanguageException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+      end)
+
       api.add_operation(:delete_document_classifier, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DeleteDocumentClassifier"
         o.http_method = "POST"
@@ -814,6 +939,20 @@ module Aws::Comprehend
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:delete_entity_recognizer, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DeleteEntityRecognizer"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DeleteEntityRecognizerRequest)
+        o.output = Shapes::ShapeRef.new(shape: DeleteEntityRecognizerResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceUnavailableException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+      end)
+
       api.add_operation(:describe_document_classification_job, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeDocumentClassificationJob"
         o.http_method = "POST"
@@ -862,6 +1001,18 @@ module Aws::Comprehend
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:describe_entity_recognizer, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeEntityRecognizer"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeEntityRecognizerRequest)
+        o.output = Shapes::ShapeRef.new(shape: DescribeEntityRecognizerResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+      end)
+
       api.add_operation(:describe_key_phrases_detection_job, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeKeyPhrasesDetectionJob"
         o.http_method = "POST"
@@ -1017,6 +1168,18 @@ module Aws::Comprehend
         )
       end)
 
+      api.add_operation(:list_entity_recognizers, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListEntityRecognizers"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListEntityRecognizersRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListEntityRecognizersResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidFilterException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+      end)
+
       api.add_operation(:list_key_phrases_detection_jobs, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListKeyPhrasesDetectionJobs"
         o.http_method = "POST"
@@ -1103,6 +1266,8 @@ module Aws::Comprehend
         o.output = Shapes::ShapeRef.new(shape: StartEntitiesDetectionJobResponse)
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
         o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceUnavailableException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 

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

@@ -489,9 +489,9 @@ module Aws::Comprehend
     #   @return [String]
     #
     # @!attribute [rw] language_code
-    #   The language of the input documents. You can create a document
-    #   classifier in any of the languages supported by Amazon Comprehend.
-    #   However, all documents must be in the same language.
+    #   The language of the input documents. You can specify English
+    #   ("en") or Spanish ("es"). All documents must be in the same
+    #   language.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/CreateDocumentClassifierRequest AWS API Documentation
@@ -517,6 +517,87 @@ module Aws::Comprehend
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass CreateEntityRecognizerRequest
+    #   data as a hash:
+    #
+    #       {
+    #         recognizer_name: "ComprehendArnName", # required
+    #         data_access_role_arn: "IamRoleArn", # required
+    #         input_data_config: { # required
+    #           entity_types: [ # required
+    #             {
+    #               type: "EntityTypeName", # required
+    #             },
+    #           ],
+    #           documents: { # required
+    #             s3_uri: "S3Uri", # required
+    #           },
+    #           annotations: {
+    #             s3_uri: "S3Uri", # required
+    #           },
+    #           entity_list: {
+    #             s3_uri: "S3Uri", # required
+    #           },
+    #         },
+    #         client_request_token: "ClientRequestTokenString",
+    #         language_code: "en", # required, accepts en, es, fr, de, it, pt
+    #       }
+    #
+    # @!attribute [rw] recognizer_name
+    #   The name given to the newly created recognizer. Recognizer names can
+    #   be a maximum of 256 characters. Alphanumeric characters, hyphens (-)
+    #   and underscores (\_) are allowed. The name must be unique in the
+    #   account/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
+    #   data.
+    #   @return [String]
+    #
+    # @!attribute [rw] input_data_config
+    #   Specifies the format and location of the input data. The S3 bucket
+    #   containing the input data must be located in the same region as the
+    #   entity recognizer being created.
+    #   @return [Types::EntityRecognizerInputDataConfig]
+    #
+    # @!attribute [rw] client_request_token
+    #   A unique identifier for the request. If you don't set the client
+    #   request token, Amazon Comprehend generates one.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    # @!attribute [rw] language_code
+    #   The language of the input documents. All documents must be in the
+    #   same language. Only English ("en") is currently supported.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/CreateEntityRecognizerRequest AWS API Documentation
+    #
+    class CreateEntityRecognizerRequest < Struct.new(
+      :recognizer_name,
+      :data_access_role_arn,
+      :input_data_config,
+      :client_request_token,
+      :language_code)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] entity_recognizer_arn
+    #   The Amazon Resource Name (ARN) that identifies the entity
+    #   recognizer.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/CreateEntityRecognizerResponse AWS API Documentation
+    #
+    class CreateEntityRecognizerResponse < Struct.new(
+      :entity_recognizer_arn)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DeleteDocumentClassifierRequest
     #   data as a hash:
     #
@@ -540,6 +621,29 @@ module Aws::Comprehend
     #
     class DeleteDocumentClassifierResponse < Aws::EmptyStructure; end
 
+    # @note When making an API call, you may pass DeleteEntityRecognizerRequest
+    #   data as a hash:
+    #
+    #       {
+    #         entity_recognizer_arn: "EntityRecognizerArn", # required
+    #       }
+    #
+    # @!attribute [rw] entity_recognizer_arn
+    #   The Amazon Resource Name (ARN) that identifies the entity
+    #   recognizer.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DeleteEntityRecognizerRequest AWS API Documentation
+    #
+    class DeleteEntityRecognizerRequest < Struct.new(
+      :entity_recognizer_arn)
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DeleteEntityRecognizerResponse AWS API Documentation
+    #
+    class DeleteEntityRecognizerResponse < Aws::EmptyStructure; end
+
     # @note When making an API call, you may pass DescribeDocumentClassificationJobRequest
     #   data as a hash:
     #
@@ -664,6 +768,36 @@ module Aws::Comprehend
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DescribeEntityRecognizerRequest
+    #   data as a hash:
+    #
+    #       {
+    #         entity_recognizer_arn: "EntityRecognizerArn", # required
+    #       }
+    #
+    # @!attribute [rw] entity_recognizer_arn
+    #   The Amazon Resource Name (ARN) that identifies the entity
+    #   recognizer.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DescribeEntityRecognizerRequest AWS API Documentation
+    #
+    class DescribeEntityRecognizerRequest < Struct.new(
+      :entity_recognizer_arn)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] entity_recognizer_properties
+    #   Describes information associated with an entity recognizer.
+    #   @return [Types::EntityRecognizerProperties]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DescribeEntityRecognizerResponse AWS API Documentation
+    #
+    class DescribeEntityRecognizerResponse < Struct.new(
+      :entity_recognizer_properties)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DescribeKeyPhrasesDetectionJobRequest
     #   data as a hash:
     #
@@ -1431,6 +1565,11 @@ module Aws::Comprehend
     #   The time that the entities detection job completed
     #   @return [Time]
     #
+    # @!attribute [rw] entity_recognizer_arn
+    #   The Amazon Resource Name (ARN) that identifies the entity
+    #   recognizer.
+    #   @return [String]
+    #
     # @!attribute [rw] input_data_config
     #   The input data configuration that you supplied when you created the
     #   entities detection job.
@@ -1459,6 +1598,7 @@ module Aws::Comprehend
       :message,
       :submit_time,
       :end_time,
+      :entity_recognizer_arn,
       :input_data_config,
       :output_data_config,
       :language_code,
@@ -1509,6 +1649,324 @@ module Aws::Comprehend
       include Aws::Structure
     end
 
+    # Describes the annotations associated with a entity recognizer.
+    #
+    # @note When making an API call, you may pass EntityRecognizerAnnotations
+    #   data as a hash:
+    #
+    #       {
+    #         s3_uri: "S3Uri", # required
+    #       }
+    #
+    # @!attribute [rw] s3_uri
+    #   Specifies the Amazon S3 location where the annotations for an entity
+    #   recognizer are located. The URI must be in the same 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)
+      include Aws::Structure
+    end
+
+    # Describes the training documents submitted with an entity recognizer.
+    #
+    # @note When making an API call, you may pass EntityRecognizerDocuments
+    #   data as a hash:
+    #
+    #       {
+    #         s3_uri: "S3Uri", # required
+    #       }
+    #
+    # @!attribute [rw] s3_uri
+    #   Specifies the Amazon S3 location where the training documents for an
+    #   entity recognizer are located. The URI must be in the same region as
+    #   the API endpoint that you are calling.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerDocuments AWS API Documentation
+    #
+    class EntityRecognizerDocuments < Struct.new(
+      :s3_uri)
+      include Aws::Structure
+    end
+
+    # Describes the entity recognizer submitted with an entity recognizer.
+    #
+    # @note When making an API call, you may pass EntityRecognizerEntityList
+    #   data as a hash:
+    #
+    #       {
+    #         s3_uri: "S3Uri", # required
+    #       }
+    #
+    # @!attribute [rw] s3_uri
+    #   Specifies the Amazon S3 location where the entity list is located.
+    #   The URI must be in the same region as the API endpoint that you are
+    #   calling.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerEntityList AWS API Documentation
+    #
+    class EntityRecognizerEntityList < Struct.new(
+      :s3_uri)
+      include Aws::Structure
+    end
+
+    # Detailed information about the accuracy of an entity recognizer.
+    #
+    # @!attribute [rw] precision
+    #   A measure of the usefulness of the recognizer results in the test
+    #   data. High precision means that the recognizer returned
+    #   substantially more relevant results than irrelevant ones.
+    #   @return [Float]
+    #
+    # @!attribute [rw] recall
+    #   A measure of how complete the recognizer results are for the test
+    #   data. High recall means that the recognizer returned most of the
+    #   relevant results.
+    #   @return [Float]
+    #
+    # @!attribute [rw] f1_score
+    #   A measure of how accurate the recognizer results are for the test
+    #   data. It is derived from the `Precision` and `Recall` values. The
+    #   `F1Score` is the harmonic average of the two scores. The highest
+    #   score is 1, and the worst score is 0.
+    #   @return [Float]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerEvaluationMetrics AWS API Documentation
+    #
+    class EntityRecognizerEvaluationMetrics < Struct.new(
+      :precision,
+      :recall,
+      :f1_score)
+      include Aws::Structure
+    end
+
+    # Provides information for filtering a list of entity recognizers. You
+    # can only specify one filtering parameter in a request. For more
+    # information, see the operation./&gt;
+    #
+    # @note When making an API call, you may pass EntityRecognizerFilter
+    #   data as a hash:
+    #
+    #       {
+    #         status: "SUBMITTED", # accepts SUBMITTED, TRAINING, DELETING, IN_ERROR, TRAINED
+    #         submit_time_before: Time.now,
+    #         submit_time_after: Time.now,
+    #       }
+    #
+    # @!attribute [rw] status
+    #   The status of an 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
+    #   specified time. Jobs are returned in descending order, newest to
+    #   oldest.
+    #   @return [Time]
+    #
+    # @!attribute [rw] submit_time_after
+    #   Filters the list of entities based on the time that the list was
+    #   submitted for processing. Returns only jobs submitted after the
+    #   specified time. Jobs are returned in ascending order, oldest to
+    #   newest.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerFilter AWS API Documentation
+    #
+    class EntityRecognizerFilter < Struct.new(
+      :status,
+      :submit_time_before,
+      :submit_time_after)
+      include Aws::Structure
+    end
+
+    # Specifies the format and location of the input data.
+    #
+    # @note When making an API call, you may pass EntityRecognizerInputDataConfig
+    #   data as a hash:
+    #
+    #       {
+    #         entity_types: [ # required
+    #           {
+    #             type: "EntityTypeName", # required
+    #           },
+    #         ],
+    #         documents: { # required
+    #           s3_uri: "S3Uri", # required
+    #         },
+    #         annotations: {
+    #           s3_uri: "S3Uri", # required
+    #         },
+    #         entity_list: {
+    #           s3_uri: "S3Uri", # required
+    #         },
+    #       }
+    #
+    # @!attribute [rw] entity_types
+    #   The entity types in the input data for an entity recognizer.
+    #   @return [Array<Types::EntityTypesListItem>]
+    #
+    # @!attribute [rw] documents
+    #   S3 location of the documents folder for an entity recognizer
+    #   @return [Types::EntityRecognizerDocuments]
+    #
+    # @!attribute [rw] annotations
+    #   S3 location of the annotations file for an entity recognizer.
+    #   @return [Types::EntityRecognizerAnnotations]
+    #
+    # @!attribute [rw] entity_list
+    #   S3 location of the entity list for an entity recognizer.
+    #   @return [Types::EntityRecognizerEntityList]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerInputDataConfig AWS API Documentation
+    #
+    class EntityRecognizerInputDataConfig < Struct.new(
+      :entity_types,
+      :documents,
+      :annotations,
+      :entity_list)
+      include Aws::Structure
+    end
+
+    # Detailed information about an entity recognizer.
+    #
+    # @!attribute [rw] number_of_trained_documents
+    #   The number of documents in the input data that were used to train
+    #   the entity recognizer. Typically this is 80 to 90 percent of the
+    #   input documents.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] number_of_test_documents
+    #   The number of documents in the input data that were used to test the
+    #   entity recognizer. Typically this is 10 to 20 percent of the input
+    #   documents.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] evaluation_metrics
+    #   Detailed information about the accuracy of an entity recognizer.
+    #   @return [Types::EntityRecognizerEvaluationMetrics]
+    #
+    # @!attribute [rw] entity_types
+    #   Entity types from the metadata of an entity recognizer.
+    #   @return [Array<Types::EntityRecognizerMetadataEntityTypesListItem>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerMetadata AWS API Documentation
+    #
+    class EntityRecognizerMetadata < Struct.new(
+      :number_of_trained_documents,
+      :number_of_test_documents,
+      :evaluation_metrics,
+      :entity_types)
+      include Aws::Structure
+    end
+
+    # Individual item from the list of entity types in the metadata of an
+    # entity recognizer.
+    #
+    # @!attribute [rw] type
+    #   Type of entity from the list of entity types in the metadata of an
+    #   entity recognizer.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerMetadataEntityTypesListItem AWS API Documentation
+    #
+    class EntityRecognizerMetadataEntityTypesListItem < Struct.new(
+      :type)
+      include Aws::Structure
+    end
+
+    # Describes information about an entity recognizer.
+    #
+    # @!attribute [rw] entity_recognizer_arn
+    #   The Amazon Resource Name (ARN) that identifies the entity
+    #   recognizer.
+    #   @return [String]
+    #
+    # @!attribute [rw] language_code
+    #   The language of the input documents. All documents must be in the
+    #   same language. Only English ("en") is currently supported.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   Provides the status of the entity recognizer.
+    #   @return [String]
+    #
+    # @!attribute [rw] message
+    #   A description of the status of the recognizer.
+    #   @return [String]
+    #
+    # @!attribute [rw] submit_time
+    #   The time that the recognizer was submitted for processing.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_time
+    #   The time that the recognizer creation completed.
+    #   @return [Time]
+    #
+    # @!attribute [rw] training_start_time
+    #   The time that training of the entity recognizer started.
+    #   @return [Time]
+    #
+    # @!attribute [rw] training_end_time
+    #   The time that training of the entity recognizer was completed.
+    #   @return [Time]
+    #
+    # @!attribute [rw] input_data_config
+    #   The input data properties of an entity recognizer.
+    #   @return [Types::EntityRecognizerInputDataConfig]
+    #
+    # @!attribute [rw] recognizer_metadata
+    #   Provides information about an entity recognizer.
+    #   @return [Types::EntityRecognizerMetadata]
+    #
+    # @!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
+    #   data.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityRecognizerProperties AWS API Documentation
+    #
+    class EntityRecognizerProperties < Struct.new(
+      :entity_recognizer_arn,
+      :language_code,
+      :status,
+      :message,
+      :submit_time,
+      :end_time,
+      :training_start_time,
+      :training_end_time,
+      :input_data_config,
+      :recognizer_metadata,
+      :data_access_role_arn)
+      include Aws::Structure
+    end
+
+    # Information about an individual item on a list of entity types.
+    #
+    # @note When making an API call, you may pass EntityTypesListItem
+    #   data as a hash:
+    #
+    #       {
+    #         type: "EntityTypeName", # required
+    #       }
+    #
+    # @!attribute [rw] type
+    #   Entity type of an item on an entity type list.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/EntityTypesListItem AWS API Documentation
+    #
+    class EntityTypesListItem < Struct.new(
+      :type)
+      include Aws::Structure
+    end
+
     # The input properties for a topic detection job.
     #
     # @note When making an API call, you may pass InputDataConfig
@@ -1913,6 +2371,59 @@ module Aws::Comprehend
       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, IN_ERROR, TRAINED
+    #           submit_time_before: Time.now,
+    #           submit_time_after: Time.now,
+    #         },
+    #         next_token: "String",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] filter
+    #   Filters the list of entities returned. You can filter on `Status`,
+    #   `SubmitTimeBefore`, or `SubmitTimeAfter`. You can only set one
+    #   filter at a time.
+    #   @return [Types::EntityRecognizerFilter]
+    #
+    # @!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/ListEntityRecognizersRequest AWS API Documentation
+    #
+    class ListEntityRecognizersRequest < Struct.new(
+      :filter,
+      :next_token,
+      :max_results)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] entity_recognizer_properties_list
+    #   The list of properties of an entity recognizer.
+    #   @return [Array<Types::EntityRecognizerProperties>]
+    #
+    # @!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/ListEntityRecognizersResponse AWS API Documentation
+    #
+    class ListEntityRecognizersResponse < Struct.new(
+      :entity_recognizer_properties_list,
+      :next_token)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListKeyPhrasesDetectionJobsRequest
     #   data as a hash:
     #
@@ -2459,6 +2970,7 @@ module Aws::Comprehend
     #         },
     #         data_access_role_arn: "IamRoleArn", # required
     #         job_name: "JobName",
+    #         entity_recognizer_arn: "EntityRecognizerArn",
     #         language_code: "en", # required, accepts en, es, fr, de, it, pt
     #         client_request_token: "ClientRequestTokenString",
     #       }
@@ -2486,6 +2998,12 @@ module Aws::Comprehend
     #   The identifier of the job.
     #   @return [String]
     #
+    # @!attribute [rw] entity_recognizer_arn
+    #   The Amazon Resource Name (ARN) that identifies the specific entity
+    #   recognizer to be used by the `StartEntitiesDetectionJob`. This ARN
+    #   is optional and is only used for a custom entity recognition job.
+    #   @return [String]
+    #
     # @!attribute [rw] language_code
     #   The language of the input documents. All documents must be in the
     #   same language. You can specify any of the languages supported by
@@ -2510,6 +3028,7 @@ module Aws::Comprehend
       :output_data_config,
       :data_access_role_arn,
       :job_name,
+      :entity_recognizer_arn,
       :language_code,
       :client_request_token)
       include Aws::Structure

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-comprehend
 version: !ruby/object:Gem::Version
-  version: 1.9.1
+  version: 1.10.0
 platform: ruby
 authors:
 - Amazon Web Services