Starts asynchronous detection of faces in a stored video
Starts asynchronous detection of faces in a stored video.
Amazon Rekognition Video can detect faces in a video stored in an Amazon
S3 bucket. Use Video to specify the bucket name and the filename of the
video. start_face_detection
returns a job identifier (JobId
) that you use to get the results of
the operation. When face detection is finished, Amazon Rekognition Video
publishes a completion status to the Amazon Simple Notification Service
topic that you specify in NotificationChannel
. To get the results of
the face detection operation, first check that the status value
published to the Amazon SNS topic is SUCCEEDED
. If so, call
get_face_detection
and pass the job
identifier (JobId
) from the initial call to
start_face_detection
.
For more information, see Detecting Faces in a Stored Video in the Amazon Rekognition Developer Guide.
rekognition_start_face_detection(Video, ClientRequestToken, NotificationChannel, FaceAttributes, JobTag)
Video |
[required] The video in which you want to detect faces. The video must be stored in an Amazon S3 bucket. |
ClientRequestToken |
Idempotent token used to identify the start request. If you use the same
token with multiple
|
NotificationChannel |
The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the face detection operation. |
FaceAttributes |
The face attributes you want returned.
|
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 |
A list with the following syntax:
list( JobId = "string" )
svc$start_face_detection( Video = list( S3Object = list( Bucket = "string", Name = "string", Version = "string" ) ), ClientRequestToken = "string", NotificationChannel = list( SNSTopicArn = "string", RoleArn = "string" ), FaceAttributes = "DEFAULT"|"ALL", JobTag = "string" )
Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.