aws-sdk-rekognition 1.87.0 → 1.89.0

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

@@ -776,6 +776,10 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Copies a version of an Amazon Rekognition Custom Labels model from a
     # source project to a destination project. The source and destination
     # projects can be in different AWS accounts but must be in the same AWS
@@ -794,7 +798,9 @@ module Aws::Rekognition
     # If you are copying a model version to a project in the same AWS
     # account, you don't need to create a project policy.
     #
-    # <note markdown="1"> To copy a model, the destination project, source project, and source
+    # <note markdown="1"> Copying project versions is supported only for Custom Labels models.
+    #
+    #  To copy a model, the destination project, source project, and source
     # model version must already exist.
     #
     #  </note>
@@ -977,6 +983,10 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Creates a new Amazon Rekognition Custom Labels dataset. You can create
     # a dataset by using an Amazon Sagemaker format manifest file or by
     # copying an existing Amazon Rekognition Custom Labels dataset.
@@ -1133,16 +1143,28 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
-    # Creates a new Amazon Rekognition Custom Labels project. A project is a
-    # group of resources (datasets, model versions) that you use to create
-    # and manage Amazon Rekognition Custom Labels models.
-    #
-    # This operation requires permissions to perform the
-    # `rekognition:CreateProject` action.
+    # Creates a new Amazon Rekognition project. A project is a group of
+    # resources (datasets, model versions) that you use to create and manage
+    # a Amazon Rekognition Custom Labels Model or custom adapter. You can
+    # specify a feature to create the project with, if no feature is
+    # specified then Custom Labels is used by default. For adapters, you can
+    # also choose whether or not to have the project auto update by using
+    # the AutoUpdate argument. This operation requires permissions to
+    # perform the `rekognition:CreateProject` action.
     #
     # @option params [required, String] :project_name
     #   The name of the project to create.
     #
+    # @option params [String] :feature
+    #   Specifies feature that is being customized. If no value is provided
+    #   CUSTOM\_LABELS is used as a default.
+    #
+    # @option params [String] :auto_update
+    #   Specifies whether automatic retraining should be attempted for the
+    #   versions of the project. Automatic retraining is done as a best
+    #   effort. Required argument for Content Moderation. Applicable only to
+    #   adapters.
+    #
     # @return [Types::CreateProjectResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateProjectResponse#project_arn #project_arn} => String
@@ -1165,6 +1187,8 @@ module Aws::Rekognition
     #
     #   resp = client.create_project({
     #     project_name: "ProjectName", # required
+    #     feature: "CONTENT_MODERATION", # accepts CONTENT_MODERATION, CUSTOM_LABELS
+    #     auto_update: "ENABLED", # accepts ENABLED, DISABLED
     #   })
     #
     # @example Response structure
@@ -1178,16 +1202,28 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
-    # Creates a new version of a model and begins training. Models are
-    # managed as part of an Amazon Rekognition Custom Labels project. The
-    # response from `CreateProjectVersion` is an Amazon Resource Name (ARN)
-    # for the version of the model.
+    # Creates a new version of Amazon Rekognition project (like a Custom
+    # Labels model or a custom adapter) and begins training. Models and
+    # adapters are managed as part of a Rekognition project. The response
+    # from `CreateProjectVersion` is an Amazon Resource Name (ARN) for the
+    # project version.
+    #
+    # The FeatureConfig operation argument allows you to configure specific
+    # model or adapter settings. You can provide a description to the
+    # project version by using the VersionDescription argment. Training can
+    # take a while to complete. You can get the current status by calling
+    # DescribeProjectVersions. Training completed successfully if the value
+    # of the `Status` field is `TRAINING_COMPLETED`. Once training has
+    # successfully completed, call DescribeProjectVersions to get the
+    # training results and evaluate the model.
     #
-    # Training uses the training and test datasets associated with the
-    # project. For more information, see Creating training and test dataset
-    # in the *Amazon Rekognition Custom Labels Developer Guide*.
+    # This operation requires permissions to perform the
+    # `rekognition:CreateProjectVersion` action.
     #
-    # <note markdown="1"> You can train a model in a project that doesn't have associated
+    # <note markdown="1"> *The following applies only to projects with Amazon Rekognition Custom
+    # Labels as the chosen feature:*
+    #
+    #  You can train a model in a project that doesn't have associated
     # datasets by specifying manifest files in the `TrainingData` and
     # `TestingData` fields.
     #
@@ -1202,57 +1238,42 @@ module Aws::Rekognition
     #
     #  </note>
     #
-    # Training takes a while to complete. You can get the current status by
-    # calling DescribeProjectVersions. Training completed successfully if
-    # the value of the `Status` field is `TRAINING_COMPLETED`.
-    #
-    # If training fails, see Debugging a failed model training in the
-    # *Amazon Rekognition Custom Labels* developer guide.
-    #
-    # Once training has successfully completed, call DescribeProjectVersions
-    # to get the training results and evaluate the model. For more
-    # information, see Improving a trained Amazon Rekognition Custom Labels
-    # model in the *Amazon Rekognition Custom Labels* developers guide.
-    #
-    # After evaluating the model, you start the model by calling
-    # StartProjectVersion.
-    #
-    # This operation requires permissions to perform the
-    # `rekognition:CreateProjectVersion` action.
-    #
     # @option params [required, String] :project_arn
