GetObject__關於Object操作_API 參考_對象存儲 OSS-阿裏雲

用於獲取某個Object，此操作要求用戶對該Object有讀權限。

請求語法

GET /ObjectName HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Range: bytes=ByteRange(可選)

請求參數(Request Parameters)

OSS支持用戶在發送GET請求時，可以自定義OSS返回請求中的一些Header，前提條件用戶發送的GET請求必須攜帶簽名。這些Header包括：

名稱	描述
response-content-type	設置OSS返回請求的content-type頭類型：字符串默認值：無
response-content-language	設置OSS返回請求的content-language頭類型：字符串默認值：無
response-expires	設置OSS返回請求的expires頭類型：字符串默認值：無
response-cache-control	設置OSS返回請求的cache-control頭類型：字符串默認值：無
response-content-disposition	設置OSS返回請求的content-disposition頭類型：字符串默認值：無
response-content-encoding	設置OSS返回請求的content-encoding頭類型：字符串默認值：無

請求Header

名稱	描述
Range	指定文件傳輸的範圍。如，設定 bytes=0-9，表示傳送第0到第9這10個字符。類型：字符串默認值：無
If-Modified-Since	如果指定的時間早於實際修改時間，則正常傳送文件，並返回200 OK；否則返回304 not modified 類型：字符串默認值：無時間格式：GMT時間，例如Fri, 13 Nov 2015 14:47:53 GMT
If-Unmodified-Since	如果傳入參數中的時間等於或者晚於文件實際修改時間，則正常傳輸文件，並返回200 OK；否則返回412 precondition failed錯誤類型：字符串默認值：無時間格式：GMT時間，例如Fri, 13 Nov 2015 14:47:53 GMT
If-Match	如果傳入期望的ETag和object的 ETag匹配，則正常傳輸文件，並返回200 OK；否則返回412 precondition failed錯誤類型：字符串默認值：無
If-None-Match	如果傳入的ETag值和Object的ETag不匹配，則正常傳輸文件,並返回200 OK；否則返回304 Not Modified 類型：字符串默認值：無

細節分析

GetObject通過range參數可以支持斷點續傳，對於比較大的Object建議使用該功能。
如果在請求頭中使用Range參數；則返回消息中會包含整個文件的長度和此次返回的範圍，例如：Content-Range: bytes 0-9/44，表示整個文件長度為44，此次返回的範圍為0-9。如果不符合範圍規範，則傳送整個文件，並且不在結果中提及Content-Range。
如果“If-Modified-Since”元素中設定的時間不符合規範，直接返回文件，並返回200 OK。
If-Modified-Since和If-Unmodified-Since可以同時存在，If-Match和If-None-Match也可以同時存在。
如果包含If-Unmodified-Since並且不符合或者包含If-Match並且不符合，返回412 precondition failed
如果包含If-Modified-Since並且不符合或者包含If-None-Match並且不符合，返回304 Not Modified
如果文件不存在返回404 Not Found錯誤。錯誤碼：NoSuchKey。
OSS不支持在匿名訪問的GET請求中，通過請求參數來自定義返回請求的header。
在自定義OSS返回請求中的一些Header時，隻有請求處理成功（即返回碼為200時），OSS才會將請求的header設置成用戶GET請求參數中指定的值。
若該Object為進行服務器端熵編碼加密存儲的，則在GET請求時會自動解密返回給用戶，並且在響應頭中，會返回x-oss-server-side-encryption，其值表明該Object的服務器端加密算法。
需要將返回內容進行 GZIP壓縮傳輸的用戶，需要在請求的Header中顯示方式加入 Accept-Encoding:gzip，OSS會根據文件的Content-Type和文件大小，判斷是否返回給用戶經過GZIP 壓縮的數據。如果采用了GZIP壓縮則不會附帶etag 信息。目前OSS支持GZIP壓縮的Content-Type為HTML、Javascript、CSS、XML、RSS、Json，文件大小需不小於1k。
如果文件類型為符號鏈接，返回目標文件的內容。並且，響應頭中Content-Length、ETag、Content-Md5 均為目標文件的元信息；Last-Modified是目標文件和符號鏈接的最大值；其他均為符號鏈接的元信息。
如果文件類型為符號鏈接，並且目標文件不存在，返回404 Not Found錯誤。錯誤碼：SymlinkTargetNotExist。
如果文件類型為符號鏈接，並且目標文件類型是符號鏈接，返回400 Bad request錯誤。錯誤碼：InvalidTargetType。
示例

請求示例：

GET /oss.jpg HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2012 06:38:30 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:UNQDb7GapEgJCZkcde6OhZ9Jfe8=

返回示例：

HTTP/1.1 200 OK
x-oss-request-id: 3a89276f-2e2d-7965-3ff9-51c875b99c41
x-oss-object-type: Normal
Date: Fri, 24 Feb 2012 06:38:30 GMT
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
ETag: "5B3C1A2E053D763E1B002CC607C5A0FE "
Content-Type: image/jpg
Content-Length: 344606
Server: AliyunOSS
[344606 bytes of object data]

Range請求示例：


