Cloud Enterprise Object Storage REST API

Search (SHIFT+S)




Head Object

HEAD /rest/objects/objectID

Identical to GET but does not return a message body.

URL Format

/rest/objects/objectID

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"

Request Payload

No Request Payload


Response Body


XML Example

Request
> HEAD /rest/objects/0460803141287f13f2cee0b6f592888f5b17ef8b02f4b25c4c3254e2243d5be4-f8ca6177-3d32-4692-91f6-60d902745d3d HTTP/1.1
> Host: 192.168.0.0:9022
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type:text/plain
> x-emc-date:Tue, 21 Feb 2017 18:25:17 GMT
> x-emc-uid:b078f1e44dbc424dbe93fc000c527d5a/atmos_usr
> x-emc-signature:x29BoqaVFwJst7UxaKFkMLjfdwA=
Response
< HTTP/1.1 200 OK
< Date: Tue, 21 Feb 2017 18:25:18 GMT
< x-emc-mtime: 1487699769224
< x-emc-meta: acl-cache-retention-flag=true,allow-inline-update=true,atime=2017-02-17T23:57:12Z,ctime=2017-02-21T17:56:09Z,ctype=text/plain,data-range=CAAQCQ==,dek=0/VcYYBsmtGPCOQl7Cf2sstaMa1WurCTsmZsZhtQm3kK2lA4pi09XQ==,dekAlgo=AESKeyWrapRFC5649,etag=0-,fs-mtime-millisec=1487699769224,itime=2017-02-17T23:57:12Z,kekId=s3.b078f1e44dbc424dbe93fc000c527d5a0e2830b65e62bcb53c66bd2bbd0385913d504d5b087ad2eade023b9fce3c67a0,keypoolid=s3.b078f1e44dbc424dbe93fc000c527d5a,keypoolname=b078f1e44dbc424dbe93fc000c527d5a,keyversion=0,mtime=2017-02-21T17:56:09Z,namespace=s3,nlink=1,object-name=file.txt,objectid=0460803141287f13f2cee0b6f592888f5b17ef8b02f4b25c4c3254e2243d5be4-f8ca6177-3d32-4692-91f6-60d902745d3d,objname=file.txt,parentOid=71dabff2d43ed9a9515724f89b6e907b12705bfa05e7103860de1f17bbad9447,parentZone=urn:storageos:VirtualDataCenterData:f8ca6177-3d32-4692-91f6-60d902745d3d,policyname=default,retention=,size=0,type=regular,uid=atmos_usr,parent=apache,gid=apache
< x-emc-useracl: b078f1e44dbc424dbe93fc000c527d5a/atmos_usr=WRITE,atmos_usr=FULL_CONTROL
< x-emc-groupacl: other=READ
< x-emc-policy: default
< x-emc-request-id: 0af9f566:15a43dc3b15:19739:0
< Content-Type: text/plain
< Content-Length: 0
< Server: ViPR/1.0