Open topic with navigation

# List the Faces in a Database

To list the faces that you have added to a database, and check whether training was successful, use the following procedure.

To list the faces in a database

1. (Optional) First list the databases that have been created to store faces. Use the action `ListFaceDatabases`:

       http://localhost:14000/action=ListFaceDatabases

   HPE Media Server returns a list of databases that you have created to store faces.

2. List the faces that exist in one of the databases. Use the action `ListFaces`, for example:

       http://localhost:14000/action=ListFaces&database=faces
                                              &metadata=true
                                              &imagestatus=true

   HPE Media Server returns a list of faces in the specified database, and the number of training images associated with each face.

   If you set the action parameter `metadata` to `true`, HPE Media Server returns the metadata you have added to a face.

   If you set the action parameter `imagestatus` to `true`, HPE Media Server returns the status of each training image associated with each face.

   - The `status` element indicates the status of training:

     - `trained` indicates that training was successful.
     - `untrained` indicates that training has not been attempted. Run training for the face using the action `BuildFace`, or run training for all faces that have incomplete training using the action `BuildAllFaces`.
     - `failed` indicates that HPE Media Server could not use the image for training. For example, if HPE Media Server does not detect a face in an image, it cannot be used as a training image. Remove the failed image using the action `RemoveFaceImages`.
   - The `hasimagedata` element indicates whether the training image is stored in the database. If the value of this element is `false`, the image has been removed from the database by the action `NullFaceImageData`. Images that have been removed and have a status of `untrained` cannot be trained, so HPE recommends you remove these images with the action `RemoveFaceImages`.

© 2017 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to AutonomyTPFeedback@hpe.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm