Menu
Amazon Rekognition
Developer Guide

Deleting Faces from a Collection

You can use the DeleteFaces operation to delete faces from a collection. For more information, see Managing Faces in a Collection.

To delete faces from a collection

  1. If you haven't already:

    1. Create or update an IAM user with AmazonRekognitionFullAccess permissions. For more information, see Step 1: Set Up an AWS Account and Create an IAM User.

    2. Install and configure the AWS CLI and the AWS SDKs. For more information, see Step 2: Set Up the AWS CLI and AWS SDKs.

  2. Use the following examples to call the DeleteCollection operation.

    JavaAWS CLIPython.NET
    Java

    This example deletes a single face from a collection.

    Change the value of collectionId to the collection that contains the face that you want to delete. Change the value of faces to the ID of the face that you want to delete. To delete multiple faces, add the face IDs to the faces array.

    //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); } } }
    AWS CLI

    This AWS CLI command displays the JSON output for the delete-collection CLI operation. Replace the value of collection-id with the name of the collection that contains the face you want to delete. Replace the value of face-ids with an array of face IDs that you want to delete.

    aws rekognition delete-faces --collection-id "collectionname" --face-ids '["faceid"]'
    Python

    This example deletes a single face from a collection.

    Change the value of collectionId to the collection that contains the face that you want to delete. Change the value of faces to the ID of the face that you want to delete. To delete multiple faces, add the face IDs to the faces array.

    #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 if __name__ == "__main__": collectionId='MyCollection' faces=[] faces.append("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx") client=boto3.client('rekognition') response=client.delete_faces(CollectionId=collectionId, FaceIds=faces) print(str(len(response['DeletedFaces'])) + ' faces deleted:') for faceId in response['DeletedFaces']: print (faceId)
    .NET

    This example deletes a single face from a collection.

    Change the value of collectionId to the collection that contains the face that you want to delete. Change the value of faces to the ID of the face that you want to delete. To delete multiple faces, add the face IDs to the faces list.

    //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<String> faces = new List<String>() { "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 Operation Request

The input to DeleteFaces is the ID of the collection that contains the faces, and an array of face IDs for the faces to be deleted.

{ "CollectionId": "MyCollection", "FaceIds": [ "daf29cac-f910-41e9-851f-6eeb0e08f973" ] }

DeleteFaces Operation Response

The DeleteFaces response contains an array of face IDs for the faces that were deleted.

{ "DeletedFaces": [ "daf29cac-f910-41e9-851f-6eeb0e08f973" ] }