Search (SHIFT+S)
ECS Management API
ECS Object Service API
-
Amazon S3
- S3 Bucket
- S3 Bucket ACL
- S3 Bucket Cors
- S3 Bucket Empty Status Operations
- S3 Bucket Is Stale Allowed
- S3 Bucket Lifecycle
- S3 Bucket List Fanout (Cloud DVR)
- S3 Bucket List Uploads
- S3 Bucket Location
- S3 Bucket Lock Configuration Operations
- S3 Bucket Object Lock Operations
- 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 Detailed Replication Status Operations
- S3 Object Init Uploads
- S3 Object Legal Hold Operations
- S3 Object Replication Info Operations
- S3 Object Retention Operations
- S3 Object Tagging Operations
- S3 Object Uploads
- S3 Options
- S3 Ping
- S3 Retention Update Operation
- S3 Select Operations
- 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
Examples
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.