Search Users

rekognition_search_users

R Documentation

Searches for UserIDs within a collection based on a FaceId or UserId¶

Description¶

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.

Usage¶

rekognition_search_users(CollectionId, UserId, FaceId,
  UserMatchThreshold, MaxUsers)

Arguments¶

CollectionId: [required] 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.
UserId: ID for the existing User.
FaceId: ID for the existing face.
UserMatchThreshold: Optional value that specifies the minimum confidence in the matched UserID to return. Default value of 80.
MaxUsers: Maximum number of identities to return.

Value¶

A list with the following syntax:

list(
  UserMatches = list(
    list(
      Similarity = 123.0,
      User = list(
        UserId = "string",
        UserStatus = "ACTIVE"|"UPDATING"|"CREATING"|"CREATED"
      )
    )
  ),
  FaceModelVersion = "string",
  SearchedFace = list(
    FaceId = "string"
  ),
  SearchedUser = list(
    UserId = "string"
  )
)

Request syntax¶

svc$search_users(
  CollectionId = "string",
  UserId = "string",
  FaceId = "string",
  UserMatchThreshold = 123.0,
  MaxUsers = 123
)

Examples¶

## Not run: 
# Searches for UserIDs within a collection based on a FaceId or UserId.
svc$search_users(
  CollectionId = "MyCollection",
  MaxUsers = 2L,
  UserId = "DemoUser",
  UserMatchThreshold = 70L
)

## End(Not run)