aws-sdk-rekognition 1.73.0 → 1.75.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92251b0f044672d1160f7436ab44d156c043c2a438af9b8b150887d9a013fa7d
-  data.tar.gz: f105900aa5b99126639d60d0dd2b08959f5133f2dd1180037143f63a4b9ca63b
+  metadata.gz: 03a15d9fdade83f88daa912b214a1cb18cb45f4a4012ce00fe78caada7e5c66f
+  data.tar.gz: c5eb74c1bf776d04f714f9ca36aff31fc7df143ac430c2da3ea9392c019fc97a
 SHA512:
-  metadata.gz: d2800231e49700ed3309794aee9f209641b25ef95a30d09edf89edd203c364298b7315ae6a1f7736f1264fb4589ad8d96dce5ada003fc2c899def6edcd3d6673
-  data.tar.gz: 7f8267247b5d8cdbc34730ce8d87f1f5c327e791fffe64c7fad5ec0cb43c38bfdb5a4f151ac14c9eb219f76137cdb0f74ebf5726eaf6265f06cddc2d7c993274
+  metadata.gz: e3502bb38c997473f2703bbd0e028a4f2501b624b8bf29ca4307ef1d94d4f7533e015b48e77ba3f1457d5359db03521359974a41a82b3f131f02cc56118da0ad
+  data.tar.gz: 8316c45137c2fdaf4dbf90d0ac785dcf9da5fdd285efed07708755b2e364912754014631ff2fbc03714fb2bebc7a97c7f6e8174600b718ec5161204720d46e49

data/CHANGELOG.md

@@ -1,6 +1,18 @@
 Unreleased Changes
 ------------------
 
+1.75.0 (2023-04-10)
+------------------
+
+* Feature - This release adds support for Face Liveness APIs in Amazon Rekognition. Updates UpdateStreamProcessor to return ResourceInUseException Exception. Minor updates to API documentation.
+
+1.74.0 (2023-01-18)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+* Issue - Replace runtime endpoint resolution approach with generated ruby code.
+
 1.73.0 (2022-12-12)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.73.0
+1.75.0

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

@@ -651,6 +651,9 @@ module Aws::Rekognition
     # in the ProjectVersionDescription object. The copy operation has
     # finished when the value of `Status` is `COPYING_COMPLETED`.
     #
+    # This operation requires permissions to perform the
+    # `rekognition:CopyProjectVersion` action.
+    #
     # @option params [required, String] :source_project_arn
     #   The ARN of the source project in the trusting AWS account.
     #
@@ -897,6 +900,60 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # This API operation initiates a Face Liveness session. It returns a
+    # `SessionId`, which you can use to start streaming Face Liveness video
+    # and get the results for a Face Liveness session. You can use the
+    # `OutputConfig` 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 `AuditImagesLimit` 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.
+    #
+    # @option params [String] :kms_key_id
+    #   The identifier for your AWS Key Management Service key (AWS KMS key).
+    #   Used to encrypt audit images and reference images.
+    #
+    # @option params [Types::CreateFaceLivenessSessionRequestSettings] :settings
+    #   A session settings object. It contains settings for the operation to
+    #   be performed. For Face Liveness, it accepts `OutputConfig` and
+    #   `AuditImagesLimit`.
+    #
+    # @option params [String] :client_request_token
+    #   Idempotent token is used to recognize the Face Liveness request. If
+    #   the same token is used with multiple `CreateFaceLivenessSession`
+    #   requests, the same session is returned. This token is employed to
+    #   avoid unintentionally creating the same session multiple times.
+    #
+    # @return [Types::CreateFaceLivenessSessionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateFaceLivenessSessionResponse#session_id #session_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_face_liveness_session({
+    #     kms_key_id: "KmsKeyId",
+    #     settings: {
+    #       output_config: {
+    #         s3_bucket: "S3Bucket", # required
+    #         s3_key_prefix: "LivenessS3KeyPrefix",
+    #       },
+    #       audit_images_limit: 1,
+    #     },
+    #     client_request_token: "ClientRequestToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.session_id #=> String
+    #
+    # @overload create_face_liveness_session(params = {})
+    # @param [Hash] params ({})
+    def create_face_liveness_session(params = {}, options = {})
+      req = build_request(:create_face_liveness_session, params)
+      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.
@@ -1085,22 +1142,24 @@ module Aws::Rekognition
     #
     # * If you are creating a stream processor for detecting faces, you
     #   provide as input a Kinesis video stream (`Input`) and a Kinesis data
-    #   stream (`Output`) stream. You also specify the face recognition
-    #   criteria in `Settings`. For example, the collection containing faces
-    #   that you want to recognize. After you have finished analyzing a
-    #   streaming video, use StopStreamProcessor to stop processing.
+    #   stream (`Output`) stream for receiving the output. You must use the
+    #   `FaceSearch` option in `Settings`, specifying the collection that
+    #   contains the faces you want to recognize. After you have finished
+    #   analyzing a streaming video, use StopStreamProcessor to stop
+    #   processing.
     #
     # * If you are creating a stream processor to detect labels, you provide
     #   as input a Kinesis video stream (`Input`), Amazon S3 bucket
     #   information (`Output`), and an Amazon SNS topic ARN
     #   (`NotificationChannel`). 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 `ConnectedHomeSettings`, 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
-    #   `RegionsOfInterest`. When you run the StartStreamProcessor operation
-    #   on a label detection stream processor, you input start and stop
-    #   information to determine the length of the processing time.
+    #   want to detect by using the `ConnectedHome` option in settings, and
+    #   selecting one of the following: `PERSON`, `PET`, `PACKAGE`, `ALL`
+    #   You can also specify where in the frame you want Amazon Rekognition
+    #   to monitor with `RegionsOfInterest`. When you run the
+    #   StartStreamProcessor operation on a label detection stream
+    #   processor, you input start and stop information to determine the
+    #   length of the processing time.
     #
     # Use `Name` to assign an identifier for the stream processor. You use
     # `Name` to manage the stream processor. For example, you can start
@@ -1438,6 +1497,9 @@ module Aws::Rekognition
     # ListProjectPolicies. To attach a project policy to a project, call
     # PutProjectPolicy.
     #
+    # This operation requires permissions to perform the
+    # `rekognition:DeleteProjectPolicy` action.
+    #
     # @option params [required, String] :project_arn
     #   The Amazon Resource Name (ARN) of the project that the project policy
     #   you want to delete is attached to.
@@ -2206,7 +2268,7 @@ module Aws::Rekognition
     # **Response Elements**
     #
     # 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:
     #
     # * Name - The name of the detected label.