-    #   The ARN of the Amazon Rekognition Custom Labels project that manages
-    #   the model that you want to train.
+    #   The ARN of the Amazon Rekognition project that will manage the project
+    #   version you want to train.
     #
     # @option params [required, String] :version_name
-    #   A name for the version of the model. This value must be unique.
+    #   A name for the version of the project version. This value must be
+    #   unique.
     #
     # @option params [required, Types::OutputConfig] :output_config
-    #   The Amazon S3 bucket location to store the results of training. The S3
-    #   bucket can be in any AWS account as long as the caller has
-    #   `s3:PutObject` permissions on the S3 bucket.
+    #   The Amazon S3 bucket location to store the results of training. The
+    #   bucket can be any S3 bucket in your AWS account. You need
+    #   `s3:PutObject` permission on the bucket.
     #
     # @option params [Types::TrainingData] :training_data
     #   Specifies an external manifest that the services uses to train the
-    #   model. If you specify `TrainingData` you must also specify
+    #   project version. If you specify `TrainingData` you must also specify
     #   `TestingData`. The project must not have any associated datasets.
     #
     # @option params [Types::TestingData] :testing_data
     #   Specifies an external manifest that the service uses to test the
-    #   model. If you specify `TestingData` you must also specify
+    #   project version. If you specify `TestingData` you must also specify
     #   `TrainingData`. The project must not have any associated datasets.
     #
     # @option params [Hash<String,String>] :tags
-    #   A set of tags (key-value pairs) that you want to attach to the model.
+    #   A set of tags (key-value pairs) that you want to attach to the project
+    #   version.
     #
     # @option params [String] :kms_key_id
     #   The identifier for your AWS Key Management Service key (AWS KMS key).
     #   You can supply the Amazon Resource Name (ARN) of your KMS key, the ID
     #   of your KMS key, an alias for your KMS key, or an alias ARN. The key
-    #   is used to encrypt training and test images copied into the service
-    #   for model training. Your source images are unaffected. The key is also
-    #   used to encrypt training results and manifest files written to the
-    #   output Amazon S3 bucket (`OutputConfig`).
+    #   is used to encrypt training images, test images, and manifest files
+    #   copied into the service for the project version. Your source images
+    #   are unaffected. The key is also used to encrypt training results and
+    #   manifest files written to the output Amazon S3 bucket
+    #   (`OutputConfig`).
     #
     #   If you choose to use your own KMS key, you need the following
     #   permissions on the KMS key.
@@ -1268,6 +1289,14 @@ module Aws::Rekognition
     #   If you don't specify a value for `KmsKeyId`, images copied into the
     #   service are encrypted using a key that AWS owns and manages.
     #
+    # @option params [String] :version_description
+    #   A description applied to the project version being created.
+    #
+    # @option params [Types::CustomizationFeatureConfig] :feature_config
+    #   Feature-specific configuration of the training job. If the job
+    #   configuration does not match the feature type associated with the
+    #   project, an InvalidParameterException is returned.
+    #
     # @return [Types::CreateProjectVersionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateProjectVersionResponse#project_version_arn #project_version_arn} => String
@@ -1331,6 +1360,12 @@ module Aws::Rekognition
     #       "TagKey" => "TagValue",
     #     },
     #     kms_key_id: "KmsKeyId",
+    #     version_description: "VersionDescription",
+    #     feature_config: {
+    #       content_moderation: {
+    #         confidence_threshold: 1.0,
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -1636,6 +1671,10 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Deletes an existing Amazon Rekognition Custom Labels dataset. Deleting
     # a dataset might take while. Use DescribeDataset to check the current
     # status. The dataset is still deleting if the value of `Status` is
@@ -1741,9 +1780,9 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
-    # Deletes an Amazon Rekognition Custom Labels project. To delete a
-    # project you must first delete all models associated with the project.
-    # To delete a model, see DeleteProjectVersion.
+    # Deletes a Amazon Rekognition project. To delete a project you must
+    # first delete all models or adapters associated with the project. To
+    # delete a model or adapter, see DeleteProjectVersion.
     #
     # `DeleteProject` is an asynchronous operation. To check if the project
     # is deleted, call DescribeProjects. The project is deleted when the
@@ -1792,6 +1831,10 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Deletes an existing project policy.
     #
     # To get a list of project policies attached to a project, call
@@ -1843,18 +1886,20 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
-    # Deletes an Amazon Rekognition Custom Labels model.
+    # Deletes a Rekognition project model or project version, like a Amazon
+    # Rekognition Custom Labels model or a custom adapter.
     #
-    # You can't delete a model if it is running or if it is training. To
-    # check the status of a model, use the `Status` field returned from
-    # DescribeProjectVersions. To stop a running model call
-    # StopProjectVersion. If the model is training, wait until it finishes.
+    # You can't delete a project version if it is running or if it is
+    # training. To check the status of a project version, use the Status
+    # field returned from DescribeProjectVersions. To stop a project version
+    # call StopProjectVersion. If the project version is training, wait
+    # until it finishes.
     #
     # This operation requires permissions to perform the
     # `rekognition:DeleteProjectVersion` action.
     #
     # @option params [required, String] :project_version_arn
