Skip to content

StartFaceSearchRequest

Source code in docs_src/capo_rekognition/types/start_face_search_request.py
class StartFaceSearchRequest(TypedDict, closed=True):
    video: "capo_rekognition.types.video.Video"
    """<p>The video you want to search. The video must be stored in an Amazon S3 bucket. </p>"""
    client_request_token: NotRequired[
        "capo_rekognition.types.client_request_token.ClientRequestToken"
    ]
    """<p>Idempotent token used to identify the start request. If you use the same token with multiple <code>StartFaceSearch</code> requests, the same <code>JobId</code> is returned. Use <code>ClientRequestToken</code> to prevent the same job from being accidently started more than once. </p>"""
    face_match_threshold: NotRequired["capo_rekognition.types.percent.Percent"]
    """<p>The minimum confidence in the person match to return. For example, don't return any matches where confidence in matches is less than 70%. The default value is 80%.</p>"""
    collection_id: "capo_rekognition.types.collection_id.CollectionId"
    """<p>ID of the collection that contains the faces you want to search for.</p>"""
    notification_channel: NotRequired[
        "capo_rekognition.types.notification_channel.NotificationChannel"
    ]
    """<p>The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the search. The Amazon SNS topic must have a topic name that begins with <i>AmazonRekognition</i> if you are using the AmazonRekognitionServiceRole permissions policy to access the topic.</p>"""
    job_tag: NotRequired["capo_rekognition.types.job_tag.JobTag"]
    """<p>An identifier you specify that's returned in the completion notification that's published to your Amazon Simple Notification Service topic. For example, you can use <code>JobTag</code> to group related jobs and identify them in the completion notification.</p>"""

client_request_token instance-attribute

client_request_token: NotRequired[ClientRequestToken]

Idempotent token used to identify the start request. If you use the same token with multiple StartFaceSearch requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidently started more than once.

collection_id instance-attribute

collection_id: CollectionId

ID of the collection that contains the faces you want to search for.

face_match_threshold instance-attribute

face_match_threshold: NotRequired[Percent]

The minimum confidence in the person match to return. For example, don't return any matches where confidence in matches is less than 70%. The default value is 80%.

job_tag instance-attribute

job_tag: NotRequired[JobTag]

An identifier you specify that's returned in the completion notification that's published to your Amazon Simple Notification Service topic. For example, you can use JobTag to group related jobs and identify them in the completion notification.

notification_channel instance-attribute

notification_channel: NotRequired[NotificationChannel]

The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the search. The Amazon SNS topic must have a topic name that begins with AmazonRekognition if you are using the AmazonRekognitionServiceRole permissions policy to access the topic.

video instance-attribute

video: Video

The video you want to search. The video must be stored in an Amazon S3 bucket.