GET //oss.jpg HTTP/1.1
Host:oss-example. oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Feb 2012 05:38:42 GMT
Range: bytes=100-900
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:qZzjF3DUtd+yK16BdhGtFcCVknM=
返回示例：
HTTP/1.1 206 Partial Content
x-oss-request-id: 28f6508f-15ea-8224-234e-c0ce40734b89
x-oss-object-type: Normal
Date: Fri, 28 Feb 2012 05:38:42 GMT
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
ETag: "5B3C1A2E053D763E1B002CC607C5A0FE "
Accept-Ranges: bytes
Content-Range: bytes 100-900/344606
Content-Type: image/jpg
Content-Length: 801
Server: AliyunOSS
[801 bytes of object data]
自定義返回消息頭的請求示例：

GET /oss.jpg?response-expires=Thu%2C%2001%20Feb%202012%2017%3A00%3A00%20GMT& response-content-type=text&response-cache-control=No-cache&response-content-disposition=attachment%253B%2520filename%253Dtesting.txt&response-content-encoding=utf-8&response-content-language=%E4%B8%AD%E6%96%87 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com:
Date: Fri, 24 Feb 2012 06:09:48 GMT
返回示例：
HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A64485981
x-oss-object-type: Normal
Date: Fri, 24 Feb 2012 06:09:48 GMT 
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
ETag: "5B3C1A2E053D763E1B002CC607C5A0FE "
Content-Length: 344606
Connection: keep-alive
Content-disposition: attachment; filename:testing.txt
Content-language: 中文
Content-encoding: utf-8
Content-type: text
Cache-control: no-cache
Expires: Fri, 24 Feb 2012 17:00:00 GMT
Server: AliyunOSS
[344606 bytes of object data]
符號鏈接的請求示例：

GET /link-to-oss.jpg HTTP/1.1
Accept-Encoding: identity
Date: Tue, 08 Nov 2016 03:17:58 GMT
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:qZzjF3DUtd+yK16BdhGtFcCVknM=
返回示例：
HTTP/1.1 200 OK
Server: AliyunOSS
Date: Tue, 08 Nov 2016 03:17:58 GMT
Content-Type: application/octet-stream
Content-Length: 20
Connection: keep-alive
x-oss-request-id: 582143E6D3436A212ADCC87D
Accept-Ranges: bytes
ETag: "8086265EFC0211ED1F9A2F09BF462227"
Last-Modified: Tue, 08 Nov 2016 03:17:58 GMT
x-oss-object-type: Symlink
Content-MD5: gIYmXvwCEe0fmi8Jv0YiJw==
 最後更新：2016-11-23 17:16:08
  上一篇： CopyObject__關於Object操作_API 參考_對象存儲 OSS-阿裏雲
  下一篇： AppendObject__關於Object操作_API 參考_對象存儲 OSS-阿裏雲
相關內容
 多執行計劃並行執行__執行計劃_用戶指南_E-MapReduce-阿裏雲
 企業郵箱 在Foxmail 7.0上POP3/IMAP協議設置方法__客戶端使用_郵箱常見問題_企業郵箱-阿裏雲
 AssumedRoleUser__數據類型_STS API文檔_訪問控製-阿裏雲
 SQLServerReader__Reader插件_使用手冊_數據集成-阿裏雲
 應用操作__JavaSDK手冊_SDK參考手冊_開放搜索-阿裏雲
 負載均衡計費常見問題___常見問題_負載均衡-阿裏雲
 查詢網絡帶寬__資源監控接口_API 手冊_CDN-阿裏雲
 網絡類型說明與使用場景__常見問題_專有網絡 VPC-阿裏雲
 日誌查詢工具__開發者工具_消息服務-阿裏雲
 並發測試示例代碼__Java SDK_SDK使用手冊_消息服務-阿裏雲
熱門內容
 常見錯誤說明__附錄_大數據計算服務-阿裏雲
 發送短信接口__API使用手冊_短信服務-阿裏雲
 接口文檔__Android_安全組件教程_移動安全-阿裏雲
 運營商錯誤碼（聯通）__常見問題_短信服務-阿裏雲
 設置短信模板__使用手冊_短信服務-阿裏雲
 OSS 權限問題及排查__常見錯誤及排除_最佳實踐_對象存儲 OSS-阿裏雲
 消息通知__操作指南_批量計算-阿裏雲
 設備端快速接入(MQTT)__快速開始_阿裏雲物聯網套件-阿裏雲
 查詢API調用流量數據__API管理相關接口_API_API 網關-阿裏雲
 使用STS訪問__JavaScript-SDK_SDK 參考_對象存儲 OSS-阿裏雲
最新內容
 阿裏雲服務器網絡設置重啟及故障排查指南
 阿裏雲ECS如何高效配置和管理硬件防火牆
 阿裏雲盤如何自主更新及常見問題解答
 阿裏雲客服兼職攻略：從申請到上手，你需要知道的一切
 阿裏雲雲盾：守護您的數字資產的堅實盾牌
 京東雲、阿裏雲之外：深度解析中國雲計算市場全景
 阿裏雲郵箱如何輕鬆打印郵件及附件？完整指南
 馬雲卸任後：阿裏雲的蛻變與新方向
 阿裏雲盤如何高效保存和管理朋友圈照片和視頻
 阿裏雲物聯網平台溫濕度數據上傳詳解