@@ -2281,8 +2343,7 @@ module Aws::Rekognition
     #
     #  </note>
     #
-    # 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.
     #
     # This operation requires permissions to perform the
     # `rekognition:DetectLabels` action.
@@ -2326,8 +2387,12 @@ module Aws::Rekognition
     #   image properties. Specified filters can be inclusive, exclusive, or a
     #   combination of both. Filters can be used for individual labels or
     #   label categories. The exact label names or label categories must be
-    #   supplied. For a full list of labels and label categories, see LINK
-    #   HERE.
+    #   supplied. For a full list of labels and label categories, see
+    #   [Detecting labels][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/rekognition/latest/dg/labels.html
     #
     # @return [Types::DetectLabelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3247,6 +3312,63 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # Retrieves the results of a specific Face Liveness session. It requires
+    # the `sessionId` as input, which was created using
+    # `CreateFaceLivenessSession`. 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.
+    #
+    # @option params [required, String] :session_id
+    #   A unique 128-bit UUID. This is used to uniquely identify the session
+    #   and also acts as an idempotency token for all operations associated
+    #   with the session.
+    #
+    # @return [Types::GetFaceLivenessSessionResultsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetFaceLivenessSessionResultsResponse#session_id #session_id} => String
+    #   * {Types::GetFaceLivenessSessionResultsResponse#status #status} => String
+    #   * {Types::GetFaceLivenessSessionResultsResponse#confidence #confidence} => Float
+    #   * {Types::GetFaceLivenessSessionResultsResponse#reference_image #reference_image} => Types::AuditImage
+    #   * {Types::GetFaceLivenessSessionResultsResponse#audit_images #audit_images} => Array&lt;Types::AuditImage&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_face_liveness_session_results({
+    #     session_id: "LivenessSessionId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.session_id #=> String
+    #   resp.status #=> String, one of "CREATED", "IN_PROGRESS", "SUCCEEDED", "FAILED"
+    #   resp.confidence #=> Float
+    #   resp.reference_image.bytes #=> String
+    #   resp.reference_image.s3_object.bucket #=> String
+    #   resp.reference_image.s3_object.name #=> String
+    #   resp.reference_image.s3_object.version #=> String
+    #   resp.reference_image.bounding_box.width #=> Float
+    #   resp.reference_image.bounding_box.height #=> Float
+    #   resp.reference_image.bounding_box.left #=> Float
+    #   resp.reference_image.bounding_box.top #=> Float
+    #   resp.audit_images #=> Array
+    #   resp.audit_images[0].bytes #=> String
+    #   resp.audit_images[0].s3_object.bucket #=> String
+    #   resp.audit_images[0].s3_object.name #=> String
+    #   resp.audit_images[0].s3_object.version #=> String
+    #   resp.audit_images[0].bounding_box.width #=> Float
+    #   resp.audit_images[0].bounding_box.height #=> Float
+    #   resp.audit_images[0].bounding_box.left #=> Float
+    #   resp.audit_images[0].bounding_box.top #=> Float
+    #
+    # @overload get_face_liveness_session_results(params = {})
+    # @param [Hash] params ({})
+    def get_face_liveness_session_results(params = {}, options = {})
+      req = build_request(:get_face_liveness_session_results, params)
+      req.send_request(options)
+    end
+
     # Gets the face search results for Amazon Rekognition Video face search
     # started by StartFaceSearch. The search returns faces in a collection
     # that match the faces of persons detected in a video. It also includes
@@ -4769,6 +4891,9 @@ module Aws::Rekognition
     # To attach a project policy to a project, call PutProjectPolicy. To
     # remove a project policy from a project, call DeleteProjectPolicy.
     #
+    # This operation requires permissions to perform the
+    # `rekognition:ListProjectPolicies` action.
+    #
     # @option params [required, String] :project_arn
     #   The ARN of the project for which you want to list the project
     #   policies.
@@ -4937,6 +5062,9 @@ module Aws::Rekognition
     #
     # You copy a model version by calling CopyProjectVersion.
     #
+    # This operation requires permissions to perform the
+    # `rekognition:PutProjectPolicy` action.
+    #
     # @option params [required, String] :project_arn
     #   The Amazon Resource Name (ARN) of the project that the project policy
     #   is attached to.
@@ -6308,6 +6436,9 @@ module Aws::Rekognition
     # Stops a running model. The operation might take a while to complete.
     # To check the current status, call DescribeProjectVersions.
     #
+    # 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.
@@ -6556,7 +6687,7 @@ module Aws::Rekognition
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rekognition'
-      context[:gem_version] = '1.73.0'
+      context[:gem_version] = '1.75.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -21,6 +21,9 @@ module Aws::Rekognition
     Attributes = Shapes::ListShape.new(name: 'Attributes')
     AudioMetadata = Shapes::StructureShape.new(name: 'AudioMetadata')
     AudioMetadataList = Shapes::ListShape.new(name: 'AudioMetadataList')
+    AuditImage = Shapes::StructureShape.new(name: 'AuditImage')
+    AuditImages = Shapes::ListShape.new(name: 'AuditImages')
+    AuditImagesLimit = Shapes::IntegerShape.new(name: 'AuditImagesLimit')
     Beard = Shapes::StructureShape.new(name: 'Beard')
     BlackFrame = Shapes::StructureShape.new(name: 'BlackFrame')
     BodyPart = Shapes::StringShape.new(name: 'BodyPart')
@@ -62,6 +65,9 @@ module Aws::Rekognition
     CreateCollectionResponse = Shapes::StructureShape.new(name: 'CreateCollectionResponse')
     CreateDatasetRequest = Shapes::StructureShape.new(name: 'CreateDatasetRequest')
     CreateDatasetResponse = Shapes::StructureShape.new(name: 'CreateDatasetResponse')
+    CreateFaceLivenessSessionRequest = Shapes::StructureShape.new(name: 'CreateFaceLivenessSessionRequest')
+    CreateFaceLivenessSessionRequestSettings = Shapes::StructureShape.new(name: 'CreateFaceLivenessSessionRequestSettings')
+    CreateFaceLivenessSessionResponse = Shapes::StructureShape.new(name: 'CreateFaceLivenessSessionResponse')
     CreateProjectRequest = Shapes::StructureShape.new(name: 'CreateProjectRequest')
     CreateProjectResponse = Shapes::StructureShape.new(name: 'CreateProjectResponse')
     CreateProjectVersionRequest = Shapes::StructureShape.new(name: 'CreateProjectVersionRequest')
