Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Associer des visages à un utilisateur
Vous pouvez utiliser cette [AssociateFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_AssociatingFaces.html)opération pour associer plusieurs visages individuels à un seul utilisateur. Pour associer un visage à un utilisateur, vous devez d’abord créer une collection et un utilisateur. Notez que les vecteurs de visage doivent résider dans la même collection que le vecteur utilisateur.
**Pour associer des visages (SDK)**
1. Si vous ne l’avez pas déjà fait :
1. Créez ou mettez à jour un utilisateur avec les autorisations `AmazonRekognitionFullAccess`. Pour de plus amples informations, veuillez consulter [Étape 1 : configurer un compte AWS et créer un utilisateur](setting-up.md#setting-up-iam).
1. Installez et configurez le AWS CLI et le AWS SDKs. Pour de plus amples informations, veuillez consulter [Étape 2 : configurer le AWS CLI et AWS SDKs](setup-awscli-sdk.md).
1. Utilisez les exemples suivants pour appeler l’opération `AssociateFaces`.
------
#### [ Java ]
Cet exemple de code Java associe un visage à un utilisateur.
```
import java.util.Arrays;
import java.util.List;
import com.amazonaws.services.rekognition.AmazonRekognition;
import com.amazonaws.services.rekognition.AmazonRekognitionClientBuilder;
import com.amazonaws.services.rekognition.model.AssociateFacesRequest;
import com.amazonaws.services.rekognition.model.AssociateFacesResult;
public class AssociateFaces {
public static void main(String[] args) throws Exception {
AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient();
/* Replace the below configurations to allow you successfully run the example
@collectionId: The collection where user and faces are stored
@userId: The user which faces will get associated to
@faceIds: The list of face IDs that will get associated to the given user
@userMatchThreshold: Minimum User match confidence required for the face to
be associated with a User that has at least one faceID already associated
*/
String collectionId = "MyCollection";
String userId = "demoUser";
String faceId1 = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
String faceId2 = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
List faceIds = Arrays.asList(faceid1,faceid2);
float userMatchThreshold = 0f;
System.out.println("Associating faces to the existing user: " +
userId);
AssociateFacesRequest request = new AssociateFacesRequest()
.withCollectionId(collectionId)
.withUserId(userId)
.withFaceIds(faceIds)
.withUserMatchThreshold(userMatchThreshold);
AssociateFacesResult result = rekognitionClient.associateFaces(request);
System.out.println("Successful face associations: " + result.getAssociatedFaces().size());
System.out.println("Unsuccessful face associations: " + result.getUnsuccessfulFaceAssociations().size());
}
}
```
------
#### [ AWS CLI ]
Cette AWS CLI commande associe un visage à un utilisateur à l'aide de l'opération `associate-faces` CLI.
```
aws rekognition associate-faces --user-id user-id --face-ids face-id-1 face-id-2
--collection-id collection-name
--region region-name
```
------
#### [ Python ]
Cet exemple de code Python associe un visage à un utilisateur.
```
from botocore.exceptions import ClientError
import boto3
import logging
logger = logging.getLogger(__name__)
session = boto3.Session(profile_name='profile-name')
client = session.client('rekognition')
def associate_faces(collection_id, user_id, face_ids):
"""
Associate stored faces within collection to the given user
:param collection_id: The ID of the collection where user and faces are stored.
:param user_id: The ID of the user that we want to associate faces to
:param face_ids: The list of face IDs to be associated to the given user
:return: response of AssociateFaces API
"""
logger.info(f'Associating faces to user: {user_id}, {face_ids}')
try:
response = client.associate_faces(
CollectionId=collection_id,
UserId=user_id,
FaceIds=face_ids
)
print(f'- associated {len(response["AssociatedFaces"])} faces')
except ClientError:
logger.exception("Failed to associate faces to the given user")
raise
else:
print(response)
return response
def main():
face_ids = ["faceId1", "faceId2"]
collection_id = "collection-id"
user_id = "user-id"
associate_faces(collection_id, user_id, face_ids)
if __name__ == "__main__":
main()
```
------
## AssociateFaces réponse à l'opération
La réponse pour `AssociateFaces` inclut le `UserStatus`, qui est le statut de la demande de dissociation, ainsi qu’une liste des personnes `FaceIds` à associer. Une liste de `UnsuccessfulFaceAssociations` est également renvoyée. Après avoir soumis une demande à `AssociateFaces`, l’opération peut prendre environ une minute.
Pour cette raison, le UserStatus est renvoyé, qui peut prendre les valeurs suivantes :
+ CRÉÉ : indique que « l’utilisateur » a été créé avec succès et qu’aucun visage ne lui est associé actuellement. « Utilisateur » sera dans cet état avant qu'un appel « AssociateFaces » réussi ne soit effectué.
+ MISE À JOUR - Indique que « l'utilisateur » est mis à jour pour refléter les nouveaux associated/disassociated visages et qu'il deviendra ACTIF dans quelques secondes. Les résultats de recherche peuvent contenir « Utilisateur » dans cet état et les clients peuvent choisir de l’ignorer dans les résultats renvoyés.
+ ACTIF : indique que le nom **« utilisateur **»**** est mis à jour pour refléter tous les associated/disassociated visages et qu'il est dans un état consultable.
```
{
"UnsuccessfulFaceAssociations": [
{
"Reasons": [
"LOW_MATCH_CONFIDENCE"
],
"FaceId": "f5817d37-94f6-0000-bfee-1a2b3c4d5e6f",
"Confidence": 0.9375374913215637
},
{
"Reasons": [
"ASSOCIATED_TO_A_DIFFERENT_IDENTITY"
],
"FaceId": "851cb847-dccc-1111-bfee-1a2b3c4d5e6f",
"UserId": "demoUser2"
}
],
"UserStatus": "UPDATING",
"AssociatedFaces": [
{
"FaceId": "35ebbb41-7f67-2222-bfee-1a2b3c4d5e6f"
}
]
}
```