public class StartPersonTrackingRequest extends AmazonWebServiceRequest implements java.io.Serializable
Starts the asynchronous tracking of a person's path in a stored video.
Amazon Rekognition Video can track the path of people in a video stored in an
Amazon S3 bucket. Use Video to specify the bucket name and the
filename of the video. StartPersonTracking
returns a job
identifier (JobId
) which you use to get the results of the
operation. When label detection is finished, Amazon Rekognition publishes a
completion status to the Amazon Simple Notification Service topic that you
specify in NotificationChannel
.
To get the results of the person detection operation, first check that the
status value published to the Amazon SNS topic is SUCCEEDED
. If
so, call GetPersonTracking and pass the job identifier (
JobId
) from the initial call to StartPersonTracking
.
Constructor and Description |
---|
StartPersonTrackingRequest() |
Modifier and Type | Method and Description |
---|---|
boolean |
equals(java.lang.Object obj) |
java.lang.String |
getClientRequestToken()
Idempotent token used to identify the start request.
|
java.lang.String |
getJobTag()
An identifier you specify that's returned in the completion notification
that's published to your Amazon Simple Notification Service topic.
|
NotificationChannel |
getNotificationChannel()
The Amazon SNS topic ARN you want Amazon Rekognition Video to publish the
completion status of the people detection operation to.
|
Video |
getVideo()
The video in which you want to detect people.
|
int |
hashCode() |
void |
setClientRequestToken(java.lang.String clientRequestToken)
Idempotent token used to identify the start request.
|
void |
setJobTag(java.lang.String jobTag)
An identifier you specify that's returned in the completion notification
that's published to your Amazon Simple Notification Service topic.
|
void |
setNotificationChannel(NotificationChannel notificationChannel)
The Amazon SNS topic ARN you want Amazon Rekognition Video to publish the
completion status of the people detection operation to.
|
void |
setVideo(Video video)
The video in which you want to detect people.
|
java.lang.String |
toString()
Returns a string representation of this object; useful for testing and
debugging.
|
StartPersonTrackingRequest |
withClientRequestToken(java.lang.String clientRequestToken)
Idempotent token used to identify the start request.
|
StartPersonTrackingRequest |
withJobTag(java.lang.String jobTag)
An identifier you specify that's returned in the completion notification
that's published to your Amazon Simple Notification Service topic.
|
StartPersonTrackingRequest |
withNotificationChannel(NotificationChannel notificationChannel)
The Amazon SNS topic ARN you want Amazon Rekognition Video to publish the
completion status of the people detection operation to.
|
StartPersonTrackingRequest |
withVideo(Video video)
The video in which you want to detect people.
|
clone, getCloneRoot, getCloneSource, getGeneralProgressListener, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector
public Video getVideo()
The video in which you want to detect people. The video must be stored in an Amazon S3 bucket.
The video in which you want to detect people. The video must be stored in an Amazon S3 bucket.
public void setVideo(Video video)
The video in which you want to detect people. The video must be stored in an Amazon S3 bucket.
video
- The video in which you want to detect people. The video must be stored in an Amazon S3 bucket.
public StartPersonTrackingRequest withVideo(Video video)
The video in which you want to detect people. The video must be stored in an Amazon S3 bucket.
Returns a reference to this object so that method calls can be chained together.
video
- The video in which you want to detect people. The video must be stored in an Amazon S3 bucket.
public java.lang.String getClientRequestToken()
Idempotent token used to identify the start request. If you use the same
token with multiple StartPersonTracking
requests, the same
JobId
is returned. Use ClientRequestToken
to
prevent the same job from being accidently started more than once.
Constraints:
Length: 1 - 64
Pattern: ^[a-zA-Z0-9-_]+$
Idempotent token used to identify the start request. If you use
the same token with multiple StartPersonTracking
requests, the same JobId
is returned. Use
ClientRequestToken
to prevent the same job from
being accidently started more than once.
public void setClientRequestToken(java.lang.String clientRequestToken)
Idempotent token used to identify the start request. If you use the same
token with multiple StartPersonTracking
requests, the same
JobId
is returned. Use ClientRequestToken
to
prevent the same job from being accidently started more than once.
Constraints:
Length: 1 - 64
Pattern: ^[a-zA-Z0-9-_]+$
clientRequestToken
-
Idempotent token used to identify the start request. If you
use the same token with multiple
StartPersonTracking
requests, the same
JobId
is returned. Use
ClientRequestToken
to prevent the same job from
being accidently started more than once.
public StartPersonTrackingRequest withClientRequestToken(java.lang.String clientRequestToken)
Idempotent token used to identify the start request. If you use the same
token with multiple StartPersonTracking
requests, the same
JobId
is returned. Use ClientRequestToken
to
prevent the same job from being accidently started more than once.
Returns a reference to this object so that method calls can be chained together.
Constraints:
Length: 1 - 64
Pattern: ^[a-zA-Z0-9-_]+$
clientRequestToken
-
Idempotent token used to identify the start request. If you
use the same token with multiple
StartPersonTracking
requests, the same
JobId
is returned. Use
ClientRequestToken
to prevent the same job from
being accidently started more than once.
public NotificationChannel getNotificationChannel()
The Amazon SNS topic ARN you want Amazon Rekognition Video to publish the completion status of the people detection operation to.
The Amazon SNS topic ARN you want Amazon Rekognition Video to publish the completion status of the people detection operation to.
public void setNotificationChannel(NotificationChannel notificationChannel)
The Amazon SNS topic ARN you want Amazon Rekognition Video to publish the completion status of the people detection operation to.
notificationChannel
- The Amazon SNS topic ARN you want Amazon Rekognition Video to publish the completion status of the people detection operation to.
public StartPersonTrackingRequest withNotificationChannel(NotificationChannel notificationChannel)
The Amazon SNS topic ARN you want Amazon Rekognition Video to publish the completion status of the people detection operation to.
Returns a reference to this object so that method calls can be chained together.
notificationChannel
- The Amazon SNS topic ARN you want Amazon Rekognition Video to publish the completion status of the people detection operation to.
public java.lang.String getJobTag()
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.
Constraints:
Length: 1 - 256
Pattern: [a-zA-Z0-9_.\-:]+
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.
public void setJobTag(java.lang.String 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.
Constraints:
Length: 1 - 256
Pattern: [a-zA-Z0-9_.\-:]+
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.
public StartPersonTrackingRequest withJobTag(java.lang.String 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.
Returns a reference to this object so that method calls can be chained together.
Constraints:
Length: 1 - 256
Pattern: [a-zA-Z0-9_.\-:]+
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.
public java.lang.String toString()
toString
in class java.lang.Object
Object.toString()
public int hashCode()
hashCode
in class java.lang.Object
public boolean equals(java.lang.Object obj)
equals
in class java.lang.Object
Copyright © 2018 Amazon Web Services, Inc. All Rights Reserved.