Open topic with navigation

# ListObjects

Returns a list of objects in a specified database. The action can also return information about the images, training options, and metadata associated with each object.

Type: synchronous

Parameter | Description | Required
--- | --- | ---
`database` | The name of the database that contains the objects. | Yes
`identifier` | A comma-separated list of identifiers to specify the objects to list. If you do not set this parameter, Media Server lists all of the objects in the specified database. | No
`imagestatus` | A Boolean value (default false) that specifies whether to return the label and training status of each image associated with each object. | No
`maxresults` | The maximum number of objects to return. | No
`metadata` | A Boolean value (default false) that specifies whether to return the metadata associated with each object. | No
`start` | The starting point for the list when you set the `maxresults` parameter. For example, to start listing objects from the tenth object in the database, set `start=10`. The entries in the database are indexed from 1. | No
`trainingoptions` | A Boolean value (default false) that specifies whether to return the training options set for each object. | No

## Example

The following example lists up to 10 objects contained in the `CompanyLogos` database:

    /action=ListObjects&database=CompanyLogos
                       &imagestatus=TRUE
                       &metadata=TRUE
                       &trainingoptions=TRUE
                       &start=1
                       &maxresults=10

## Response

The response always includes:

- The identifier for each object that is returned.
- The number of training images associated with each object.
- The number of images associated with each object that have been trained (the number that are used for object recognition).
- The number of images associated with each object where training failed.
- The number of images associated with each object that have not yet been trained.

    <autnresponse>
      <action>LISTOBJECTS</action>
      <response>SUCCESS</response>
      <responsedata>
        <entry>
          <identifier>HP</identifier>
          <numimages>3</numimages>
          <numtrainedimages>1</numtrainedimages>
          <numfailedimages>1</numfailedimages>
          <numuntrainedimages>1</numuntrainedimages>
          <images>
            <image>
              <label>image1</label>
              <status>trained</status>
            </image>
            <image>
              <label>image2</label>
              <status>untrained</status>
            </image>
            <image>
              <label>image3</label>
              <status>failed</status>
            </image>
          </images>
          <trainingoptions>
            <trainingoption>
              <key>usecolor</key>
              <value>false</value>
            </trainingoption>
          </trainingoptions>
          <metadata>
            <item>
              <key>CompanyName</key>
              <value>Hewlett Packard</value>
            </item>
          </metadata>
        </entry>
      </responsedata>
    </autnresponse>

© 2016 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close We welcome your comments! 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. Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm