此操作用来检索在OOS中的文件信息,执行此操作,用户必须对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 文件下载限制的速率。
注意x-amz-limitrate和x-amz-limit只能二选一。
类型:字符串。
取值:取值为大于0的正整数,单位是KiB/s。
否 x-amz-limit 文件下载限制的速率。
注意x-amz-limit和x-amz-limitrate只能二选一。
类型:字符串
取值:格式为:
x-amz-limit:rate=xxx
x-amz-limit:concurrency=xxx
x-amz-limit:rate=xxx, concurrency=xxx
其中
rate为速率,取值为大于0的正整数,单位是KiB/s。当取值是大于0小于128的整数时,按速率等于128KiB/s处理。
concurrency为并发连接数。取值为大于0的正整数。
否
请求头
名称 描述 是否必须 Range 指定下载文件的字节范围。
类型:字符串。
否 If-Modified-Since 只返回一个在指定时间点后被修改的文件,否则返回304错误
类型:字符串。
否 If-Unmodified-Since 返回一个在指定时间点后未被修改的文件,否则返回412错误。
类型:字符串。
否 If-Match 当文件的ETag与指定值一致时,返回此文件。否则返回412错误。
类型:字符串。
否 If-None-Match 当文件的ETag与指定值不一致时,返回此文件。否则返回304错误。
类型:字符串。
否 x-amz-limitrate 文件下载限制的速率。
注意x-amz-limitrate和x-amz-limit只能二选一。
类型:字符串。
取值:大于0的正整数,单位是KiB/s。
否 x-amz-limit 文件下载限制的速率。
注意x-amz-limit和x-amz-limitrate只能二选一。
类型:字符串
取值:格式为:
x-amz-limit:rate=xxx
x-amz-limit:concurrency=xxx
x-amz-limit:rate=xxx, concurrency=xxx
其中
rate为速率,取值为大于0的正整数,单位是KiB/s。当取值是大于0小于128的整数时,按速率等于128KiB/s处理。
concurrency为并发连接数。取值为大于0的正整数。
否
响应头
变量 | 描述 |
---|---|
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、SH2、SuZhou;对于对象存储网络2,取值为:NeiMeng1、HangZhou1。 |
x-ctyun-data-location | 获取文件的数据位置。香港节点不会返回此项。 类型:枚举。 取值:对于对象存储网络,取值:ChengDu、GuiYang、LaSa、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou;对于对象存储网络2,取值为:NeiMeng1、HangZhou1。 |
x-amz-meta-* | 以该前缀开头的用户定义的元数据响应头。每一个都作为一组键值对存储和返回。OOS不验证或解释用户定义的元数据。 类型:字符串。 |
x-amz-storage-class | 文件的存储类型,如果存储类型为STANDARD,则不返回此参数。 类型:字符串。 取值:STANDARD_IA:低频访问存储。 |
请求示例
GET /test.txt HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Authorization: SignatureValue
Date: Mon, 15 Nov 2021 06:39:40 GMT
Content-Type: application/octet-stream
Connection: Keep-Alive
响应示例
HTTP/1.1 200 OK
Content-Length: 1467326
Date: Mon, 15 Nov 2021 06:39:40 GMT
x-amz-request-id: 75d41c3c69fa4ad968d4d8dfe7dfe1e7a6a8ab9c9ea0a2a4a6
ETag: "5db44ee68a1e577907c2699c8f582107"
Last-Modified: Mon, 15 Nov 2021 06:39:39 GMT
Content-Type: application/x-java-archive
Content-MD5: XbRO5ooeV3kHwmmcj1ghBw==
x-ctyun-metadata-location: ChengDu
x-ctyun-data-location: ZhengZhou
Server: CTYUN