StartFaceSearchRequest (AWS SDK for Android - Amazon Rekognition 2.7.5 API)

java.lang.Object
- com.amazonaws.AmazonWebServiceRequest
- - com.amazonaws.services.rekognition.model.StartFaceSearchRequest

All Implemented Interfaces:

Serializable, Cloneable
```
public class StartFaceSearchRequest
extends AmazonWebServiceRequest
implements Serializable
```
Starts the asynchronous search for faces in a collection that match the faces of persons detected in a stored video.

The video must be stored in an Amazon S3 bucket. Use Video to specify the bucket name and the filename of the video. StartFaceSearch returns a job identifier (JobId) which you use to get the search results once the search has completed. When searching is finished, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic that you specify in NotificationChannel. To get the search results, first check that the status value published to the Amazon SNS topic is SUCCEEDED. If so, call and pass the job identifier (JobId) from the initial call to StartFaceSearch. For more information, see procedure-person-search-videos.

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description

StartFaceSearchRequest()

Constructors
Constructor and Description
`StartFaceSearchRequest()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(Object obj)`
`String`	`getClientRequestToken()` Idempotent token used to identify the start request.
`String`	`getCollectionId()` ID of the collection that contains the faces you want to search for.
`Boolean`	`getEnablePersonTracking()` Returns the value of the enablePersonTracking property for this object.
`Float`	`getFaceMatchThreshold()` The minimum confidence in the person match to return.
`String`	`getJobTag()` Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.
`NotificationChannel`	`getNotificationChannel()` The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the search.
`Video`	`getVideo()` The video you want to search.
`int`	`hashCode()`
`Boolean`	`isEnablePersonTracking()` Returns the value of the enablePersonTracking property for this object.
`void`	`setClientRequestToken(String clientRequestToken)` Idempotent token used to identify the start request.
`void`	`setCollectionId(String collectionId)` ID of the collection that contains the faces you want to search for.
`void`	`setEnablePersonTracking(Boolean enablePersonTracking)` Sets the value of enablePersonTracking
`void`	`setFaceMatchThreshold(Float faceMatchThreshold)` The minimum confidence in the person match to return.
`void`	`setJobTag(String jobTag)` Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.
`void`	`setNotificationChannel(NotificationChannel notificationChannel)` The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the search.
`void`	`setVideo(Video video)` The video you want to search.
`String`	`toString()` Returns a string representation of this object; useful for testing and debugging.
`StartFaceSearchRequest`	`withClientRequestToken(String clientRequestToken)` Idempotent token used to identify the start request.
`StartFaceSearchRequest`	`withCollectionId(String collectionId)` ID of the collection that contains the faces you want to search for.
`StartFaceSearchRequest`	`withEnablePersonTracking(Boolean enablePersonTracking)` Sets the value of the enablePersonTracking property for this object.
`StartFaceSearchRequest`	`withFaceMatchThreshold(Float faceMatchThreshold)` The minimum confidence in the person match to return.
`StartFaceSearchRequest`	`withJobTag(String jobTag)` Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.
`StartFaceSearchRequest`	`withNotificationChannel(NotificationChannel notificationChannel)` The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the search.
`StartFaceSearchRequest`	`withVideo(Video video)` The video you want to search.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest
clone, copyBaseTo, getCloneRoot, getCloneSource, getGeneralProgressListener, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - StartFaceSearchRequest
```
public StartFaceSearchRequest()
```
- Method Detail
  - getVideo
```
public Video getVideo()
```
    The video you want to search. The video must be stored in an Amazon S3 bucket.
    
    Returns:
    
    The video you want to search. The video must be stored in an Amazon S3 bucket.
  - setVideo
```
public void setVideo(Video video)
```
    The video you want to search. The video must be stored in an Amazon S3 bucket.
    
    Parameters:
    
    video -
    The video you want to search. The video must be stored in an Amazon S3 bucket.
  - withVideo
```
public StartFaceSearchRequest withVideo(Video video)
```
    The video you want to search. The video must be stored in an Amazon S3 bucket.
    
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    
    video -
    The video you want to search. The video must be stored in an Amazon S3 bucket.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getClientRequestToken
```
public String getClientRequestToken()
```
    Idempotent token used to identify the start request. If you use the same token with multiple StartFaceSearch 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-_]+$
    
    Returns:
    
    Idempotent token used to identify the start request. If you use the same token with multiple StartFaceSearch requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidently started more than once.
  - setClientRequestToken
```
public void setClientRequestToken(String clientRequestToken)
```
    Idempotent token used to identify the start request. If you use the same token with multiple StartFaceSearch 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-_]+$
    
    Parameters:
    
    clientRequestToken -
    Idempotent token used to identify the start request. If you use the same token with multiple StartFaceSearch requests, the same JobId is returned. Use ClientRequestToken to prevent the same job from being accidently started more than once.
  - withClientRequestToken
```
public StartFaceSearchRequest withClientRequestToken(String clientRequestToken)
```
    Idempotent token used to identify the start request. If you use the same token with multiple StartFaceSearch 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-_]+$
    
    Parameters:
    
    clientRequestToken -
    Idempotent token used to identify the start request. If you use the same token with multiple StartFaceSearch 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 updated object so that method calls can be chained together.
  - getFaceMatchThreshold
