As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Pesquisando usuários (ID facial/ID de usuário) Você pode usar a [SearchUsers](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_SearchUsers.html)operação para pesquisar usuários em uma coleção especificada que correspondam a uma ID facial ou ID de usuário fornecida. A operação lista os retornados `UserIds` classificados pela pontuação de similaridade mais alta acima da solicitada UserMatchThreshold. O ID do usuário é criado na CreateUsers operação. Para obter mais informações, consulte [Gerenciar usuários em uma coleção](managing-face-collections.md#collections-manage-users). **Para pesquisar usuários (SDK)** 1. Se ainda não tiver feito isso: 1. Crie ou atualize um usuário com permissões `AmazonRekognitionFullAccess`. Para obter mais informações, consulte [Etapa 1: Configure uma conta da AWS e crie um usuário](setting-up.md#setting-up-iam). 1. Instale e configure o AWS CLI e os AWS SDKs. Para obter mais informações, consulte [Etapa 2: configurar o AWS CLI and AWS SDKs](setup-awscli-sdk.md). 1. Use os exemplos a seguir para chamar a operação `SearchUsers`. ------ #### [ Java ] Este exemplo de Java pesquisa os usuários em uma coleção usando a operação `SearchUsers`. ``` import com.amazonaws.services.rekognition.AmazonRekognition; import com.amazonaws.services.rekognition.AmazonRekognitionClientBuilder; import com.amazonaws.services.rekognition.model.UserMatch; import com.amazonaws.services.rekognition.model.SearchUsersRequest; import com.amazonaws.services.rekognition.model.SearchUsersResult; import com.amazonaws.services.rekognition.model.UserMatch; public class SearchUsers { //Replace collectionId and faceId with the values you want to use. public static final String collectionId = "MyCollection"; public static final String faceId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"; public static final String userd = 'demo-user'; public static void main(String[] args) throws Exception { AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient(); // Search collection for faces matching the user id. SearchUsersRequest request = new SearchUsersRequest() .withCollectionId(collectionId) .withUserId(userId); SearchUsersResult result = rekognitionClient.searchUsers(request); System.out.println("Printing first search result with matched user and similarity score"); for (UserMatch match: result.getUserMatches()) { System.out.println(match.getUser().getUserId() + " with similarity score " + match.getSimilarity()); } // Search collection for faces matching the face id. SearchUsersRequest request1 = new SearchUsersRequest() .withCollectionId(collectionId) .withFaceId(faceId); SearchUsersResult result1 = rekognitionClient.searchUsers(request1); System.out.println("Printing second search result with matched user and similarity score"); for (UserMatch match: result1.getUserMatches()) { System.out.println(match.getUser().getUserId() + " with similarity score " + match.getSimilarity()); } } ``` ------ #### [ AWS CLI ] Esse AWS CLI comando pesquisa os usuários em uma coleção com a `SearchUsers` operação. ``` aws rekognition search-users --face-id {{face-id}} --collection-id {{collection-id }}--region {{region-name}} ``` ------ #### [ Python ] O exemplo a seguir pesquisa os usuários em uma coleção com a operação `SearchUsers`. ``` # Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved. # PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.) import boto3 from botocore.exceptions import ClientError import logging logger = logging.getLogger(__name__) session = boto3.Session(profile_name='profile-name') client = session.client('rekognition') def search_users_by_face_id(collection_id, face_id): """ SearchUsers operation with face ID provided as the search source :param collection_id: The ID of the collection where user and faces are stored. :param face_id: The ID of the face in the collection to search for. :return: response of SearchUsers API """ logger.info(f'Searching for users using a face-id: {face_id}') try: response = client.search_users( CollectionId=collection_id, FaceId=face_id ) print(f'- found {len(response["UserMatches"])} matches') print([f'- {x["User"]["UserId"]} - {x["Similarity"]}%' for x in response["UserMatches"]]) except ClientError: logger.exception(f'Failed to perform SearchUsers with given face id: {face_id}') raise else: print(response) return response def search_users_by_user_id(collection_id, user_id): """ SearchUsers operation with user ID provided as the search source :param collection_id: The ID of the collection where user and faces are stored. :param user_id: The ID of the user in the collection to search for. :return: response of SearchUsers API """ logger.info(f'Searching for users using a user-id: {user_id}') try: response = client.search_users( CollectionId=collection_id, UserId=user_id ) print(f'- found {len(response["UserMatches"])} matches') print([f'- {x["User"]["UserId"]} - {x["Similarity"]}%' for x in response["UserMatches"]]) except ClientError: logger.exception(f'Failed to perform SearchUsers with given face id: {user_id}') raise else: print(response) return response def main(): collection_id = "collection-id" user_id = "user-id" face_id = "face_id" search_users_by_face_id(collection_id, face_id) search_users_by_user_id(collection_id, user_id) if __name__ == "__main__": main() ``` ------ ## SearchUsers solicitação de operação Com um FaceID ou ID de usuário SearchUsers , pesquisa correspondências de usuário no CollectionID especificado. Por padrão, SearchUsers retorna UserIDs para os quais a pontuação de similaridade é maior que 80%. A semelhança indica até que ponto o UserID corresponde ao FaceID ou UserID fornecido. Se várias IDs de usuário forem retornadas, elas serão listadas na ordem da maior pontuação de similaridade para a menor. Opcionalmente, você pode usar o UserMatchThreshold para especificar um valor diferente. Para obter mais informações, consulte [Gerenciar usuários em uma coleção](managing-face-collections.md#collections-manage-users). Veja a seguir um exemplo de uma SearchUsers solicitação usando`UserId`: ``` { "CollectionId": "MyCollection", "UserId": "demoUser1", "MaxUsers": 2, "UserMatchThreshold": 99 } ``` Veja a seguir um exemplo de uma SearchUsers solicitação usando`FaceId`: ``` { "CollectionId": "MyCollection", "FaceId": "bff43c40-cfa7-4b94-bed8-8a08b2205107", "MaxUsers": 2, "UserMatchThreshold": 99 } ``` ## SearchUsers resposta da operação Se pesquisar com um`FaceId`, a resposta para SearchUsers inclui o `FaceId` para`SearchedFace`, bem como uma lista de `UserMatches` e o `UserId` e `UserStatus` para cada usuário. ``` { "SearchedFace": { "FaceId": "bff43c40-cfa7-4b94-bed8-8a08b2205107" }, "UserMatches": [ { "User": { "UserId": "demoUser1", "UserStatus": "ACTIVE" }, "Similarity": 100.0 }, { "User": { "UserId": "demoUser2", "UserStatus": "ACTIVE" }, "Similarity": 99.97946166992188 } ], "FaceModelVersion": "6" } ``` Se estiver pesquisando com a`UserId`, a resposta `UserId` para SearchUsers inclui a para`SearchedUser`, além dos outros elementos de resposta. ``` { "SearchedUser": { "UserId": "demoUser1" }, "UserMatches": [ { "User": { "UserId": "demoUser2", "UserStatus": "ACTIVE" }, "Similarity": 99.97946166992188 } ], "FaceModelVersion": "6" } ```