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.
Starts asynchronous recognition of celebrities in a stored video.
Amazon Rekognition Video can detect celebrities in a video must be stored in an Amazon
S3 bucket. Use Video to specify the bucket name and the filename of the video.
StartCelebrityRecognition
returns a job identifier (JobId
) which you
use to get the results of the analysis. When celebrity recognition analysis 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 celebrity recognition analysis, first check that the status value published to
the Amazon SNS topic is SUCCEEDED
. If so, call GetCelebrityRecognition
and pass the job identifier (JobId
) from the initial call to StartCelebrityRecognition
.
For more information, see Recognizing celebrities in the Amazon Rekognition Developer Guide.
For .NET Core this operation is only available in asynchronous form. Please refer to StartCelebrityRecognitionAsync.
Namespace: Amazon.Rekognition
Assembly: AWSSDK.Rekognition.dll
Version: 3.x.y.z
public virtual StartCelebrityRecognitionResponse StartCelebrityRecognition( StartCelebrityRecognitionRequest request )
Container for the necessary parameters to execute the StartCelebrityRecognition service method.
Exception | Condition |
---|---|
AccessDeniedException | You are not authorized to perform the action. |
IdempotentParameterMismatchException | A ClientRequestToken input parameter was reused with an operation, but at least one of the other input parameters is different from the previous call to the operation. |
InternalServerErrorException | Amazon Rekognition experienced a service issue. Try your call again. |
InvalidParameterException | Input parameter violated a constraint. Validate your parameter before calling the API operation again. |
InvalidS3ObjectException | Amazon Rekognition is unable to access the S3 object specified in the request. |
LimitExceededException | An Amazon Rekognition service limit was exceeded. For example, if you start too many jobs concurrently, subsequent calls to start operations (ex: StartLabelDetection) will raise a LimitExceededException exception (HTTP status code: 400) until the number of concurrently running jobs is below the Amazon Rekognition service limit. |
ProvisionedThroughputExceededException | The number of requests exceeded your throughput limit. If you want to increase this limit, contact Amazon Rekognition. |
ThrottlingException | Amazon Rekognition is temporarily unable to process the request. Try your call again. |
VideoTooLargeException | The file size or duration of the supplied media is too large. The maximum file size is 10GB. The maximum duration is 6 hours. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5