此操作用来检索在OOS中的文件信息，执行此操作，用户必须对Object所在的Bucket有读权限。如果Bucket是public-read的权限，匿名用户也可以通过非授权的方式进行读操作。
注意
基于安全合规要求，禁止通过OOS默认域名以匿名或URL签名方式下载后缀为apk、ipa的文件，在Header中包含签名或者通过自定义域名方式下载此类文件不受影响。
请求语法
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只能二选一。 类型：字符串 取值：格式为：
其中
| 否 |
请求头
| 名称 | 描述 | 是否必须 |
|---|---|---|
| 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-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