-    #   The Amazon Resource Name (ARN) of the model version that you want to
+    #   The Amazon Resource Name (ARN) of the project version that you want to
     #   delete.
     #
     # @return [Types::DeleteProjectVersionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1883,7 +1928,7 @@ module Aws::Rekognition
     #
     # @example Response structure
     #
-    #   resp.status #=> String, one of "TRAINING_IN_PROGRESS", "TRAINING_COMPLETED", "TRAINING_FAILED", "STARTING", "RUNNING", "FAILED", "STOPPING", "STOPPED", "DELETING", "COPYING_IN_PROGRESS", "COPYING_COMPLETED", "COPYING_FAILED"
+    #   resp.status #=> String, one of "TRAINING_IN_PROGRESS", "TRAINING_COMPLETED", "TRAINING_FAILED", "STARTING", "RUNNING", "FAILED", "STOPPING", "STOPPED", "DELETING", "COPYING_IN_PROGRESS", "COPYING_COMPLETED", "COPYING_FAILED", "DEPRECATED", "EXPIRED"
     #
     # @overload delete_project_version(params = {})
     # @param [Hash] params ({})
@@ -2007,6 +2052,10 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Describes an Amazon Rekognition Custom Labels dataset. You can get
     # information such as the current status of a dataset and statistics
     # about the images and labels in a dataset.
@@ -2073,32 +2122,32 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
-    # Lists and describes the versions of a model in an Amazon Rekognition
-    # Custom Labels project. You can specify up to 10 model versions in
+    # Lists and describes the versions of an Amazon Rekognition project. You
+    # can specify up to 10 model or adapter versions in
     # `ProjectVersionArns`. If you don't specify a value, descriptions for
-    # all model versions in the project are returned.
+    # all model/adapter versions in the project are returned.
     #
     # This operation requires permissions to perform the
     # `rekognition:DescribeProjectVersions` action.
     #
     # @option params [required, String] :project_arn
-    #   The Amazon Resource Name (ARN) of the project that contains the models
-    #   you want to describe.
+    #   The Amazon Resource Name (ARN) of the project that contains the
+    #   model/adapter you want to describe.
     #
     # @option params [Array<String>] :version_names
-    #   A list of model version names that you want to describe. You can add
-    #   up to 10 model version names to the list. If you don't specify a
-    #   value, all model descriptions are returned. A version name is part of
-    #   a model (ProjectVersion) ARN. For example,
-    #   `my-model.2020-01-21T09.10.15` is the version name in the following
-    #   ARN.
+    #   A list of model or project version names that you want to describe.
+    #   You can add up to 10 model or project version names to the list. If
+    #   you don't specify a value, all project version descriptions are
+    #   returned. A version name is part of a project version ARN. For
+    #   example, `my-model.2020-01-21T09.10.15` is the version name in the
+    #   following ARN.
     #   `arn:aws:rekognition:us-east-1:123456789012:project/getting-started/version/my-model.2020-01-21T09.10.15/1234567890123`.
     #
     # @option params [String] :next_token
     #   If the previous response was incomplete (because there is more results
-    #   to retrieve), Amazon Rekognition Custom Labels returns a pagination
-    #   token in the response. You can use this pagination token to retrieve
-    #   the next set of results.
+    #   to retrieve), Amazon Rekognition returns a pagination token in the
+    #   response. You can use this pagination token to retrieve the next set
+    #   of results.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return per paginated call. The
@@ -2232,7 +2281,7 @@ module Aws::Rekognition
     #   resp.project_version_descriptions[0].project_version_arn #=> String
     #   resp.project_version_descriptions[0].creation_timestamp #=> Time
     #   resp.project_version_descriptions[0].min_inference_units #=> Integer
-    #   resp.project_version_descriptions[0].status #=> String, one of "TRAINING_IN_PROGRESS", "TRAINING_COMPLETED", "TRAINING_FAILED", "STARTING", "RUNNING", "FAILED", "STOPPING", "STOPPED", "DELETING", "COPYING_IN_PROGRESS", "COPYING_COMPLETED", "COPYING_FAILED"
+    #   resp.project_version_descriptions[0].status #=> String, one of "TRAINING_IN_PROGRESS", "TRAINING_COMPLETED", "TRAINING_FAILED", "STARTING", "RUNNING", "FAILED", "STOPPING", "STOPPED", "DELETING", "COPYING_IN_PROGRESS", "COPYING_COMPLETED", "COPYING_FAILED", "DEPRECATED", "EXPIRED"
     #   resp.project_version_descriptions[0].status_message #=> String
     #   resp.project_version_descriptions[0].billable_training_time_in_seconds #=> Integer
     #   resp.project_version_descriptions[0].training_end_timestamp #=> Time
@@ -2274,6 +2323,10 @@ module Aws::Rekognition
     #   resp.project_version_descriptions[0].kms_key_id #=> String
     #   resp.project_version_descriptions[0].max_inference_units #=> Integer
     #   resp.project_version_descriptions[0].source_project_version_arn #=> String
