feat(aws-android-sdk-rekognition): update models to latest (#3236)

Co-authored-by: Matt Creaser <[email protected]>

Author: awsmobilesdk

aws-android-sdk-rekognition/src/main/java/com/amazonaws/services/rekognition/AmazonRekognition.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2010-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License").
  * You may not use this file except in compliance with the License.
@@ -676,6 +676,10 @@ CompareFacesResult compareFaces(CompareFacesRequest compareFacesRequest)
      * copy operation has finished when the value of <code>Status</code> is
      * <code>COPYING_COMPLETED</code>.
      * </p>
+     * <p>
+     * This operation requires permissions to perform the
+     * <code>rekognition:CopyProjectVersion</code> action.
+     * </p>
      * 
      * @param copyProjectVersionRequest
      * @return copyProjectVersionResult The response from the CopyProjectVersion
@@ -812,6 +816,40 @@ CreateCollectionResult createCollection(CreateCollectionRequest createCollection
     CreateDatasetResult createDataset(CreateDatasetRequest createDatasetRequest)
             throws AmazonClientException, AmazonServiceException;
 
+    /**
+     * <p>
+     * This API operation initiates a Face Liveness session. It returns a
+     * <code>SessionId</code>, which you can use to start streaming Face
+     * Liveness video and get the results for a Face Liveness session. You can
+     * use the <code>OutputConfig</code> option in the Settings parameter to
+     * provide an Amazon S3 bucket location. The Amazon S3 bucket stores
+     * reference images and audit images. You can use
+     * <code>AuditImagesLimit</code> to limit of audit images returned. This
+     * number is between 0 and 4. By default, it is set to 0. The limit is best
+     * effort and based on the duration of the selfie-video.
+     * </p>
+     * 
+     * @param createFaceLivenessSessionRequest
+     * @return createFaceLivenessSessionResult The response from the
+     *         CreateFaceLivenessSession service method, as returned by Amazon
+     *         Rekognition.
+     * @throws AccessDeniedException
+     * @throws InternalServerErrorException
+     * @throws InvalidParameterException
+     * @throws ThrottlingException
+     * @throws ProvisionedThroughputExceededException
+     * @throws AmazonClientException If any internal errors are encountered
+     *             inside the client while attempting to make the request or
+     *             handle the response. For example if a network connection is
+     *             not available.
+     * @throws AmazonServiceException If an error response is returned by Amazon
+     *             Rekognition indicating either a problem with the data in the
+     *             request, or a server side issue.
+     */
+    CreateFaceLivenessSessionResult createFaceLivenessSession(
+            CreateFaceLivenessSessionRequest createFaceLivenessSessionRequest)
+            throws AmazonClientException, AmazonServiceException;
+
     /**
      * <p>
      * Creates a new Amazon Rekognition Custom Labels project. A project is a
@@ -940,11 +978,11 @@ CreateProjectVersionResult createProjectVersion(
      * <p>
      * If you are creating a stream processor for detecting faces, you provide
      * as input a Kinesis video stream (<code>Input</code>) and a Kinesis data
-     * stream (<code>Output</code>) stream. You also specify the face
-     * recognition criteria in <code>Settings</code>. For example, the
-     * collection containing faces that you want to recognize. After you have
-     * finished analyzing a streaming video, use <a>StopStreamProcessor</a> to
-     * stop processing.
+     * stream (<code>Output</code>) stream for receiving the output. You must
+     * use the <code>FaceSearch</code> option in <code>Settings</code>,
+     * specifying the collection that contains the faces you want to recognize.
+     * After you have finished analyzing a streaming video, use
+     * <a>StopStreamProcessor</a> to stop processing.
      * </p>
      * </li>
      * <li>
@@ -954,9 +992,10 @@ CreateProjectVersionResult createProjectVersion(
      * information (<code>Output</code>), and an Amazon SNS topic ARN (
      * <code>NotificationChannel</code>). You can also provide a KMS key ID to
      * encrypt the data sent to your Amazon S3 bucket. You specify what you want
-     * to detect in <code>ConnectedHomeSettings</code>, such as people, packages
-     * and people, or pets, people, and packages. You can also specify where in
-     * the frame you want Amazon Rekognition to monitor with
+     * to detect by using the <code>ConnectedHome</code> option in settings, and
+     * selecting one of the following: <code>PERSON</code>, <code>PET</code>,
+     * <code>PACKAGE</code>, <code>ALL</code> You can also specify where in the
+     * frame you want Amazon Rekognition to monitor with
      * <code>RegionsOfInterest</code>. When you run the
      * <a>StartStreamProcessor</a> operation on a label detection stream
      * processor, you input start and stop information to determine the length
@@ -1152,6 +1191,10 @@ DeleteProjectResult deleteProject(DeleteProjectRequest deleteProjectRequest)
      * <a>ListProjectPolicies</a>. To attach a project policy to a project, call
      * <a>PutProjectPolicy</a>.
      * </p>
+     * <p>
+     * This operation requires permissions to perform the
+     * <code>rekognition:DeleteProjectPolicy</code> action.
+     * </p>
      * 
      * @param deleteProjectPolicyRequest
      * @return deleteProjectPolicyResult The response from the
@@ -1592,7 +1635,7 @@ DetectFacesResult detectFaces(DetectFacesRequest detectFacesRequest)
      * </p>
      * <p>
      * For each object, scene, and concept the API returns one or more labels.
-     * The API returns the following types of information regarding labels:
+     * The API returns the following types of information about labels:
      * </p>
      * <ul>
      * <li>
@@ -1708,8 +1751,7 @@ DetectFacesResult detectFaces(DetectFacesRequest detectFacesRequest)
      * </p>
      * </note>
      * <p>
-     * This is a stateless API operation. That is, the operation does not
-     * persist any data.
+     * This is a stateless API operation that doesn't return any data.
      * </p>
      * <p>
      * This operation requires permissions to perform the
@@ -2264,6 +2306,39 @@ GetContentModerationResult getContentModeration(
     GetFaceDetectionResult getFaceDetection(GetFaceDetectionRequest getFaceDetectionRequest)
             throws AmazonClientException, AmazonServiceException;
 
+    /**
+     * <p>
+     * Retrieves the results of a specific Face Liveness session. It requires
+     * the <code>sessionId</code> as input, which was created using
+     * <code>CreateFaceLivenessSession</code>. Returns the corresponding Face
+     * Liveness confidence score, a reference image that includes a face
+     * bounding box, and audit images that also contain face bounding boxes. The
+     * Face Liveness confidence score ranges from 0 to 100. The reference image
+     * can optionally be returned.
+     * </p>
+     * 
+     * @param getFaceLivenessSessionResultsRequest
+     * @return getFaceLivenessSessionResultsResult The response from the
+     *         GetFaceLivenessSessionResults service method, as returned by
+     *         Amazon Rekognition.
+     * @throws AccessDeniedException
+     * @throws InternalServerErrorException
+     * @throws InvalidParameterException
+     * @throws SessionNotFoundException
+     * @throws ThrottlingException
+     * @throws ProvisionedThroughputExceededException
+     * @throws AmazonClientException If any internal errors are encountered
+     *             inside the client while attempting to make the request or
+     *             handle the response. For example if a network connection is
+     *             not available.
+     * @throws AmazonServiceException If an error response is returned by Amazon
+     *             Rekognition indicating either a problem with the data in the
+     *             request, or a server side issue.
+     */
+    GetFaceLivenessSessionResultsResult getFaceLivenessSessionResults(
+            GetFaceLivenessSessionResultsRequest getFaceLivenessSessionResultsRequest)
+            throws AmazonClientException, AmazonServiceException;
+
     /**
      * <p>
      * Gets the face search results for Amazon Rekognition Video face search
@@ -3020,6 +3095,10 @@ ListFacesResult listFaces(ListFacesRequest listFacesRequest) throws AmazonClient
      * To attach a project policy to a project, call <a>PutProjectPolicy</a>. To
      * remove a project policy from a project, call <a>DeleteProjectPolicy</a>.
      * </p>
+     * <p>
+     * This operation requires permissions to perform the
+     * <code>rekognition:ListProjectPolicies</code> action.
+     * </p>
      * 
      * @param listProjectPoliciesRequest
      * @return listProjectPoliciesResult The response from the
@@ -3131,6 +3210,10 @@ ListTagsForResourceResult listTagsForResource(
      * <p>
      * You copy a model version by calling <a>CopyProjectVersion</a>.
      * </p>
+     * <p>
+     * This operation requires permissions to perform the
+     * <code>rekognition:PutProjectPolicy</code> action.
+     * </p>
      * 
      * @param putProjectPolicyRequest
      * @return putProjectPolicyResult The response from the PutProjectPolicy
@@ -3869,6 +3952,10 @@ StartTextDetectionResult startTextDetection(StartTextDetectionRequest startTextD
      * Stops a running model. The operation might take a while to complete. To
      * check the current status, call <a>DescribeProjectVersions</a>.
      * </p>
+     * <p>
+     * This operation requires permissions to perform the
+     * <code>rekognition:StopProjectVersion</code> action.
+     * </p>
      * 
      * @param stopProjectVersionRequest
      * @return stopProjectVersionResult The response from the StopProjectVersion
@@ -4064,6 +4151,7 @@ UpdateDatasetEntriesResult updateDatasetEntries(
      * @throws InvalidParameterException
      * @throws ResourceNotFoundException
      * @throws ProvisionedThroughputExceededException
+     * @throws ResourceInUseException
      * @throws AmazonClientException If any internal errors are encountered
      *             inside the client while attempting to make the request or
      *             handle the response. For example if a network connection is