```
public Float getFaceMatchThreshold()
```
    The minimum confidence in the person match to return. For example, don't return any matches where confidence in matches is less than 70%.
    
    Constraints:
    Length: 0 - 100
    
    Returns:
    
    The minimum confidence in the person match to return. For example, don't return any matches where confidence in matches is less than 70%.
  - setFaceMatchThreshold
```
public void setFaceMatchThreshold(Float faceMatchThreshold)
```
    The minimum confidence in the person match to return. For example, don't return any matches where confidence in matches is less than 70%.
    
    Constraints:
    Length: 0 - 100
    
    Parameters:
    
    faceMatchThreshold -
    The minimum confidence in the person match to return. For example, don't return any matches where confidence in matches is less than 70%.
  - withFaceMatchThreshold
```
public StartFaceSearchRequest withFaceMatchThreshold(Float faceMatchThreshold)
```
    The minimum confidence in the person match to return. For example, don't return any matches where confidence in matches is less than 70%.
    
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 0 - 100
    
    Parameters:
    
    faceMatchThreshold -
    The minimum confidence in the person match to return. For example, don't return any matches where confidence in matches is less than 70%.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getCollectionId
```
public String getCollectionId()
```
    ID of the collection that contains the faces you want to search for.
    
    Constraints:
    Length: 1 - 255
    Pattern: [a-zA-Z0-9_.\-]+
    
    Returns:
    
    ID of the collection that contains the faces you want to search for.
  - setCollectionId
```
public void setCollectionId(String collectionId)
```
    ID of the collection that contains the faces you want to search for.
    
    Constraints:
    Length: 1 - 255
    Pattern: [a-zA-Z0-9_.\-]+
    
    Parameters:
    
    collectionId -
    ID of the collection that contains the faces you want to search for.
  - withCollectionId
```
public StartFaceSearchRequest withCollectionId(String collectionId)
```
    ID of the collection that contains the faces you want to search for.
    
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 1 - 255
    Pattern: [a-zA-Z0-9_.\-]+
    
    Parameters:
    
    collectionId -
    ID of the collection that contains the faces you want to search for.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - isEnablePersonTracking
```
public Boolean isEnablePersonTracking()
```
    Returns the value of the enablePersonTracking property for this object.
    
    Returns:
    
    The value of the enablePersonTracking property for this object.
  - getEnablePersonTracking
```
public Boolean getEnablePersonTracking()
```
    Returns the value of the enablePersonTracking property for this object.
    
    Returns:
    
    The value of the enablePersonTracking property for this object.
  - setEnablePersonTracking
```
public void setEnablePersonTracking(Boolean enablePersonTracking)
```
    Sets the value of enablePersonTracking
    
    Parameters:
    
    enablePersonTracking - The new value for the enablePersonTracking property for this object.
  - withEnablePersonTracking
```
public StartFaceSearchRequest withEnablePersonTracking(Boolean enablePersonTracking)
```
    Sets the value of the enablePersonTracking property for this object.
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    
    enablePersonTracking - The new value for the enablePersonTracking property for this object.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getNotificationChannel
```
public NotificationChannel getNotificationChannel()
```
    The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the search.
    
    Returns:
    
    The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the search.
  - setNotificationChannel
```
public void setNotificationChannel(NotificationChannel notificationChannel)
```
    The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the search.
    
    Parameters:
    
    notificationChannel -
    The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the search.
  - withNotificationChannel
```
public StartFaceSearchRequest withNotificationChannel(NotificationChannel notificationChannel)
```
    The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the search.
    
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    
    notificationChannel -
    The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the search.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getJobTag
```
public String getJobTag()
```
    Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.
    
    Constraints:
    Length: 1 - 256
    Pattern: [a-zA-Z0-9_.\-:]+
    
    Returns:
    
    Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.
  - setJobTag
```
public void setJobTag(String jobTag)
```
    Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.
    
    Constraints:
    Length: 1 - 256
    Pattern: [a-zA-Z0-9_.\-:]+
    
    Parameters:
    
    jobTag -
    Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.
  - withJobTag
```
public StartFaceSearchRequest withJobTag(String jobTag)
```
    Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.
    
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 1 - 256
    Pattern: [a-zA-Z0-9_.\-:]+
    
    Parameters:
    
    jobTag -
    Unique identifier you specify to identify the job in the completion status published to the Amazon Simple Notification Service topic.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - toString
```
public String toString()
```
    Returns a string representation of this object; useful for testing and debugging.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    A string representation of this object.
    
    See Also:
    
    Object.toString()
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object

Class StartFaceSearchRequest

Constructor Summary

Method Summary

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

Methods inherited from class java.lang.Object

Constructor Detail

StartFaceSearchRequest

Method Detail

getVideo

setVideo

withVideo

getClientRequestToken

setClientRequestToken

withClientRequestToken

getFaceMatchThreshold

setFaceMatchThreshold

withFaceMatchThreshold

getCollectionId

setCollectionId

withCollectionId

isEnablePersonTracking

getEnablePersonTracking

setEnablePersonTracking

withEnablePersonTracking

getNotificationChannel

setNotificationChannel

withNotificationChannel

getJobTag

setJobTag

withJobTag

toString

hashCode

equals