/* * 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. * A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either * express or implied. See the License for the specific language governing * permissions and limitations under the License. */ package com.amazonaws.services.rekognition.model; import java.io.Serializable; import com.amazonaws.AmazonWebServiceRequest; /** *
* 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 the number
* 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.
*
* The identifier for your AWS Key Management Service key (AWS KMS key). * Used to encrypt audit images and reference images. *
*
* Constraints:
* Length: 1 - 2048
* Pattern: ^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$
*/
private String kmsKeyId;
/**
*
* A session settings object. It contains settings for the operation to be
* performed. For Face Liveness, it accepts OutputConfig
and
* AuditImagesLimit
.
*
* 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.
*
* Constraints:
* Length: 1 - 64
* Pattern: ^[a-zA-Z0-9-_]+$
*/
private String clientRequestToken;
/**
*
* The identifier for your AWS Key Management Service key (AWS KMS key). * Used to encrypt audit images and reference images. *
*
* Constraints:
* Length: 1 - 2048
* Pattern: ^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$
*
* @return
* The identifier for your AWS Key Management Service key (AWS KMS * key). Used to encrypt audit images and reference images. *
*/ public String getKmsKeyId() { return kmsKeyId; } /** ** The identifier for your AWS Key Management Service key (AWS KMS key). * Used to encrypt audit images and reference images. *
*
* Constraints:
* Length: 1 - 2048
* Pattern: ^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$
*
* @param kmsKeyId
* The identifier for your AWS Key Management Service key (AWS * KMS key). Used to encrypt audit images and reference images. *
*/ public void setKmsKeyId(String kmsKeyId) { this.kmsKeyId = kmsKeyId; } /** ** The identifier for your AWS Key Management Service key (AWS KMS key). * Used to encrypt audit images and reference images. *
** Returns a reference to this object so that method calls can be chained * together. *
* Constraints:
* Length: 1 - 2048
* Pattern: ^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$
*
* @param kmsKeyId
* The identifier for your AWS Key Management Service key (AWS * KMS key). Used to encrypt audit images and reference images. *
* @return A reference to this updated object so that method calls can be * chained together. */ public CreateFaceLivenessSessionRequest withKmsKeyId(String kmsKeyId) { this.kmsKeyId = kmsKeyId; return this; } /** *
* A session settings object. It contains settings for the operation to be
* performed. For Face Liveness, it accepts OutputConfig
and
* AuditImagesLimit
.
*
* A session settings object. It contains settings for the operation
* to be performed. For Face Liveness, it accepts
* OutputConfig
and AuditImagesLimit
.
*
* A session settings object. It contains settings for the operation to be
* performed. For Face Liveness, it accepts OutputConfig
and
* AuditImagesLimit
.
*
* A session settings object. It contains settings for the
* operation to be performed. For Face Liveness, it accepts
* OutputConfig
and AuditImagesLimit
.
*
* A session settings object. It contains settings for the operation to be
* performed. For Face Liveness, it accepts OutputConfig
and
* AuditImagesLimit
.
*
* Returns a reference to this object so that method calls can be chained * together. * * @param settings
* A session settings object. It contains settings for the
* operation to be performed. For Face Liveness, it accepts
* OutputConfig
and AuditImagesLimit
.
*
* 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.
*
* Constraints:
* Length: 1 - 64
* Pattern: ^[a-zA-Z0-9-_]+$
*
* @return
* 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.
*
* 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.
*
* Constraints:
* Length: 1 - 64
* Pattern: ^[a-zA-Z0-9-_]+$
*
* @param clientRequestToken
* 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.
*
* 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.
*
* Returns a reference to this object so that method calls can be chained * together. *
* Constraints:
* Length: 1 - 64
* Pattern: ^[a-zA-Z0-9-_]+$
*
* @param clientRequestToken
* 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.
*