Search (SHIFT+S)
ECS Management API
ECS Object Service API
-
Amazon S3
- S3 Bucket
- S3 Bucket ACL
- S3 Bucket Cors
- S3 Bucket Is Stale Allowed
- S3 Bucket Lifecycle
- S3 Bucket List Uploads
- S3 Bucket Location
- S3 Bucket Policy
- S3 Bucket Versioning
- S3 Bucket Versions
- S3 Data Node
- S3 Metadata Key List
- S3 Metadata Key System List
- S3 Metadata Search
- S3 Multi Object Delete
- S3 Object
- S3 Object ACL
- S3 Object Init Uploads
- S3 Object Replication Info Operations
- S3 Object Tagging Operations
- S3 Object Uploads
- S3 Options
- S3 Ping
- S3 Retention Update Operation
- EMC Atmos
- OpenStack Swift
ECS API Changes
Read Object
GET /rest/objects/objectID
Get object with the object interface.
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" | required | Only required if metadata values are in Unicode. |
| "x-emc-wschecksum" | required | Required if the application must conform to SEC 17a-4f standards. |
| "x-emc-listable-meta" | optional | or "x-emc-meta" |
| "x-emc-groupacl" | optional | or "x-emc-useracl" |
Response Body
XML Example
Request
> GET /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:Fri, 24 Feb 2017 21:38:48 GMT > x-emc-uid:b078f1e44dbc424dbe93fc000c527d5a/atmos_usr > x-emc-signature:SizPUnSZRvE0QFmcsFLWfy6Nprg=
Response
< HTTP/1.1 200 OK < Date: Fri, 24 Feb 2017 21:38:49 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:25dcd:0 < 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.