+    #   resp.project_version_descriptions[0].version_description #=> String
+    #   resp.project_version_descriptions[0].feature #=> String, one of "CONTENT_MODERATION", "CUSTOM_LABELS"
+    #   resp.project_version_descriptions[0].base_model_version #=> String
+    #   resp.project_version_descriptions[0].feature_config.content_moderation.confidence_threshold #=> Float
     #   resp.next_token #=> String
     #
     #
@@ -2289,16 +2342,15 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
-    # Gets information about your Amazon Rekognition Custom Labels projects.
+    # Gets information about your Rekognition projects.
     #
     # This operation requires permissions to perform the
     # `rekognition:DescribeProjects` action.
     #
     # @option params [String] :next_token
     #   If the previous response was incomplete (because there is more results
-    #   to retrieve), Amazon Rekognition Custom Labels returns a pagination
-    #   token in the response. You can use this pagination token to retrieve
-    #   the next set of results.
+    #   to retrieve), Rekognition returns a pagination token in the response.
+    #   You can use this pagination token to retrieve the next set of results.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return per paginated call. The
@@ -2307,9 +2359,13 @@ module Aws::Rekognition
     #   100.
     #
     # @option params [Array<String>] :project_names
-    #   A list of the projects that you want Amazon Rekognition Custom Labels
-    #   to describe. If you don't specify a value, the response includes
-    #   descriptions for all the projects in your AWS account.
+    #   A list of the projects that you want Rekognition to describe. If you
+    #   don't specify a value, the response includes descriptions for all the
+    #   projects in your AWS account.
+    #
+    # @option params [Array<String>] :features
+    #   Specifies the type of customization to filter projects by. If no value
+    #   is specified, CUSTOM\_LABELS is used as a default.
     #
     # @return [Types::DescribeProjectsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2364,6 +2420,7 @@ module Aws::Rekognition
     #     next_token: "ExtendedPaginationToken",
     #     max_results: 1,
     #     project_names: ["ProjectName"],
+    #     features: ["CONTENT_MODERATION"], # accepts CONTENT_MODERATION, CUSTOM_LABELS
     #   })
     #
     # @example Response structure
@@ -2379,6 +2436,8 @@ module Aws::Rekognition
     #   resp.project_descriptions[0].datasets[0].status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_COMPLETE", "CREATE_FAILED", "UPDATE_IN_PROGRESS", "UPDATE_COMPLETE", "UPDATE_FAILED", "DELETE_IN_PROGRESS"
     #   resp.project_descriptions[0].datasets[0].status_message #=> String
     #   resp.project_descriptions[0].datasets[0].status_message_code #=> String, one of "SUCCESS", "SERVICE_ERROR", "CLIENT_ERROR"
+    #   resp.project_descriptions[0].feature #=> String, one of "CONTENT_MODERATION", "CUSTOM_LABELS"
+    #   resp.project_descriptions[0].auto_update #=> String, one of "ENABLED", "DISABLED"
     #   resp.next_token #=> String
     #
     # @overload describe_projects(params = {})
@@ -2456,6 +2515,10 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Detects custom labels in a supplied image by using an Amazon
     # Rekognition Custom Labels model.
     #
@@ -2502,7 +2565,10 @@ module Aws::Rekognition
     # Rekognition Custom Labels Developer Guide.
     #
     # @option params [required, String] :project_version_arn
-    #   The ARN of the model version that you want to use.
+    #   The ARN of the model version that you want to use. Only models
+    #   associated with Custom Labels projects accepted by the operation. If a
+    #   provided ARN refers to a model version associated with a project for a
+    #   different feature type, then an InvalidParameterException is returned.
     #
     # @option params [required, Types::Image] :image
     #   Provides the input image either as bytes or an S3 object.
@@ -3124,6 +3190,9 @@ module Aws::Rekognition
     # to call Amazon Rekognition operations, passing image bytes is not
     # supported. The image must be either a PNG or JPEG formatted file.
     #
+    # You can specify an adapter to use when retrieving label predictions by
+    # providing a `ProjectVersionArn` to the `ProjectVersion` argument.
+    #
     # @option params [required, Types::Image] :image
     #   The input image as base64-encoded bytes or an S3 object. If you use
     #   the AWS CLI to call Amazon Rekognition operations, passing
@@ -3146,11 +3215,17 @@ module Aws::Rekognition
     #   Sets up the configuration for human evaluation, including the
     #   FlowDefinition the image will be sent to.
     #
+    # @option params [String] :project_version
+    #   Identifier for the custom adapter. Expects the ProjectVersionArn as a
+    #   value. Use the CreateProject or CreateProjectVersion APIs to create a
+    #   custom adapter.
+    #
     # @return [Types::DetectModerationLabelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DetectModerationLabelsResponse#moderation_labels #moderation_labels} => Array&lt;Types::ModerationLabel&gt;
     #   * {Types::DetectModerationLabelsResponse#moderation_model_version #moderation_model_version} => String
     #   * {Types::DetectModerationLabelsResponse#human_loop_activation_output #human_loop_activation_output} => Types::HumanLoopActivationOutput
