Cloud Enterprise Object Storage REST API

Search (SHIFT+S)




Read Root Object

GET /rest/namespace/path

Get object with the namespace interface.

URL Format

/rest/namespace/path

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


XML Example

Request
> GET /rest/namespace/bucket/file.txt HTTP/1.1
> Host: 192.168.0.0:9022
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type:text/plain
> x-emc-date:Fri, 24 Feb 2017 21:39:09 GMT
> x-emc-uid:b078f1e44dbc424dbe93fc000c527d5a/atmos_usr
> x-emc-signature:tt+iOo0MJFmEIgDPPeDbuELbBQk=
Response
< HTTP/1.1 200 OK
< Date: Fri, 24 Feb 2017 21:39:09 GMT
< x-emc-mtime: 1487804155330
< x-emc-meta: acl-cache-retention-flag=true,allow-inline-update=false,atime=2017-02-17T23:57:12Z,ctime=2017-02-22T22:55:55Z,ctype=text/plain,data-range=CAAQCQ==,dek=0/VcYYBsmtGPCOQl7Cf2sstaMa1WurCTsmZsZhtQm3kK2lA4pi09XQ==,dekAlgo=AESKeyWrapRFC5649,etag=5-,fs-mtime-millisec=1487804155330,itime=2017-02-17T23:57:12Z,kekId=s3.b078f1e44dbc424dbe93fc000c527d5a0e2830b65e62bcb53c66bd2bbd0385913d504d5b087ad2eade023b9fce3c67a0,keypoolid=s3.b078f1e44dbc424dbe93fc000c527d5a,keypoolname=b078f1e44dbc424dbe93fc000c527d5a,keyversion=0,mtime=2017-02-22T22:55:55Z,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=9,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:25848:4
< Content-Type: text/plain
< Content-Length: 9
< Server: ViPR/1.0
<
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.