@@ -184,6 +190,8 @@ module Aws::Rekognition
     GetContentModerationResponse = Shapes::StructureShape.new(name: 'GetContentModerationResponse')
     GetFaceDetectionRequest = Shapes::StructureShape.new(name: 'GetFaceDetectionRequest')
     GetFaceDetectionResponse = Shapes::StructureShape.new(name: 'GetFaceDetectionResponse')
+    GetFaceLivenessSessionResultsRequest = Shapes::StructureShape.new(name: 'GetFaceLivenessSessionResultsRequest')
+    GetFaceLivenessSessionResultsResponse = Shapes::StructureShape.new(name: 'GetFaceLivenessSessionResultsResponse')
     GetFaceSearchRequest = Shapes::StructureShape.new(name: 'GetFaceSearchRequest')
     GetFaceSearchResponse = Shapes::StructureShape.new(name: 'GetFaceSearchResponse')
     GetLabelDetectionRequest = Shapes::StructureShape.new(name: 'GetLabelDetectionRequest')
@@ -270,6 +278,11 @@ module Aws::Rekognition
     ListStreamProcessorsResponse = Shapes::StructureShape.new(name: 'ListStreamProcessorsResponse')
     ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest')
     ListTagsForResourceResponse = Shapes::StructureShape.new(name: 'ListTagsForResourceResponse')
+    LivenessImageBlob = Shapes::BlobShape.new(name: 'LivenessImageBlob')
+    LivenessOutputConfig = Shapes::StructureShape.new(name: 'LivenessOutputConfig')
+    LivenessS3KeyPrefix = Shapes::StringShape.new(name: 'LivenessS3KeyPrefix')
+    LivenessSessionId = Shapes::StringShape.new(name: 'LivenessSessionId')
+    LivenessSessionStatus = Shapes::StringShape.new(name: 'LivenessSessionStatus')
     MalformedPolicyDocumentException = Shapes::StructureShape.new(name: 'MalformedPolicyDocumentException')
     MaxDurationInSecondsULong = Shapes::IntegerShape.new(name: 'MaxDurationInSecondsULong')
     MaxFaces = Shapes::IntegerShape.new(name: 'MaxFaces')
@@ -361,6 +374,7 @@ module Aws::Rekognition
     SegmentTypes = Shapes::ListShape.new(name: 'SegmentTypes')
     SegmentTypesInfo = Shapes::ListShape.new(name: 'SegmentTypesInfo')
     ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
+    SessionNotFoundException = Shapes::StructureShape.new(name: 'SessionNotFoundException')
     ShotSegment = Shapes::StructureShape.new(name: 'ShotSegment')
     Smile = Shapes::StructureShape.new(name: 'Smile')
     StartCelebrityRecognitionRequest = Shapes::StructureShape.new(name: 'StartCelebrityRecognitionRequest')
@@ -474,6 +488,13 @@ module Aws::Rekognition
 
     AudioMetadataList.member = Shapes::ShapeRef.new(shape: AudioMetadata)
 
+    AuditImage.add_member(:bytes, Shapes::ShapeRef.new(shape: LivenessImageBlob, location_name: "Bytes"))
+    AuditImage.add_member(:s3_object, Shapes::ShapeRef.new(shape: S3Object, location_name: "S3Object"))
+    AuditImage.add_member(:bounding_box, Shapes::ShapeRef.new(shape: BoundingBox, location_name: "BoundingBox"))
+    AuditImage.struct_class = Types::AuditImage
+
+    AuditImages.member = Shapes::ShapeRef.new(shape: AuditImage)
+
     Beard.add_member(:value, Shapes::ShapeRef.new(shape: Boolean, location_name: "Value"))
     Beard.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
     Beard.struct_class = Types::Beard
@@ -604,6 +625,18 @@ module Aws::Rekognition
     CreateDatasetResponse.add_member(:dataset_arn, Shapes::ShapeRef.new(shape: DatasetArn, location_name: "DatasetArn"))
     CreateDatasetResponse.struct_class = Types::CreateDatasetResponse
 
+    CreateFaceLivenessSessionRequest.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: KmsKeyId, location_name: "KmsKeyId"))
+    CreateFaceLivenessSessionRequest.add_member(:settings, Shapes::ShapeRef.new(shape: CreateFaceLivenessSessionRequestSettings, location_name: "Settings"))
+    CreateFaceLivenessSessionRequest.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
+    CreateFaceLivenessSessionRequest.struct_class = Types::CreateFaceLivenessSessionRequest
+
+    CreateFaceLivenessSessionRequestSettings.add_member(:output_config, Shapes::ShapeRef.new(shape: LivenessOutputConfig, location_name: "OutputConfig"))
+    CreateFaceLivenessSessionRequestSettings.add_member(:audit_images_limit, Shapes::ShapeRef.new(shape: AuditImagesLimit, location_name: "AuditImagesLimit"))
+    CreateFaceLivenessSessionRequestSettings.struct_class = Types::CreateFaceLivenessSessionRequestSettings
+
+    CreateFaceLivenessSessionResponse.add_member(:session_id, Shapes::ShapeRef.new(shape: LivenessSessionId, required: true, location_name: "SessionId"))
+    CreateFaceLivenessSessionResponse.struct_class = Types::CreateFaceLivenessSessionResponse
+
     CreateProjectRequest.add_member(:project_name, Shapes::ShapeRef.new(shape: ProjectName, required: true, location_name: "ProjectName"))
     CreateProjectRequest.struct_class = Types::CreateProjectRequest
 
@@ -1043,6 +1076,16 @@ module Aws::Rekognition
     GetFaceDetectionResponse.add_member(:faces, Shapes::ShapeRef.new(shape: FaceDetections, location_name: "Faces"))
     GetFaceDetectionResponse.struct_class = Types::GetFaceDetectionResponse
 
+    GetFaceLivenessSessionResultsRequest.add_member(:session_id, Shapes::ShapeRef.new(shape: LivenessSessionId, required: true, location_name: "SessionId"))
+    GetFaceLivenessSessionResultsRequest.struct_class = Types::GetFaceLivenessSessionResultsRequest
+
+    GetFaceLivenessSessionResultsResponse.add_member(:session_id, Shapes::ShapeRef.new(shape: LivenessSessionId, required: true, location_name: "SessionId"))
+    GetFaceLivenessSessionResultsResponse.add_member(:status, Shapes::ShapeRef.new(shape: LivenessSessionStatus, required: true, location_name: "Status"))
+    GetFaceLivenessSessionResultsResponse.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
+    GetFaceLivenessSessionResultsResponse.add_member(:reference_image, Shapes::ShapeRef.new(shape: AuditImage, location_name: "ReferenceImage"))
+    GetFaceLivenessSessionResultsResponse.add_member(:audit_images, Shapes::ShapeRef.new(shape: AuditImages, location_name: "AuditImages"))
+    GetFaceLivenessSessionResultsResponse.struct_class = Types::GetFaceLivenessSessionResultsResponse
+
     GetFaceSearchRequest.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, required: true, location_name: "JobId"))
     GetFaceSearchRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
     GetFaceSearchRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