+    #   * {Types::DetectModerationLabelsResponse#project_version #project_version} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -3171,6 +3246,7 @@ module Aws::Rekognition
     #         content_classifiers: ["FreeOfPersonallyIdentifiableInformation"], # accepts FreeOfPersonallyIdentifiableInformation, FreeOfAdultContent
     #       },
     #     },
+    #     project_version: "ProjectVersionId",
     #   })
     #
     # @example Response structure
@@ -3184,6 +3260,7 @@ module Aws::Rekognition
     #   resp.human_loop_activation_output.human_loop_activation_reasons #=> Array
     #   resp.human_loop_activation_output.human_loop_activation_reasons[0] #=> String
     #   resp.human_loop_activation_output.human_loop_activation_conditions_evaluation_results #=> String
+    #   resp.project_version #=> String
     #
     # @overload detect_moderation_labels(params = {})
     # @param [Hash] params ({})
@@ -3513,6 +3590,10 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Distributes the entries (images) in a training dataset across the
     # training dataset and the test dataset for a project.
     # `DistributeDatasetEntries` moves 20% of the training dataset images to
@@ -4468,6 +4549,111 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # Retrieves the results for a given media analysis job. Takes a `JobId`
+    # returned by StartMediaAnalysisJob.
+    #
+    # @option params [required, String] :job_id
+    #   Unique identifier for the media analysis job for which you want to
+    #   retrieve results.
+    #
+    # @return [Types::GetMediaAnalysisJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetMediaAnalysisJobResponse#job_id #job_id} => String
+    #   * {Types::GetMediaAnalysisJobResponse#job_name #job_name} => String
+    #   * {Types::GetMediaAnalysisJobResponse#operations_config #operations_config} => Types::MediaAnalysisOperationsConfig
+    #   * {Types::GetMediaAnalysisJobResponse#status #status} => String
+    #   * {Types::GetMediaAnalysisJobResponse#failure_details #failure_details} => Types::MediaAnalysisJobFailureDetails
+    #   * {Types::GetMediaAnalysisJobResponse#creation_timestamp #creation_timestamp} => Time
+    #   * {Types::GetMediaAnalysisJobResponse#completion_timestamp #completion_timestamp} => Time
+    #   * {Types::GetMediaAnalysisJobResponse#input #input} => Types::MediaAnalysisInput
+    #   * {Types::GetMediaAnalysisJobResponse#output_config #output_config} => Types::MediaAnalysisOutputConfig
+    #   * {Types::GetMediaAnalysisJobResponse#kms_key_id #kms_key_id} => String
+    #   * {Types::GetMediaAnalysisJobResponse#results #results} => Types::MediaAnalysisResults
+    #   * {Types::GetMediaAnalysisJobResponse#manifest_summary #manifest_summary} => Types::MediaAnalysisManifestSummary
+    #
+    #
+    # @example Example: GetMediaAnalysisJob
+    #
+    #   # Retrieves the results for a given media analysis job.
+    #
+    #   resp = client.get_media_analysis_job({
+    #     job_id: "861a0645d98ef88efb75477628c011c04942d9d5f58faf2703c393c8cf8c1537", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     completion_timestamp: Time.parse("2023-07-28T08:05:51.958000-07:00"), 
+    #     creation_timestamp: Time.parse("2023-07-28T08:05:51.958000-06:00"), 
+    #     input: {
+    #       s3_object: {
+    #         bucket: "input-bucket", 
+    #         name: "input-manifest.json", 
+    #       }, 
+    #     }, 
+    #     job_id: "861a0645d98ef88efb75477628c011c04942d9d5f58faf2703c393c8cf8c1537", 
+    #     job_name: "job-name", 
+    #     manifest_summary: {
+    #       s3_object: {
+    #         bucket: "output-bucket", 
+    #         name: "output-location/861a0645d98ef88efb75477628c011c04942d9d5f58faf2703c393c8cf8c1537-manifest-summary.json", 
+    #       }, 
+    #     }, 
+    #     operations_config: {
+    #       detect_moderation_labels: {
+    #         min_confidence: 50, 
+    #         project_version: "arn:aws:rekognition:us-east-1:111122223333:project/my-project/version/1/1690556751958", 
+    #       }, 
+    #     }, 
+    #     output_config: {
+    #       s3_bucket: "output-bucket", 
+    #       s3_key_prefix: "output-location", 
+    #     }, 
+    #     results: {
+    #       s3_object: {
+    #         bucket: "output-bucket", 
+    #         name: "output-location/861a0645d98ef88efb75477628c011c04942d9d5f58faf2703c393c8cf8c1537-results.jsonl", 
+    #       }, 
+    #     }, 
+    #     status: "SUCCEEDED", 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_media_analysis_job({
+    #     job_id: "MediaAnalysisJobId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.job_id #=> String
+    #   resp.job_name #=> String
+    #   resp.operations_config.detect_moderation_labels.min_confidence #=> Float
+    #   resp.operations_config.detect_moderation_labels.project_version #=> String
+    #   resp.status #=> String, one of "CREATED", "QUEUED", "IN_PROGRESS", "SUCCEEDED", "FAILED"
+    #   resp.failure_details.code #=> String, one of "INTERNAL_ERROR", "INVALID_S3_OBJECT", "INVALID_MANIFEST", "INVALID_OUTPUT_CONFIG", "INVALID_KMS_KEY", "ACCESS_DENIED", "RESOURCE_NOT_FOUND", "RESOURCE_NOT_READY", "THROTTLED"
+    #   resp.failure_details.message #=> String
+    #   resp.creation_timestamp #=> Time
+    #   resp.completion_timestamp #=> Time
+    #   resp.input.s3_object.bucket #=> String
+    #   resp.input.s3_object.name #=> String
+    #   resp.input.s3_object.version #=> String
+    #   resp.output_config.s3_bucket #=> String
+    #   resp.output_config.s3_key_prefix #=> String
+    #   resp.kms_key_id #=> String
+    #   resp.results.s3_object.bucket #=> String
+    #   resp.results.s3_object.name #=> String
+    #   resp.results.s3_object.version #=> String
+    #   resp.manifest_summary.s3_object.bucket #=> String
+    #   resp.manifest_summary.s3_object.name #=> String
+    #   resp.manifest_summary.s3_object.version #=> String
+    #
+    # @overload get_media_analysis_job(params = {})
+    # @param [Hash] params ({})
+    def get_media_analysis_job(params = {}, options = {})
+      req = build_request(:get_media_analysis_job, params)
+      req.send_request(options)
+    end
+
     # Gets the path tracking results of a Amazon Rekognition Video analysis
     # started by StartPersonTracking.
     #
