AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Gets face detection results for a Amazon Rekognition Video analysis started by .
Face detection with Amazon Rekognition Video is an asynchronous operation. You start
face detection by calling which returns a job identifier (
the face detection operation finishes, Amazon Rekognition Video publishes a completion
status to the Amazon Simple Notification Service topic registered in the initial call
StartFaceDetection. To get the results of the face detection operation,
first check that the status value published to the Amazon SNS topic is
If so, call and pass the job identifier (
JobId) from the initial call
GetFaceDetection returns an array of detected faces (
sorted by the time the faces were detected.
Use MaxResults parameter to limit the number of labels returned. If there are more
results than specified in
MaxResults, the value of
in the operation response contains a pagination token for getting the next set of
results. To get the next page of results, call
GetFaceDetection and populate
NextToken request parameter with the token value returned from the
previous call to
For .NET Core and PCL this operation is only available in asynchronous form. Please refer to GetFaceDetectionAsync.
public abstract GetFaceDetectionResponse GetFaceDetection( GetFaceDetectionRequest request )
Container for the necessary parameters to execute the GetFaceDetection service method.
|AccessDeniedException||You are not authorized to perform the action.|
|InternalServerErrorException||Amazon Rekognition experienced a service issue. Try your call again.|
|InvalidPaginationTokenException||Pagination token in the request is not valid.|
|InvalidParameterException||Input parameter violated a constraint. Validate your parameter before calling the API operation again.|
|ProvisionedThroughputExceededException||The number of requests exceeded your throughput limit. If you want to increase this limit, contact Amazon Rekognition.|
|ResourceNotFoundException||The collection specified in the request cannot be found.|
|ThrottlingException||Amazon Rekognition is temporarily unable to process the request. Try your call again.|
Supported in: 4.5, 4.0, 3.5
Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms