Open topic with navigation

# BuildAllFaces

Trains HPE Media Server to recognize any faces that exist in its database and have incomplete or out-of-date training (any faces that have one or more images with a status of `untrained`). For example, you must re-train a face if you add new face images.

Type: asynchronous

Parameter | Description | Required
--- | --- | ---
`database` | The name of a database to process. Set this parameter to train HPE Media Server to recognize faces in the specified database only. By default, this action trains HPE Media Server to recognize faces in all databases. | No
`numparallel` | The maximum number of threads that the action can use (default 1). | No

## Example

    /action=BuildAllFaces

    /action=BuildAllFaces&numparallel=2

## Response

This action is asynchronous, so HPE Media Server always returns success accompanied by a token:

    <autnresponse>
      <action>BUILDALLFACES</action>
      <response>SUCCESS</response>
      <responsedata>
        <token>MTYuMjguOTQuMTcyOjE4MDAwOkJVSUxEQUxMRkFDRVM6MTQ0ODkwMjM3MDM4MjAxMTM1Mzg4MTc1</token>
      </responsedata>
    </autnresponse>

You can use this token with the QueueInfo action to retrieve the status of the action:

    <autnresponse>
      <action>QUEUEINFO</action>
      <response>SUCCESS</response>
      <responsedata>
        <actions>
          <action>
            <status>Finished</status>
            <queued_time>2015-Nov-30 16:52:51</queued_time>
            <time_in_queue>0</time_in_queue>
            <process_start_time>2015-Nov-30 16:52:51</process_start_time>
            <time_processing>1</time_processing>
            <process_end_time>2015-Nov-30 16:52:52</process_end_time>
            <entry>
              <build>
                <image>
                  <index>1</index>
                  <label>expression_neutral</label>
                  <status>trained</status>
                </image>
              </build>
              <database>politicians</database>
              <identifier>president</identifier>
              <numimages>1</numimages>
              <numtrained>1</numtrained>
            </entry>
            <token>MTYuMjguOTQuMTcyOjE4MDAwOkJVSUxEQUxMRkFDRVM6MTQ0ODkwMjM3MDM4MjAxMTM1Mzg4MTc1</token>
          </action>
        </actions>
      </responsedata>
    </autnresponse>

© 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