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.
# Suppression de visages d’une collection
Vous pouvez utiliser l'opération [DeleteFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteFaces.html) pour supprimer des visages d'une collection. Pour de plus amples informations, veuillez consulter [Gestion des visages dans une collection](managing-face-collections.md#collections-index-faces).
**Pour supprimer des visages d’une collection**
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 AWS CLI les AWS SDK. Pour de plus amples informations, veuillez consulter [Étape 2 : configurer le AWS CLI and AWS Kits SDK](setup-awscli-sdk.md).
1. Utilisez les exemples suivants pour appeler l’opération `DeleteFaces`.
------
#### [ Java ]
Dans cet exemple, seul un visage est supprimé d’une collection.
Remplacez la valeur de `collectionId` par la collection qui contient le visage que vous souhaitez supprimer. Remplacez la valeur de `faces` par l’ID du visage que vous souhaitez supprimer. Pour supprimer plusieurs visages, ajoutez les ID de visage au tableau `faces`.
```
//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.)
package aws.example.rekognition.image;
import com.amazonaws.services.rekognition.AmazonRekognition;
import com.amazonaws.services.rekognition.AmazonRekognitionClientBuilder;
import com.amazonaws.services.rekognition.model.DeleteFacesRequest;
import com.amazonaws.services.rekognition.model.DeleteFacesResult;
import java.util.List;
public class DeleteFacesFromCollection {
public static final String collectionId = "MyCollection";
public static final String faces[] = {"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"};
public static void main(String[] args) throws Exception {
AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient();
DeleteFacesRequest deleteFacesRequest = new DeleteFacesRequest()
.withCollectionId(collectionId)
.withFaceIds(faces);
DeleteFacesResult deleteFacesResult=rekognitionClient.deleteFaces(deleteFacesRequest);
List < String > faceRecords = deleteFacesResult.getDeletedFaces();
System.out.println(Integer.toString(faceRecords.size()) + " face(s) deleted:");
for (String face: faceRecords) {
System.out.println("FaceID: " + face);
}
}
}
```
------
#### [ Java V2 ]
Ce code est extrait du GitHub référentiel d'exemples du SDK de AWS documentation. Voir l’exemple complet [ici](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javav2/example_code/rekognition/src/main/java/com/example/rekognition/DeleteFacesFromCollection.java).
```
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.rekognition.RekognitionClient;
import software.amazon.awssdk.services.rekognition.model.DeleteFacesRequest;
import software.amazon.awssdk.services.rekognition.model.RekognitionException;
// snippet-end:[rekognition.java2.delete_faces_collection.import]
/**
* Before running this Java V2 code example, set up your development environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class DeleteFacesFromCollection {
public static void main(String[] args) {
final String usage = "\n" +
"Usage: " +
" \n\n" +
"Where:\n" +
" collectionId - The id of the collection from which faces are deleted. \n\n" +
" faceId - The id of the face to delete. \n\n";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String collectionId = args[0];
String faceId = args[1];
Region region = Region.US_EAST_1;
RekognitionClient rekClient = RekognitionClient.builder()
.region(region)
.credentialsProvider(ProfileCredentialsProvider.create("profile-name"))
.build();
System.out.println("Deleting collection: " + collectionId);
deleteFacesCollection(rekClient, collectionId, faceId);
rekClient.close();
}
// snippet-start:[rekognition.java2.delete_faces_collection.main]
public static void deleteFacesCollection(RekognitionClient rekClient,
String collectionId,
String faceId) {
try {
DeleteFacesRequest deleteFacesRequest = DeleteFacesRequest.builder()
.collectionId(collectionId)
.faceIds(faceId)
.build();
rekClient.deleteFaces(deleteFacesRequest);
System.out.println("The face was deleted from the collection.");
} catch(RekognitionException e) {
System.out.println(e.getMessage());
System.exit(1);
}
}
// snippet-end:[rekognition.java2.delete_faces_collection.main]
}
```
------
#### [ AWS CLI ]
Cette AWS CLI commande affiche la sortie JSON pour l'opération `delete-faces` CLI. Remplacez la valeur de `collection-id` par le nom de la collection qui contient le visage que vous souhaitez supprimer. Remplacez la valeur de `face-ids` par le tableau des ID de visages que vous souhaitez supprimer. Remplacez la valeur de `profile_name` dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur.
```
aws rekognition delete-faces --collection-id "collection-id" --face-ids "faceid" --profile profile-name
```
------
#### [ Python ]
Dans cet exemple, seul un visage est supprimé d’une collection.
Remplacez la valeur de `collectionId` par la collection qui contient le visage que vous souhaitez supprimer. Remplacez la valeur de `faces` par l’ID du visage que vous souhaitez supprimer. Pour supprimer plusieurs visages, ajoutez les ID de visage au tableau `faces`. Remplacez la valeur de `profile_name` dans la ligne qui crée la session de Rekognition par le nom de votre profil de développeur.
```
# 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
def delete_faces_from_collection(collection_id, faces):
session = boto3.Session(profile_name='profile-name')
client = session.client('rekognition')
response = client.delete_faces(CollectionId=collection_id,
FaceIds=faces)
print(str(len(response['DeletedFaces'])) + ' faces deleted:')
for faceId in response['DeletedFaces']:
print(faceId)
return len(response['DeletedFaces'])
def main():
collection_id = 'collection-id'
faces = []
faces.append("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
faces_count = delete_faces_from_collection(collection_id, faces)
print("deleted faces count: " + str(faces_count))
if __name__ == "__main__":
main()
```
------
#### [ .NET ]
Dans cet exemple, seul un visage est supprimé d’une collection.
Remplacez la valeur de `collectionId` par la collection qui contient le visage que vous souhaitez supprimer. Remplacez la valeur de `faces` par l’ID du visage que vous souhaitez supprimer. Pour supprimer plusieurs visages, ajoutez les ID de visage à la liste `faces`.
```
//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.)
using System;
using System.Collections.Generic;
using Amazon.Rekognition;
using Amazon.Rekognition.Model;
public class DeleteFaces
{
public static void Example()
{
String collectionId = "MyCollection";
List faces = new List() { "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" };
AmazonRekognitionClient rekognitionClient = new AmazonRekognitionClient();
DeleteFacesRequest deleteFacesRequest = new DeleteFacesRequest()
{
CollectionId = collectionId,
FaceIds = faces
};
DeleteFacesResponse deleteFacesResponse = rekognitionClient.DeleteFaces(deleteFacesRequest);
foreach (String face in deleteFacesResponse.DeletedFaces)
Console.WriteLine("FaceID: " + face);
}
}
```
------
## DeleteFaces demande d'opération
La valeur d’entrée de `DeleteFaces` est l’ID de la collection qui contient les visages, ainsi qu’un tableau d’ID correspondant aux visages à supprimer.
```
{
"CollectionId": "MyCollection",
"FaceIds": [
"daf29cac-f910-41e9-851f-6eeb0e08f973"
]
}
```
## DeleteFaces réponse à l'opération
La réponse `DeleteFaces` contient un tableau d’ID correspondant aux visages qui ont été supprimés.
```
{
"DeletedFaces": [
"daf29cac-f910-41e9-851f-6eeb0e08f973"
]
}
```
Si les identifiants faciaux fournis dans la saisie sont actuellement associés à un utilisateur, ils seront renvoyés UnsuccessfulFaceDeletions avec des raisons valables.
```
{
"DeletedFaces": [
"daf29cac-f910-41e9-851f-6eeb0e08f973"
],
"UnsuccessfulFaceDeletions" : [
{
"FaceId" : "0b683aed-a0f1-48b2-9b5e-139e9cc2a757",
"UserId" : "demoUser1",
"Reason" : ["ASSOCIATED_TO_AN_EXISTING_USER"]
}
]
}
```