文档简介：
GET Object
GET操作用来检索在OOS中的对象信息，执行GET操作，用户必须对object所在的bucket有读权限。如果Bucket是public read的权限，匿名用户也可以通过非授权的方式进行读操作。
请求语法
|
GET /ObjectName HTTP/1.1 Host: BucketName.oos-cn.ctyunapi.cn Date: date Authorization: signatureValue |
请求变量
|
变量 |
描述 |
是否必须 |
|
response-content-type |
设置返回头中的Content-Type。 |
否 |
|
response-content-language |
设置返回头中的Content-Language。 |
否 |
|
response-cache-control |
设置返回头中的Cache-Control |
否 |
|
response-content-disposition |
设置返回头中的Content-Disposition 注：OOS会把response-content-disposition中的值设置到响应头Content-Disposition中。对于不同的浏览器，此值的编码方式可能不同，此工作由客户端来完成。例如对于IE浏览器，要设置下载的文件名为”文件.txt”，那么response-content-disposition要设置为attachment;filename=URLEncoder.encode(URLEncoder.encode("文件.txt",”UTF-8”), ”UTF-8”) |
否 |
|
response-content-encoding |
设置返回头中的Content-Encoding |
否 |
|
response-expires |
设置返回头中的Expires |
否 |
|
x-amz-limitrate |
对象下载限制的速率。取值为大于0的正整数，单位是KiB/s。 注意：x-amz-limitrate和x-amz-limit只能二选一。 |
否 |
|
x-amz-limit |
对象下载限制的速率。 格式为： l x-amz-limit:rate=xxx l x-amz-limit:concurrency=xxx l x-amz-limit:rate=xxx, concurrency=xxx 其中 l rate为速率，取值为大于128的正整数，单位是KiB/s； l concurrency为并发连接数。取值为大于0的正整数。 注意：x-amz-limit和x-amz-limitrate只能二选一。 |
否 |
请求头格式
|
名称 |
描述 |
是否必须 |
|
Range |
下载指定范围内大小的一个对象 |
否 |
|
If-Modified-Since |
只返回一个在指定时间点后被修改的对象，否则返回304错误 |
否 |
|
If-Unmodified-Since |
返回一个在指定时间点后未被修改的对象，否则返回412错误 |
否 |
|
If-Match |
当对象的ETag与指定值一致时，返回此对象。否则返回412错误 |
否 |
|
If-None-Match |
当对象的ETag与指定值不一致时，返回此对象。否则返回304错误 |
否 |
|
x-amz-limitrate |
对象下载限制的速率。取值为大于0的正整数，单位是KiB/s。 注意：x-amz-limitrate和x-amz-limit只能二选一。 |
否 |
|
x-amz-limit |
对象下载限制的速率。 格式为： l x-amz-limit:rate=xxx l x-amz-limit:concurrency=xxx l x-amz-limit:rate=xxx, concurrency=xxx 其中 l rate为速率，取值为大于128的正整数，单位是KiB/s； l concurrency为并发连接数。取值为大于0的正整数。 注意：x-amz-limit和x-amz-limitrate只能二选一。 |
否 |
响应头
|
变量 |
描述 |
|
x-amz-expiration |
如果对象被配置了到期时间，那么OOS返回此响应头。这个响应头包含键值对expiry-date和rule-id。rule-id的值是URL编码的。 |
|
x-ctyun-metadata-location |
获取对象的索引位置。 类型：枚举 取值：ChengDu、FuZhou、GuiYang、HangZhou、LaSa、LanZhou、QingDao、ShenYang、ShenZhen、WuHan、WuHu、WuLuMuQi、ZhengZhou |
|
x-ctyun-data-location |
获取Bucket的数据位置。 类型：枚举 取值：ChengDu、GuiYang、LaSa、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou |
|
x-amz-storage-class |
对象的存储类型，如果存储类型为STANDARD，则不返回此参数。 类型：String 取值： l REDUCED_REDUNDANCY：低冗余存储 l STANDARD_IA：低频访问存储 |
请求示例
下面示例中返回对象my-image.jpg
|
GET /my-image.jpg HTTP/1.1 Host: bucket.oos-cn.ctyunapi.cn Date: Mon, 03Sep 2012 22:32:00 GMT Authorization: AWS 7799e793ce4624ee7e5a:xQE0diMbLRepdf3YB+FIEXAMPLE= |
返回示例
|
HTTP/1.1 200 OK x-amz-request-id: 318BC8BC148832E5 Date: Mon, 03 Sep 2012 22:32:00 GMT Last-Modified: Sat, 01 Sep 2012 17:50:00 GMT ETag: "fba9dede5f27731c9771645a39863328" Content-Length: 434234 Content-Type: image/ipeg Connection: close Server: CTYUN
[434234 bytes of object data] |
