ListImageHashes
Returns a list of image hashes that exist in a specified database.
Type: synchronous
Parameter | Description | Required |
---|---|---|
database
|
The name of the database that contains the image hashes to list. | Yes |
identifier
|
A comma-separated list of identifiers to specify the image hashes to list. If you do not set this parameter, Media Server lists all of the image hashes in the specified database. | No |
imagestatus
|
A Boolean value (default false) that specifies whether to return the status of the training image associated with each hash. The status for an image is always trained , but you can use this parameter to see the image label and whether the image data is present in the database or has been removed. |
No |
maxresults
|
The maximum number of image hashes to list. | No |
metadata
|
A Boolean value (default false) that specifies whether to return the metadata associated with each image hash. | No |
start
|
The starting point for the list when you set the maxresults parameter. For example, to start listing entries from the tenth entry in the database, set start=10 . The entries in the database are indexed from 1. |
No |
Example
The following example lists up to 10 image hashes contained in the ImageHashes
database:
/action=ListImageHashes&database=ImageHashes &imagestatus=TRUE &metadata=TRUE &start=1 &maxresults=10
Response
The response includes the identifier for each image hash. The numimages
element always has the value 1
, because you can add only one image to each hash. The image hash is always trained so numtrained
, numfailed
, and numuntrained
always have the values 1
, 0
, and 0
respectively.
If you set the action parameter imagestatus
to true
, Media Server returns information about each training image. The label
element provides the label associated with the image. The status
element always has the value trained
. The hasimagedata
element indicates whether the training image is saved in the database (the image data can be removed with the action NullImageHashImageData).
If you set the action parameter metadata
to true
, Media Server returns any custom metadata that you have added to the image hashes.
<autnresponse> <action>LISTIMAGEHASHES</action> <response>SUCCESS</response> <responsedata> <entry> <identifier>6d8e53fd92e601a4b8948e1b9397e381</identifier> <numimages>1</numimages> <numtrained>1</numtrained> <numfailed>0</numfailed> <numuntrained>0</numuntrained> <images> <image> <label>image1</label> <status>trained</status> <hasimagedata>true</hasimagedata> </image> </images> <metadata> <item> <key>importance</key> <value>high</value> </item> ... </metadata> </entry> </responsedata> </autnresponse>