@@ -1299,6 +1342,10 @@ module Aws::Rekognition
     ListTagsForResourceResponse.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
     ListTagsForResourceResponse.struct_class = Types::ListTagsForResourceResponse
 
+    LivenessOutputConfig.add_member(:s3_bucket, Shapes::ShapeRef.new(shape: S3Bucket, required: true, location_name: "S3Bucket"))
+    LivenessOutputConfig.add_member(:s3_key_prefix, Shapes::ShapeRef.new(shape: LivenessS3KeyPrefix, location_name: "S3KeyPrefix"))
+    LivenessOutputConfig.struct_class = Types::LivenessOutputConfig
+
     MalformedPolicyDocumentException.struct_class = Types::MalformedPolicyDocumentException
 
     ModerationLabel.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
@@ -1517,6 +1564,8 @@ module Aws::Rekognition
 
     ServiceQuotaExceededException.struct_class = Types::ServiceQuotaExceededException
 
+    SessionNotFoundException.struct_class = Types::SessionNotFoundException
+
     ShotSegment.add_member(:index, Shapes::ShapeRef.new(shape: ULong, location_name: "Index"))
     ShotSegment.add_member(:confidence, Shapes::ShapeRef.new(shape: SegmentConfidence, location_name: "Confidence"))
     ShotSegment.struct_class = Types::ShotSegment
@@ -1873,6 +1922,19 @@ module Aws::Rekognition
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
 
+      api.add_operation(:create_face_liveness_session, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "CreateFaceLivenessSession"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: CreateFaceLivenessSessionRequest)
+        o.output = Shapes::ShapeRef.new(shape: CreateFaceLivenessSessionResponse)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ProvisionedThroughputExceededException)
+      end)
+
       api.add_operation(:create_project, Seahorse::Model::Operation.new.tap do |o|
         o.name = "CreateProject"
         o.http_method = "POST"
@@ -2300,6 +2362,20 @@ module Aws::Rekognition
         )
       end)
 
+      api.add_operation(:get_face_liveness_session_results, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetFaceLivenessSessionResults"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetFaceLivenessSessionResultsRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetFaceLivenessSessionResultsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: SessionNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ProvisionedThroughputExceededException)
+      end)
+
       api.add_operation(:get_face_search, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetFaceSearch"
         o.http_method = "POST"
@@ -2888,6 +2964,7 @@ module Aws::Rekognition
         o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: ProvisionedThroughputExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
       end)
     end
 

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

@@ -50,9 +50,6 @@ module Aws::Rekognition
 
     def initialize(options = {})
       self[:region] = options[:region]
-      if self[:region].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :region"
-      end
       self[:use_dual_stack] = options[:use_dual_stack]
       self[:use_dual_stack] = false if self[:use_dual_stack].nil?
       if self[:use_dual_stack].nil?

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

@@ -9,130 +9,46 @@
 
 module Aws::Rekognition
   class EndpointProvider
-    def initialize(rule_set = nil)
-      @@rule_set ||= begin
-        endpoint_rules = Aws::Json.load(Base64.decode64(RULES))
-        Aws::Endpoints::RuleSet.new(
-          version: endpoint_rules['version'],
-          service_id: endpoint_rules['serviceId'],
-          parameters: endpoint_rules['parameters'],
-          rules: endpoint_rules['rules']
-        )
+    def resolve_endpoint(parameters)
+      region = parameters.region
+      use_dual_stack = parameters.use_dual_stack
+      use_fips = parameters.use_fips
+      endpoint = parameters.endpoint
+      if Aws::Endpoints::Matchers.set?(endpoint)
+        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+          raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
+        end
+        if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+          raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+        end
+        return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
       end
