Cloud Enterprise Object Storage REST API

Search (SHIFT+S)




List Objects With Tags

GET /rest/objects

Retrieves all object IDs indexed by a listable tag. You can specify only one tag name/hierarchy on each operation. Namespace interface not supported.

URL Format

/rest/objects

Request Headers

"Content-Length" required
"x-emc-date" required
"x-emc-uid" required
"x-emc-signature" required
"x-emc-utf8" requiredOnly required if metadata values are in Unicode.
"x-emc-wschecksum" requiredRequired if the application must conform to SEC 17a-4f standards.
"x-emc-listable-meta" optionalor "x-emc-meta"
"x-emc-groupacl" optionalor "x-emc-useracl"

Response Body

Field Description Type Notes
ListObjectsResponse
Object     0-* Elements
ObjectID String
SystemMetadataList
UserMetadataList
token String

XML Example

Request
GET /rest/objects HTTP/1.1
accept: */*
date: Wed, 15 Feb 2017 16:39:49 GMT content-type: application/octet-stream x-emc-date: Wed, 15 Feb 2017 16:39:49 GMT x-emc-tags: part4/part7/part8
host: 168.159.116.96
x-emc-uid: 33115732f3b7455d9d2344ddd235f4b9/user1 x-emc-signature: ZllFtIyYe6kvqibS9eqcIBpiQ7I= x-emc-include-meta: 0
Response
HTTP/1.1 200 OK
Date: Wed, 15 Feb 2017 16:39:49 GMT
Server: Apache
Content-Length: 359
Connection: close
Content-Type: text/xml
x-emc-policy: _int
<?xml version='1.0' encoding='UTF-8'?>
<ListObjectsResponse xmlns='http://www.emc.com/cos/'>
<Object>
<ObjectID>499ad542a2a8bc200499ad5a7099940499b44f51e97d
    </ObjectID>
</Object>
<Object>
 <ObjectID>499ad542a1a8bc200499ad5a6b05580499b44f5aff04
  </ObjectID>
   </Object>
<Object>
 <ObjectID>499ad542a2a8bc200499ad5a7099940499b44f779a5
     4</ObjectID>
</Object>
</ListObjectsResponse>