// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
/// Constructs a fluent builder for the [`StartFaceSearch`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder) operation.
///
/// - The fluent builder is configurable:
/// - [`video(Video)`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::video) / [`set_video(Option<Video>)`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::set_video):<br>required: **true**<br><p>The video you want to search. The video must be stored in an Amazon S3 bucket. </p><br>
/// - [`client_request_token(impl Into<String>)`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::client_request_token) / [`set_client_request_token(Option<String>)`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::set_client_request_token):<br>required: **false**<br><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><br>
/// - [`face_match_threshold(f32)`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::face_match_threshold) / [`set_face_match_threshold(Option<f32>)`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::set_face_match_threshold):<br>required: **false**<br><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><br>
/// - [`collection_id(impl Into<String>)`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::collection_id) / [`set_collection_id(Option<String>)`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::set_collection_id):<br>required: **true**<br><p>ID of the collection that contains the faces you want to search for.</p><br>
/// - [`notification_channel(NotificationChannel)`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::notification_channel) / [`set_notification_channel(Option<NotificationChannel>)`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::set_notification_channel):<br>required: **false**<br><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><br>
/// - [`job_tag(impl Into<String>)`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::job_tag) / [`set_job_tag(Option<String>)`](crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::set_job_tag):<br>required: **false**<br><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><br>
/// - On success, responds with [`StartFaceSearchOutput`](crate::operation::start_face_search::StartFaceSearchOutput) with field(s):
/// - [`job_id(Option<String>)`](crate::operation::start_face_search::StartFaceSearchOutput::job_id): <p>The identifier for the search job. Use <code>JobId</code> to identify the job in a subsequent call to <code>GetFaceSearch</code>. </p>
/// - On failure, responds with [`SdkError<StartFaceSearchError>`](crate::operation::start_face_search::StartFaceSearchError)
pub fn start_face_search(&self) -> crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder {
crate::operation::start_face_search::builders::StartFaceSearchFluentBuilder::new(self.handle.clone())
}
}