@@ -5359,6 +5545,10 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Lists the entries (images) within a dataset. An entry is a JSON Line
     # that contains the information for a single image, including the image
     # location, assigned labels, and object location bounding boxes. For
@@ -5476,6 +5666,10 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Lists the labels in a dataset. Amazon Rekognition Custom Labels uses
     # labels to describe images. For more information, see [Labeling
     # images][1].
@@ -5692,6 +5886,119 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # Returns a list of media analysis jobs. Results are sorted by
+    # `CreationTimestamp` in descending order.
+    #
+    # @option params [String] :next_token
+    #   Pagination token, if the previous response was incomplete.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return per paginated call. The
+    #   largest value user can specify is 100. If user specifies a value
+    #   greater than 100, an `InvalidParameterException` error occurs. The
+    #   default value is 100.
+    #
+    # @return [Types::ListMediaAnalysisJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListMediaAnalysisJobsResponse#next_token #next_token} => String
+    #   * {Types::ListMediaAnalysisJobsResponse#media_analysis_jobs #media_analysis_jobs} => Array&lt;Types::MediaAnalysisJobDescription&gt;
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    #
+    # @example Example: ListMediaAnalysisJobs
+    #
+    #   # Returns a list of media analysis jobs.
+    #
+    #   resp = client.list_media_analysis_jobs({
+    #     max_results: 10, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     media_analysis_jobs: [
+    #       {
+    #         completion_timestamp: Time.parse("2023-07-28T08:05:51.958000-07:00"), 
+    #         creation_timestamp: Time.parse("2023-07-28T08:05:51.958000-06:00"), 
+    #         input: {
+    #           s3_object: {
+    #             bucket: "input-bucket", 
+    #             name: "input-manifest.json", 
+    #           }, 
+    #         }, 
+    #         job_id: "861a0645d98ef88efb75477628c011c04942d9d5f58faf2703c393c8cf8c1537", 
+    #         job_name: "job-name", 
+    #         manifest_summary: {
+    #           s3_object: {
+    #             bucket: "output-bucket", 
+    #             name: "output-location/861a0645d98ef88efb75477628c011c04942d9d5f58faf2703c393c8cf8c1537-manifest-summary.json", 
+    #           }, 
+    #         }, 
+    #         operations_config: {
+    #           detect_moderation_labels: {
+    #             min_confidence: 50, 
+    #             project_version: "arn:aws:rekognition:us-east-1:111122223333:project/my-project/version/1/1690556751958", 
+    #           }, 
+    #         }, 
+    #         output_config: {
+    #           s3_bucket: "output-bucket", 
+    #           s3_key_prefix: "output-location", 
+    #         }, 
+    #         results: {
+    #           s3_object: {
+    #             bucket: "output-bucket", 
+    #             name: "output-location/861a0645d98ef88efb75477628c011c04942d9d5f58faf2703c393c8cf8c1537-results.jsonl", 
+    #           }, 
+    #         }, 
+    #         status: "SUCCEEDED", 
+    #       }, 
+    #     ], 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_media_analysis_jobs({
+    #     next_token: "ExtendedPaginationToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.next_token #=> String
+    #   resp.media_analysis_jobs #=> Array
+    #   resp.media_analysis_jobs[0].job_id #=> String
+    #   resp.media_analysis_jobs[0].job_name #=> String
+    #   resp.media_analysis_jobs[0].operations_config.detect_moderation_labels.min_confidence #=> Float
+    #   resp.media_analysis_jobs[0].operations_config.detect_moderation_labels.project_version #=> String
+    #   resp.media_analysis_jobs[0].status #=> String, one of "CREATED", "QUEUED", "IN_PROGRESS", "SUCCEEDED", "FAILED"
+    #   resp.media_analysis_jobs[0].failure_details.code #=> String, one of "INTERNAL_ERROR", "INVALID_S3_OBJECT", "INVALID_MANIFEST", "INVALID_OUTPUT_CONFIG", "INVALID_KMS_KEY", "ACCESS_DENIED", "RESOURCE_NOT_FOUND", "RESOURCE_NOT_READY", "THROTTLED"
+    #   resp.media_analysis_jobs[0].failure_details.message #=> String
+    #   resp.media_analysis_jobs[0].creation_timestamp #=> Time
+    #   resp.media_analysis_jobs[0].completion_timestamp #=> Time
+    #   resp.media_analysis_jobs[0].input.s3_object.bucket #=> String
+    #   resp.media_analysis_jobs[0].input.s3_object.name #=> String
+    #   resp.media_analysis_jobs[0].input.s3_object.version #=> String
+    #   resp.media_analysis_jobs[0].output_config.s3_bucket #=> String
+    #   resp.media_analysis_jobs[0].output_config.s3_key_prefix #=> String
+    #   resp.media_analysis_jobs[0].kms_key_id #=> String
+    #   resp.media_analysis_jobs[0].results.s3_object.bucket #=> String
+    #   resp.media_analysis_jobs[0].results.s3_object.name #=> String
+    #   resp.media_analysis_jobs[0].results.s3_object.version #=> String
+    #   resp.media_analysis_jobs[0].manifest_summary.s3_object.bucket #=> String
+    #   resp.media_analysis_jobs[0].manifest_summary.s3_object.name #=> String
+    #   resp.media_analysis_jobs[0].manifest_summary.s3_object.version #=> String
+    #
+    # @overload list_media_analysis_jobs(params = {})
+    # @param [Hash] params ({})
+    def list_media_analysis_jobs(params = {}, options = {})
+      req = build_request(:list_media_analysis_jobs, params)
+      req.send_request(options)
+    end
+
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Gets a list of the project policies attached to a project.
     #
     # To attach a project policy to a project, call PutProjectPolicy. To
