此操作用來檢索在OOS中的文件信息，執行此操作，用戶必須對Object所在的Bucket有讀權限。如果Bucket是public-read或public-read-write的權限，匿名用戶也可以通過非授權的方式進行讀操作。
注意
基于安全合規要求，禁止通過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、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
