Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Associazione di volti a un utente
È possibile utilizzare l'[AssociateFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_AssociatingFaces.html)operazione per associare più volti singoli a un singolo utente. Per associare un volto a un utente, devi prima creare una raccolta e un utente. Nota che i vettori di volti devono risiedere nella stessa raccolta in cui risiede il vettore utente.
**Per associare volti (SDK)**
1. Se non lo hai già fatto:
1. Crea o aggiorna un utente con le autorizzazioni `AmazonRekognitionFullAccess`. Per ulteriori informazioni, consulta [Fase 1: impostazione di un account AWS e creazione di un utente](setting-up.md#setting-up-iam).
1. Installa e configura il AWS CLI e il AWS SDKs. Per ulteriori informazioni, consulta [Passaggio 2: configura AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Utilizzare i seguenti esempi per richiamare l'operazione `AssociateFaces`.
------
#### [ Java ]
Questo esempio di codice Java associa un volto a un utente.
```
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 ]
Questo AWS CLI comando associa un volto a un utente, utilizzando l'operazione `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 ]
Questo esempio di codice Python associa un volto a un utente.
```
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 risposta all'operazione
La risposta per `AssociateFaces` include lo `UserStatus`, che è lo stato della richiesta di dissociazione, oltre a un elenco di `FaceIds` da associare. Viene inoltre restituito un elenco di `UnsuccessfulFaceAssociations`. Dopo aver inviato una richiesta di `AssociateFaces`, il completamento dell'operazione potrebbe richiedere circa un minuto.
Per questo motivo, UserStatus viene restituito, che può avere i seguenti valori:
+ CREATO: indica che l'"Utente" è stato creato correttamente e che attualmente non ha alcun volto associato. L' 'utente' si troverà in questo stato prima che venga effettuata una chiamata AssociateFaces '' riuscita.
+ AGGIORNAMENTO: indica che l' "Utente» viene aggiornato per riflettere i nuovi associated/disassociated volti e diventerà ATTIVO in pochi secondi. I risultati di ricerca possono contenere "Utente" in questo stato e i clienti possono scegliere di ignorarlo nei risultati restituiti.
+ ATTIVO: indica che l'**"Utente**»**** è stato aggiornato per riflettere tutti i associated/disassociated volti ed è in uno stato ricercabile.
```
{
"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"
}
]
}
```