@@ -5916,11 +6223,16 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Attaches a project policy to a Amazon Rekognition Custom Labels
     # project in a trusting AWS account. A project policy specifies that a
     # trusted AWS account can copy a model version from a trusting AWS
     # account to a project in the trusted AWS account. To copy a model
-    # version you use the CopyProjectVersion operation.
+    # version you use the CopyProjectVersion operation. Only applies to
+    # Custom Labels projects.
     #
     # For more information about the format of a project policy document,
     # see Attaching a project policy (SDK) in the *Amazon Rekognition Custom
@@ -7242,6 +7554,108 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # Initiates a new media analysis job. Accepts a manifest file in an
+    # Amazon S3 bucket. The output is a manifest file and a summary of the
+    # manifest stored in the Amazon S3 bucket.
+    #
+    # @option params [String] :client_request_token
+    #   Idempotency token used to prevent the accidental creation of duplicate
+    #   versions. If you use the same token with multiple
+    #   `StartMediaAnalysisJobRequest` requests, the same response is
+    #   returned. Use `ClientRequestToken` to prevent the same request from
+    #   being processed more than once.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @option params [String] :job_name
+    #   The name of the job. Does not have to be unique.
+    #
+    # @option params [required, Types::MediaAnalysisOperationsConfig] :operations_config
+    #   Configuration options for the media analysis job to be created.
+    #
+    # @option params [required, Types::MediaAnalysisInput] :input
+    #   Input data to be analyzed by the job.
+    #
+    # @option params [required, Types::MediaAnalysisOutputConfig] :output_config
+    #   The Amazon S3 bucket location to store the results.
+    #
+    # @option params [String] :kms_key_id
+    #   The identifier of customer managed AWS KMS key (name or ARN). The key
+    #   is used to encrypt images copied into the service. The key is also
+    #   used to encrypt results and manifest files written to the output
+    #   Amazon S3 bucket.
+    #
+    # @return [Types::StartMediaAnalysisJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartMediaAnalysisJobResponse#job_id #job_id} => String
+    #
+    #
+    # @example Example: StartMediaAnalysisJob
+    #
+    #   # Initiates a new media analysis job.
+    #
+    #   resp = client.start_media_analysis_job({
+    #     input: {
+    #       s3_object: {
+    #         bucket: "input-bucket", 
+    #         name: "input-manifest.json", 
+    #       }, 
+    #     }, 
+    #     job_name: "job-name", 
+    #     operations_config: {
+    #       detect_moderation_labels: {
+    #         min_confidence: 50, 
+    #         project_version: "arn:aws:rekognition:us-east-1:111122223333:project/my-project/version/1/1690556751958", 
+    #       }, 
+    #     }, 
+    #     output_config: {
+    #       s3_bucket: "output-bucket", 
+    #       s3_key_prefix: "output-location", 
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     job_id: "861a0645d98ef88efb75477628c011c04942d9d5f58faf2703c393c8cf8c1537", 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_media_analysis_job({
+    #     client_request_token: "ClientRequestToken",
+    #     job_name: "MediaAnalysisJobName",
+    #     operations_config: { # required
+    #       detect_moderation_labels: {
+    #         min_confidence: 1.0,
+    #         project_version: "ProjectVersionId",
+    #       },
+    #     },
+    #     input: { # required
+    #       s3_object: { # required
+    #         bucket: "S3Bucket",
+    #         name: "S3ObjectName",
+    #         version: "S3ObjectVersion",
+    #       },
+    #     },
+    #     output_config: { # required
+    #       s3_bucket: "S3Bucket", # required
+    #       s3_key_prefix: "MediaAnalysisS3KeyPrefix",
+    #     },
+    #     kms_key_id: "KmsKeyId",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.job_id #=> String
+    #
+    # @overload start_media_analysis_job(params = {})
+    # @param [Hash] params ({})
+    def start_media_analysis_job(params = {}, options = {})
+      req = build_request(:start_media_analysis_job, params)
+      req.send_request(options)
+    end
+
     # Starts the asynchronous tracking of a person's path in a stored
     # video.
     #
@@ -7313,6 +7727,10 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Starts the running of the version of a model. Starting a model takes a
     # while to complete. To check the current state of the model, use
     # DescribeProjectVersions.
@@ -7325,9 +7743,6 @@ module Aws::Rekognition
     #
     #  </note>
     #
-    # For more information, see *Running a trained Amazon Rekognition Custom
-    # Labels model* in the Amazon Rekognition Custom Labels Guide.
-    #
     # This operation requires permissions to perform the
     # `rekognition:StartProjectVersion` action.
     #
@@ -7339,11 +7754,6 @@ module Aws::Rekognition
     #   The minimum number of inference units to use. A single inference unit
     #   represents 1 hour of processing.
     #
-    #   For information about the number of transactions per second (TPS) that
-    #   an inference unit can support, see *Running a trained Amazon
-    #   Rekognition Custom Labels model* in the Amazon Rekognition Custom
-    #   Labels Guide.
-    #
     #   Use a higher number to increase the TPS throughput of your model. You
     #   are charged for the number of inference units that you use.
     #
@@ -7382,7 +7792,7 @@ module Aws::Rekognition
     #
     # @example Response structure
     #
-    #   resp.status #=> String, one of "TRAINING_IN_PROGRESS", "TRAINING_COMPLETED", "TRAINING_FAILED", "STARTING", "RUNNING", "FAILED", "STOPPING", "STOPPED", "DELETING", "COPYING_IN_PROGRESS", "COPYING_COMPLETED", "COPYING_FAILED"
+    #   resp.status #=> String, one of "TRAINING_IN_PROGRESS", "TRAINING_COMPLETED", "TRAINING_FAILED", "STARTING", "RUNNING", "FAILED", "STOPPING", "STOPPED", "DELETING", "COPYING_IN_PROGRESS", "COPYING_COMPLETED", "COPYING_FAILED", "DEPRECATED", "EXPIRED"
     #
     # @overload start_project_version(params = {})
     # @param [Hash] params ({})
@@ -7665,15 +8075,20 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Stops a running model. The operation might take a while to complete.
-    # To check the current status, call DescribeProjectVersions.
+    # To check the current status, call DescribeProjectVersions. Only
+    # applies to Custom Labels projects.
     #
     # This operation requires permissions to perform the
     # `rekognition:StopProjectVersion` action.
     #
     # @option params [required, String] :project_version_arn
     #   The Amazon Resource Name (ARN) of the model version that you want to
-    #   delete.
+    #   stop.
     #
     #   This operation requires permissions to perform the
     #   `rekognition:StopProjectVersion` action.
@@ -7704,7 +8119,7 @@ module Aws::Rekognition
     #
     # @example Response structure
     #
-    #   resp.status #=> String, one of "TRAINING_IN_PROGRESS", "TRAINING_COMPLETED", "TRAINING_FAILED", "STARTING", "RUNNING", "FAILED", "STOPPING", "STOPPED", "DELETING", "COPYING_IN_PROGRESS", "COPYING_COMPLETED", "COPYING_FAILED"
+    #   resp.status #=> String, one of "TRAINING_IN_PROGRESS", "TRAINING_COMPLETED", "TRAINING_FAILED", "STARTING", "RUNNING", "FAILED", "STOPPING", "STOPPED", "DELETING", "COPYING_IN_PROGRESS", "COPYING_COMPLETED", "COPYING_FAILED", "DEPRECATED", "EXPIRED"
     #
     # @overload stop_project_version(params = {})
     # @param [Hash] params ({})
@@ -7799,6 +8214,10 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> This operation applies only to Amazon Rekognition Custom Labels.
+    #
+    #  </note>
+    #
     # Adds or updates one or more entries (images) in a dataset. An entry is
     # a JSON Line which contains the information for a single image,
     # including the image location, assigned labels, and object location
@@ -7949,7 +8368,7 @@ module Aws::Rekognition
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rekognition'
-      context[:gem_version] = '1.87.0'
+      context[:gem_version] = '1.89.0'
       Seahorse::Client::Request.new(handlers, context)
     end