Container for the parameters to the SearchUsers operation.
Searches for UserIDs within a collection based on a FaceId or UserId.
This API can be used to find the closest UserID (with a highest similarity) to associate
a face. The request must be provided with either FaceId or UserId. The
operation returns an array of UserID that match the FaceId or UserId,
ordered by similarity score with the highest similarity first.
Inheritance Hierarchy
Amazon.Runtime.AmazonWebServiceRequest
Amazon.Rekognition.AmazonRekognitionRequest
Amazon.Rekognition.Model.SearchUsersRequest
Namespace: Amazon.Rekognition.Model
Assembly: AWSSDK.Rekognition.dll
Version: 3.x.y.z
Syntax
public class SearchUsersRequest : AmazonRekognitionRequest IAmazonWebServiceRequest
The SearchUsersRequest type exposes the following members
Constructors
| Name | Description | |
|---|---|---|
|
SearchUsersRequest() |
Properties
| Name | Type | Description | |
|---|---|---|---|
|
|
CollectionId | System.String |
Gets and sets the property CollectionId. The ID of an existing collection containing the UserID, used with a UserId or FaceId. If a FaceId is provided, UserId isn’t required to be present in the Collection. |
|
|
FaceId | System.String |
Gets and sets the property FaceId. ID for the existing face. |
|
|
MaxUsers | System.Int32 |
Gets and sets the property MaxUsers. Maximum number of identities to return. |
|
|
UserId | System.String |
Gets and sets the property UserId. ID for the existing User. |
|
|
UserMatchThreshold | System.Single |
Gets and sets the property UserMatchThreshold. Optional value that specifies the minimum confidence in the matched UserID to return. Default value of 80. |
Examples
Searches for UserIDs within a collection based on a FaceId or UserId.
SearchUsers
var client = new AmazonRekognitionClient();
var response = client.SearchUsers(new SearchUsersRequest
{
CollectionId = "MyCollection",
MaxUsers = 2,
UserId = "DemoUser",
UserMatchThreshold = 70
});
string faceModelVersion = response.FaceModelVersion;
SearchedUser searchedUser = response.SearchedUser;
List<UserMatch> userMatches = response.UserMatches;
Version Information
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer, 3.5