-      @provider = Aws::Endpoints::RulesProvider.new(rule_set || @@rule_set)
-    end
+      if Aws::Endpoints::Matchers.set?(region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://rekognition-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+              return Aws::Endpoints::Endpoint.new(url: "https://rekognition-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://rekognition.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
+          end
+          return Aws::Endpoints::Endpoint.new(url: "https://rekognition.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+        end
+      end
+      raise ArgumentError, "Invalid Configuration: Missing Region"
+      raise ArgumentError, 'No endpoint could be resolved'
 
-    def resolve_endpoint(parameters)
-      @provider.resolve_endpoint(parameters)
     end
-
-    # @api private
-    RULES = <<-JSON
-eyJ2ZXJzaW9uIjoiMS4wIiwicGFyYW1ldGVycyI6eyJSZWdpb24iOnsiYnVp
-bHRJbiI6IkFXUzo6UmVnaW9uIiwicmVxdWlyZWQiOnRydWUsImRvY3VtZW50
-YXRpb24iOiJUaGUgQVdTIHJlZ2lvbiB1c2VkIHRvIGRpc3BhdGNoIHRoZSBy
-ZXF1ZXN0LiIsInR5cGUiOiJTdHJpbmcifSwiVXNlRHVhbFN0YWNrIjp7ImJ1
-aWx0SW4iOiJBV1M6OlVzZUR1YWxTdGFjayIsInJlcXVpcmVkIjp0cnVlLCJk
-ZWZhdWx0IjpmYWxzZSwiZG9jdW1lbnRhdGlvbiI6IldoZW4gdHJ1ZSwgdXNl
-IHRoZSBkdWFsLXN0YWNrIGVuZHBvaW50LiBJZiB0aGUgY29uZmlndXJlZCBl
-bmRwb2ludCBkb2VzIG5vdCBzdXBwb3J0IGR1YWwtc3RhY2ssIGRpc3BhdGNo
-aW5nIHRoZSByZXF1ZXN0IE1BWSByZXR1cm4gYW4gZXJyb3IuIiwidHlwZSI6
-IkJvb2xlYW4ifSwiVXNlRklQUyI6eyJidWlsdEluIjoiQVdTOjpVc2VGSVBT
-IiwicmVxdWlyZWQiOnRydWUsImRlZmF1bHQiOmZhbHNlLCJkb2N1bWVudGF0
-aW9uIjoiV2hlbiB0cnVlLCBzZW5kIHRoaXMgcmVxdWVzdCB0byB0aGUgRklQ
-Uy1jb21wbGlhbnQgcmVnaW9uYWwgZW5kcG9pbnQuIElmIHRoZSBjb25maWd1
-cmVkIGVuZHBvaW50IGRvZXMgbm90IGhhdmUgYSBGSVBTIGNvbXBsaWFudCBl
-bmRwb2ludCwgZGlzcGF0Y2hpbmcgdGhlIHJlcXVlc3Qgd2lsbCByZXR1cm4g
-YW4gZXJyb3IuIiwidHlwZSI6IkJvb2xlYW4ifSwiRW5kcG9pbnQiOnsiYnVp
-bHRJbiI6IlNESzo6RW5kcG9pbnQiLCJyZXF1aXJlZCI6ZmFsc2UsImRvY3Vt
-ZW50YXRpb24iOiJPdmVycmlkZSB0aGUgZW5kcG9pbnQgdXNlZCB0byBzZW5k
-IHRoaXMgcmVxdWVzdCIsInR5cGUiOiJTdHJpbmcifX0sInJ1bGVzIjpbeyJj
-b25kaXRpb25zIjpbeyJmbiI6ImF3cy5wYXJ0aXRpb24iLCJhcmd2IjpbeyJy
-ZWYiOiJSZWdpb24ifV0sImFzc2lnbiI6IlBhcnRpdGlvblJlc3VsdCJ9XSwi
-dHlwZSI6InRyZWUiLCJydWxlcyI6W3siY29uZGl0aW9ucyI6W3siZm4iOiJp
-c1NldCIsImFyZ3YiOlt7InJlZiI6IkVuZHBvaW50In1dfV0sInR5cGUiOiJ0
-cmVlIiwicnVsZXMiOlt7ImNvbmRpdGlvbnMiOlt7ImZuIjoiYm9vbGVhbkVx
-dWFscyIsImFyZ3YiOlt7InJlZiI6IlVzZUZJUFMifSx0cnVlXX1dLCJlcnJv
-ciI6IkludmFsaWQgQ29uZmlndXJhdGlvbjogRklQUyBhbmQgY3VzdG9tIGVu
-ZHBvaW50IGFyZSBub3Qgc3VwcG9ydGVkIiwidHlwZSI6ImVycm9yIn0seyJj
-b25kaXRpb25zIjpbXSwidHlwZSI6InRyZWUiLCJydWxlcyI6W3siY29uZGl0
-aW9ucyI6W3siZm4iOiJib29sZWFuRXF1YWxzIiwiYXJndiI6W3sicmVmIjoi
-VXNlRHVhbFN0YWNrIn0sdHJ1ZV19XSwiZXJyb3IiOiJJbnZhbGlkIENvbmZp
-Z3VyYXRpb246IER1YWxzdGFjayBhbmQgY3VzdG9tIGVuZHBvaW50IGFyZSBu
-b3Qgc3VwcG9ydGVkIiwidHlwZSI6ImVycm9yIn0seyJjb25kaXRpb25zIjpb
-XSwiZW5kcG9pbnQiOnsidXJsIjp7InJlZiI6IkVuZHBvaW50In0sInByb3Bl
-cnRpZXMiOnt9LCJoZWFkZXJzIjp7fX0sInR5cGUiOiJlbmRwb2ludCJ9XX1d
-fSx7ImNvbmRpdGlvbnMiOlt7ImZuIjoiYm9vbGVhbkVxdWFscyIsImFyZ3Yi
-Olt7InJlZiI6IlVzZUZJUFMifSx0cnVlXX0seyJmbiI6ImJvb2xlYW5FcXVh
-bHMiLCJhcmd2IjpbeyJyZWYiOiJVc2VEdWFsU3RhY2sifSx0cnVlXX1dLCJ0
-eXBlIjoidHJlZSIsInJ1bGVzIjpbeyJjb25kaXRpb25zIjpbeyJmbiI6ImJv
-b2xlYW5FcXVhbHMiLCJhcmd2IjpbdHJ1ZSx7ImZuIjoiZ2V0QXR0ciIsImFy
-Z3YiOlt7InJlZiI6IlBhcnRpdGlvblJlc3VsdCJ9LCJzdXBwb3J0c0ZJUFMi
-XX1dfSx7ImZuIjoiYm9vbGVhbkVxdWFscyIsImFyZ3YiOlt0cnVlLHsiZm4i
-OiJnZXRBdHRyIiwiYXJndiI6W3sicmVmIjoiUGFydGl0aW9uUmVzdWx0In0s
-InN1cHBvcnRzRHVhbFN0YWNrIl19XX1dLCJ0eXBlIjoidHJlZSIsInJ1bGVz
-IjpbeyJjb25kaXRpb25zIjpbXSwiZW5kcG9pbnQiOnsidXJsIjoiaHR0cHM6
-Ly9yZWtvZ25pdGlvbi1maXBzLntSZWdpb259LntQYXJ0aXRpb25SZXN1bHQj
-ZHVhbFN0YWNrRG5zU3VmZml4fSIsInByb3BlcnRpZXMiOnt9LCJoZWFkZXJz
-Ijp7fX0sInR5cGUiOiJlbmRwb2ludCJ9XX0seyJjb25kaXRpb25zIjpbXSwi
-ZXJyb3IiOiJGSVBTIGFuZCBEdWFsU3RhY2sgYXJlIGVuYWJsZWQsIGJ1dCB0
-aGlzIHBhcnRpdGlvbiBkb2VzIG5vdCBzdXBwb3J0IG9uZSBvciBib3RoIiwi
-dHlwZSI6ImVycm9yIn1dfSx7ImNvbmRpdGlvbnMiOlt7ImZuIjoiYm9vbGVh
-bkVxdWFscyIsImFyZ3YiOlt7InJlZiI6IlVzZUZJUFMifSx0cnVlXX1dLCJ0
-eXBlIjoidHJlZSIsInJ1bGVzIjpbeyJjb25kaXRpb25zIjpbeyJmbiI6ImJv
-b2xlYW5FcXVhbHMiLCJhcmd2IjpbdHJ1ZSx7ImZuIjoiZ2V0QXR0ciIsImFy
-Z3YiOlt7InJlZiI6IlBhcnRpdGlvblJlc3VsdCJ9LCJzdXBwb3J0c0ZJUFMi
-XX1dfV0sInR5cGUiOiJ0cmVlIiwicnVsZXMiOlt7ImNvbmRpdGlvbnMiOltd
-LCJ0eXBlIjoidHJlZSIsInJ1bGVzIjpbeyJjb25kaXRpb25zIjpbeyJmbiI6
-InN0cmluZ0VxdWFscyIsImFyZ3YiOlt7InJlZiI6IlJlZ2lvbiJ9LCJyZWtv
-Z25pdGlvbi5jYS1jZW50cmFsLTEiXX1dLCJlbmRwb2ludCI6eyJ1cmwiOiJo
-dHRwczovL3Jla29nbml0aW9uLWZpcHMuY2EtY2VudHJhbC0xLmFtYXpvbmF3
-cy5jb20iLCJwcm9wZXJ0aWVzIjp7fSwiaGVhZGVycyI6e319LCJ0eXBlIjoi
-ZW5kcG9pbnQifSx7ImNvbmRpdGlvbnMiOlt7ImZuIjoic3RyaW5nRXF1YWxz
-IiwiYXJndiI6W3sicmVmIjoiUmVnaW9uIn0sInJla29nbml0aW9uLnVzLWVh
-c3QtMSJdfV0sImVuZHBvaW50Ijp7InVybCI6Imh0dHBzOi8vcmVrb2duaXRp
-b24tZmlwcy51cy1lYXN0LTEuYW1hem9uYXdzLmNvbSIsInByb3BlcnRpZXMi
-Ont9LCJoZWFkZXJzIjp7fX0sInR5cGUiOiJlbmRwb2ludCJ9LHsiY29uZGl0
-aW9ucyI6W3siZm4iOiJzdHJpbmdFcXVhbHMiLCJhcmd2IjpbeyJyZWYiOiJS
-ZWdpb24ifSwicmVrb2duaXRpb24udXMtZWFzdC0yIl19XSwiZW5kcG9pbnQi
-OnsidXJsIjoiaHR0cHM6Ly9yZWtvZ25pdGlvbi1maXBzLnVzLWVhc3QtMi5h
-bWF6b25hd3MuY29tIiwicHJvcGVydGllcyI6e30sImhlYWRlcnMiOnt9fSwi
-dHlwZSI6ImVuZHBvaW50In0seyJjb25kaXRpb25zIjpbeyJmbiI6InN0cmlu
-Z0VxdWFscyIsImFyZ3YiOlt7InJlZiI6IlJlZ2lvbiJ9LCJyZWtvZ25pdGlv
-bi51cy13ZXN0LTEiXX1dLCJlbmRwb2ludCI6eyJ1cmwiOiJodHRwczovL3Jl
-a29nbml0aW9uLWZpcHMudXMtd2VzdC0xLmFtYXpvbmF3cy5jb20iLCJwcm9w
-ZXJ0aWVzIjp7fSwiaGVhZGVycyI6e319LCJ0eXBlIjoiZW5kcG9pbnQifSx7
-ImNvbmRpdGlvbnMiOlt7ImZuIjoic3RyaW5nRXF1YWxzIiwiYXJndiI6W3si
-cmVmIjoiUmVnaW9uIn0sInJla29nbml0aW9uLnVzLXdlc3QtMiJdfV0sImVu
-ZHBvaW50Ijp7InVybCI6Imh0dHBzOi8vcmVrb2duaXRpb24tZmlwcy51cy13
-ZXN0LTIuYW1hem9uYXdzLmNvbSIsInByb3BlcnRpZXMiOnt9LCJoZWFkZXJz
-Ijp7fX0sInR5cGUiOiJlbmRwb2ludCJ9LHsiY29uZGl0aW9ucyI6W3siZm4i
-OiJzdHJpbmdFcXVhbHMiLCJhcmd2IjpbeyJyZWYiOiJSZWdpb24ifSwicmVr
-b2duaXRpb24udXMtZ292LXdlc3QtMSJdfV0sImVuZHBvaW50Ijp7InVybCI6
-Imh0dHBzOi8vcmVrb2duaXRpb24tZmlwcy51cy1nb3Ytd2VzdC0xLmFtYXpv
-bmF3cy5jb20iLCJwcm9wZXJ0aWVzIjp7fSwiaGVhZGVycyI6e319LCJ0eXBl
-IjoiZW5kcG9pbnQifSx7ImNvbmRpdGlvbnMiOltdLCJlbmRwb2ludCI6eyJ1
-cmwiOiJodHRwczovL3Jla29nbml0aW9uLWZpcHMue1JlZ2lvbn0ue1BhcnRp
-dGlvblJlc3VsdCNkbnNTdWZmaXh9IiwicHJvcGVydGllcyI6e30sImhlYWRl
-cnMiOnt9fSwidHlwZSI6ImVuZHBvaW50In1dfV19LHsiY29uZGl0aW9ucyI6
-W10sImVycm9yIjoiRklQUyBpcyBlbmFibGVkIGJ1dCB0aGlzIHBhcnRpdGlv
-biBkb2VzIG5vdCBzdXBwb3J0IEZJUFMiLCJ0eXBlIjoiZXJyb3IifV19LHsi
-Y29uZGl0aW9ucyI6W3siZm4iOiJib29sZWFuRXF1YWxzIiwiYXJndiI6W3si
-cmVmIjoiVXNlRHVhbFN0YWNrIn0sdHJ1ZV19XSwidHlwZSI6InRyZWUiLCJy
-dWxlcyI6W3siY29uZGl0aW9ucyI6W3siZm4iOiJib29sZWFuRXF1YWxzIiwi
-YXJndiI6W3RydWUseyJmbiI6ImdldEF0dHIiLCJhcmd2IjpbeyJyZWYiOiJQ
-YXJ0aXRpb25SZXN1bHQifSwic3VwcG9ydHNEdWFsU3RhY2siXX1dfV0sInR5
-cGUiOiJ0cmVlIiwicnVsZXMiOlt7ImNvbmRpdGlvbnMiOltdLCJlbmRwb2lu
-dCI6eyJ1cmwiOiJodHRwczovL3Jla29nbml0aW9uLntSZWdpb259LntQYXJ0
-aXRpb25SZXN1bHQjZHVhbFN0YWNrRG5zU3VmZml4fSIsInByb3BlcnRpZXMi
-Ont9LCJoZWFkZXJzIjp7fX0sInR5cGUiOiJlbmRwb2ludCJ9XX0seyJjb25k
-aXRpb25zIjpbXSwiZXJyb3IiOiJEdWFsU3RhY2sgaXMgZW5hYmxlZCBidXQg
-dGhpcyBwYXJ0aXRpb24gZG9lcyBub3Qgc3VwcG9ydCBEdWFsU3RhY2siLCJ0
-eXBlIjoiZXJyb3IifV19LHsiY29uZGl0aW9ucyI6W10sImVuZHBvaW50Ijp7
-InVybCI6Imh0dHBzOi8vcmVrb2duaXRpb24ue1JlZ2lvbn0ue1BhcnRpdGlv
-blJlc3VsdCNkbnNTdWZmaXh9IiwicHJvcGVydGllcyI6e30sImhlYWRlcnMi
-Ont9fSwidHlwZSI6ImVuZHBvaW50In1dfV19
-
-    JSON
   end
 end

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

@@ -67,6 +67,20 @@ module Aws::Rekognition
       end
     end
 
+    class CreateFaceLivenessSession
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::Rekognition::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class CreateProject
       def self.build(context)
         unless context.config.regional_endpoint
@@ -431,6 +445,20 @@ module Aws::Rekognition
       end
     end
 
+    class GetFaceLivenessSessionResults
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::Rekognition::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class GetFaceSearch
       def self.build(context)
         unless context.config.regional_endpoint

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

@@ -45,6 +45,7 @@ module Aws::Rekognition
   # * {ResourceNotFoundException}
   # * {ResourceNotReadyException}
   # * {ServiceQuotaExceededException}
+  # * {SessionNotFoundException}
   # * {ThrottlingException}
   # * {VideoTooLargeException}
   #
@@ -249,6 +250,16 @@ module Aws::Rekognition
       end
     end
 
+    class SessionNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::Rekognition::Types::SessionNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
     class ThrottlingException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

data/lib/aws-sdk-rekognition/plugins/endpoints.rb

@@ -64,6 +64,8 @@ module Aws::Rekognition
             Aws::Rekognition::Endpoints::CreateCollection.build(context)
           when :create_dataset
             Aws::Rekognition::Endpoints::CreateDataset.build(context)
+          when :create_face_liveness_session
+            Aws::Rekognition::Endpoints::CreateFaceLivenessSession.build(context)
           when :create_project
             Aws::Rekognition::Endpoints::CreateProject.build(context)
           when :create_project_version
@@ -116,6 +118,8 @@ module Aws::Rekognition
             Aws::Rekognition::Endpoints::GetContentModeration.build(context)
           when :get_face_detection
             Aws::Rekognition::Endpoints::GetFaceDetection.build(context)
+          when :get_face_liveness_session_results
+            Aws::Rekognition::Endpoints::GetFaceLivenessSessionResults.build(context)
           when :get_face_search
             Aws::Rekognition::Endpoints::GetFaceSearch.build(context)
           when :get_label_detection

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

@@ -80,6 +80,62 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
+    # An image that is picked from the Face Liveness video and returned for
+    # audit trail purposes, returned as Base64-encoded bytes.
+    #
+    # @!attribute [rw] bytes
+    #   The Base64-encoded bytes representing an image selected from the
+    #   Face Liveness video and returned for audit purposes.
+    #   @return [String]
+    #
+    # @!attribute [rw] s3_object
+    #   Provides the S3 bucket name and object name.
+    #
+    #   The region for the S3 bucket containing the S3 object must match the
+    #   region you use for Amazon Rekognition operations.
+    #
+    #   For Amazon Rekognition to process an S3 object, the user must have
+    #   permission to access the S3 object. For more information, see How
+    #   Amazon Rekognition works with IAM in the Amazon Rekognition
+    #   Developer Guide.
+    #   @return [Types::S3Object]
+    #
+    # @!attribute [rw] bounding_box
+    #   Identifies the bounding box around the label, face, text, object of
+    #   interest, or personal protective equipment. The `left`
+    #   (x-coordinate) and `top` (y-coordinate) are coordinates representing
+    #   the top and left sides of the bounding box. Note that the upper-left
+    #   corner of the image is the origin (0,0).
+    #
+    #   The `top` and `left` values returned are ratios of the overall image
+    #   size. For example, if the input image is 700x200 pixels, and the
+    #   top-left coordinate of the bounding box is 350x50 pixels, the API
+    #   returns a `left` value of 0.5 (350/700) and a `top` value of 0.25
+    #   (50/200).
+    #
+    #   The `width` and `height` values represent the dimensions of the
+    #   bounding box as a ratio of the overall image dimension. For example,
+    #   if the input image is 700x200 pixels, and the bounding box width is
+    #   70 pixels, the width returned is 0.1.
+    #
+    #   <note markdown="1"> The bounding box coordinates can have negative values. For example,
+    #   if Amazon Rekognition is able to detect a face that is at the image
+    #   edge and is only partially visible, the service can return
+    #   coordinates that are outside the image bounds and, depending on the
+    #   image edge, you might get negative values or values greater than 1
+    #   for the `left` or `top` values.
+    #
+    #    </note>
+    #   @return [Types::BoundingBox]
+    #
+    class AuditImage < Struct.new(
+      :bytes,
+      :s3_object,
+      :bounding_box)
+      SENSITIVE = [:bytes]
+      include Aws::Structure
+    end
+
     # Indicates whether or not the face has a beard, and the confidence
     # level in the determination.
     #
@@ -742,6 +798,69 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
+    # @!attribute [rw] kms_key_id
+    #   The identifier for your AWS Key Management Service key (AWS KMS
+    #   key). Used to encrypt audit images and reference images.
+    #   @return [String]
+    #
+    # @!attribute [rw] settings
+    #   A session settings object. It contains settings for the operation to
+    #   be performed. For Face Liveness, it accepts `OutputConfig` and
+    #   `AuditImagesLimit`.
+    #   @return [Types::CreateFaceLivenessSessionRequestSettings]
+    #
+    # @!attribute [rw] client_request_token
+    #   Idempotent token is used to recognize the Face Liveness request. If
+    #   the same token is used with multiple `CreateFaceLivenessSession`
+    #   requests, the same session is returned. This token is employed to
+    #   avoid unintentionally creating the same session multiple times.
+    #   @return [String]
+    #
+    class CreateFaceLivenessSessionRequest < Struct.new(
+      :kms_key_id,
+      :settings,
+      :client_request_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A session settings object. It contains settings for the operation to
+    # be performed. It accepts arguments for OutputConfig and
+    # AuditImagesLimit.
+    #
+    # @!attribute [rw] output_config
+    #   Can specify the location of an Amazon S3 bucket, where reference and
+    #   audit images will be stored. Note that the Amazon S3 bucket must be
+    #   located in the caller's AWS account and in the same region as the
+    #   Face Liveness end-point. Additionally, the Amazon S3 object keys are
+    #   auto-generated by the Face Liveness system.
+    #   @return [Types::LivenessOutputConfig]
+    #
+    # @!attribute [rw] audit_images_limit
+    #   Number of audit images to be returned back. Takes an integer between
+    #   0-4. Any integer less than 0 will return 0, any integer above 4 will
+    #   return 4 images in the response. By default, it is set to 0. The
+    #   limit is best effort and is based on the actual duration of the
+    #   selfie-video.
+    #   @return [Integer]
+    #
+    class CreateFaceLivenessSessionRequestSettings < Struct.new(
+      :output_config,
+      :audit_images_limit)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] session_id
+    #   A unique 128-bit UUID identifying a Face Liveness session.
+    #   @return [String]
+    #
+    class CreateFaceLivenessSessionResponse < Struct.new(
+      :session_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] project_name
     #   The name of the project to create.
     #   @return [String]
@@ -1888,8 +2007,12 @@ module Aws::Rekognition
     #   image properties. Specified filters can be inclusive, exclusive, or
     #   a combination of both. Filters can be used for individual labels or
     #   label categories. The exact label names or label categories must be
-    #   supplied. For a full list of labels and label categories, see LINK
-    #   HERE.
+    #   supplied. For a full list of labels and label categories, see
+    #   [Detecting labels][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/rekognition/latest/dg/labels.html
     #   @return [Types::DetectLabelsSettings]
     #
     class DetectLabelsRequest < Struct.new(
@@ -2608,7 +2731,12 @@ module Aws::Rekognition
 
     # Contains filters for the object labels returned by DetectLabels.
     # Filters can be inclusive, exclusive, or a combination of both and can
-    # be applied to individual l abels or entire label categories.
+    # be applied to individual labels or entire label categories. To see a
+    # list of label categories, see [Detecting Labels][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/rekognition/latest/dg/labels.html
     #
     # @!attribute [rw] label_inclusion_filters
     #   The labels that should be included in the return from DetectLabels.
@@ -2903,6 +3031,62 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
+    # @!attribute [rw] session_id
+    #   A unique 128-bit UUID. This is used to uniquely identify the session
+    #   and also acts as an idempotency token for all operations associated
+    #   with the session.
+    #   @return [String]
+    #
+    class GetFaceLivenessSessionResultsRequest < Struct.new(
+      :session_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] session_id
+    #   The sessionId for which this request was called.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   Represents a status corresponding to the state of the session.
+    #   Possible statuses are: CREATED, IN\_PROGRESS, SUCCEEDED, FAILED,
+    #   EXPIRED.
+    #   @return [String]
+    #
+    # @!attribute [rw] confidence
+    #   Probabalistic confidence score for if the person in the given video
+    #   was live, represented as a float value between 0 to 100.
+    #   @return [Float]
+    #
+    # @!attribute [rw] reference_image
+    #   A high-quality image from the Face Liveness video that can be used
+    #   for face comparison or search. It includes a bounding box of the
+    #   face and the Base64-encoded bytes that return an image. If the
+    #   CreateFaceLivenessSession request included an OutputConfig argument,
+    #   the image will be uploaded to an S3Object specified in the output
+    #   configuration. In case the reference image is not returned, it's
+    #   recommended to retry the Liveness check.
+    #   @return [Types::AuditImage]
+    #
+    # @!attribute [rw] audit_images
+    #   A set of images from the Face Liveness video that can be used for
+    #   audit purposes. It includes a bounding box of the face and the
+    #   Base64-encoded bytes that return an image. If the
+    #   CreateFaceLivenessSession request included an OutputConfig argument,
+    #   the image will be uploaded to an S3Object specified in the output
+    #   configuration.
+    #   @return [Array<Types::AuditImage>]
+    #
+    class GetFaceLivenessSessionResultsResponse < Struct.new(
+      :session_id,
+      :status,
+      :confidence,
+      :reference_image,
+      :audit_images)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] job_id
     #   The job identifer for the search request. You get the job identifier
     #   from an initial call to `StartFaceSearch`.
@@ -3439,7 +3623,8 @@ module Aws::Rekognition
     # Guide.
     #
     # @!attribute [rw] bytes
-    #   Blob of image bytes up to 5 MBs.
+    #   Blob of image bytes up to 5 MBs. Note that the maximum image size
+    #   you can pass to `DetectCustomLabels` is 4MB.
     #   @return [String]
     #
     # @!attribute [rw] s3_object
@@ -3851,7 +4036,12 @@ module Aws::Rekognition
     # @!attribute [rw] general_labels
     #   Contains filters for the object labels returned by DetectLabels.
     #   Filters can be inclusive, exclusive, or a combination of both and
-    #   can be applied to individual l abels or entire label categories.
+    #   can be applied to individual labels or entire label categories. To
+    #   see a list of label categories, see [Detecting Labels][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/rekognition/latest/dg/labels.html
     #   @return [Types::GeneralLabelsSettings]
     #
     class LabelDetectionSettings < Struct.new(
@@ -4203,6 +4393,29 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
+    # Contains settings that specify the location of an Amazon S3 bucket
+    # used to store the output of a Face Liveness session. Note that the S3
+    # bucket must be located in the caller's AWS account and in the same
+    # region as the Face Liveness end-point. Additionally, the Amazon S3
+    # object keys are auto-generated by the Face Liveness system.
+    #
+    # @!attribute [rw] s3_bucket
+    #   The path to an AWS Amazon S3 bucket used to store Face Liveness
+    #   session results.
+    #   @return [String]
+    #
+    # @!attribute [rw] s3_key_prefix
+    #   The prefix appended to the output files for the Face Liveness
+    #   session results.
+    #   @return [String]
+    #
+    class LivenessOutputConfig < Struct.new(
+      :s3_bucket,
+      :s3_key_prefix)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The format of the project policy document that you supplied to
     # `PutProjectPolicy` is incorrect.
     #
@@ -5225,6 +5438,10 @@ module Aws::Rekognition
     #
     class ServiceQuotaExceededException < Aws::EmptyStructure; end
 
+    # Occurs when a given sessionId is not found.
+    #
+    class SessionNotFoundException < Aws::EmptyStructure; end
+
     # Information about a shot detection segment detected in a video. For
     # more information, see SegmentDetection.
     #

data/lib/aws-sdk-rekognition.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-rekognition/customizations'
 # @!group service
 module Aws::Rekognition
 
-  GEM_VERSION = '1.73.0'
+  GEM_VERSION = '1.75.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-rekognition
 version: !ruby/object:Gem::Version
-  version: 1.73.0
+  version: 1.75.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-12-12 00:00:00.000000000 Z
+date: 2023-04-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core