下载对象

此接口可以在存储桶中将一个文件（对象）下载至本地。该操作需要请求者对目标对象具有读权限或目标对象对所有人都开放了读权限（公有读）。

请求

  • 请求语法

    • 内容

        GET /{ObjectKey} HTTP/1.1
  Host: {BucketName}.{Endpoint}
  Date: {date}
  Authorization: {SignatureValue}
  Range: bytes=ByteRange(可选，范围下载使用)

    • 描述

        Endpoint：参考与region地域的关系
  SignatureValue：参考签名算法

  • 请求参数

名称 类型 是否必须 描述
response-content-type 字符串 否 设置响应头部 Content-Type
默认值：None
response-content-language 字符串 否 设置响应头部 Content-Language
默认值：None
response-expires 字符串 否 设置响应头部 Expires
默认值：None
response-cache-control 字符串 否 设置响应头部 Cache-Control
默认值：None
response-content-disposition 字符串 否 设置响应头部 Content-Disposition
默认值：None
response-content-encoding 字符串 否 设置响应头部 Content-Encoding
默认值：None

备注：有时也许需要在 GET 响应中返回某一个确定的响应头部值，比如，用户可能需要在 GET 请求中设置响应头部 Content-Disposition 的值。只有当返回200状态码时，设置的header才会生效。
ByteRange指请求资源的范围，单位为Byte（字节），ByteRange有效区间在0至object size - 1的范围内。例如"Range: bytes=500-999"表示第500~999字节范围的内容。

  • 非公共请求头
名称 类型 是否必须 描述
Range 字符串 否 下载指定 range 字节的 object。
默认值：None
If-Modified-Since 字符串 否 如果 object 在指定时间后被改变，则返回 object。否则，返回304状态码
默认值：None
If-Unmodified-Since 字符串 否 如果 object 在指定时间后没有被改变，则返回 object。否则，返回412状态码
默认值：None
If-Match 字符串 否 如果 object 的 ETag(entity tag)与指定值一致，则返回 object。否则，返回412状态码
默认值：None
If-None-Match 字符串 否 如果 object 的 ETag(entity tag)与指定值不一致，则返回 object。否则，返回304状态码
默认值：None
Accept-Encoding 字符串 否 指定客户端的编码类型。如果要对返回内容进行Gzip压缩传输，需要在请求头中以显示方式加入Accept-Encoding:gzip。OSS会根据Object的Content-Type和Object大小（不小于1 KB）判断是否返回经过Gzip压缩的数据。
默认值：None

  • 请求体

    无

响应

  • 非公共响应头
名称 类型 是否必须 描述
x-oss-meta- * 字符串 是 如果在PUT Object中使用了用户元数据，格式为前缀 x-oss-meta- 后缀为你自定的字段，那么响应头部会返回它，并不解析。
x-oos-storage-class 枚举字符串 是 Object 的存储级别
有效值：STANDAR
x-oss-object-type 枚举字符串 是 表示该对象为Appendable对象或者Normal对象
有效值：Appendable;Normal
x-oss-next-append-position 整型 否 若该对象为Appendable对象，则返回下次追加时需要的位置

  • 响应体

    无

示例

  • 请求

      GET /my-image.jpg? ?response-content-type=text%2fplain HTTP/1.1
  Host: oss-example.oss-cn-beijing.inspurcloud.com
  Date: Fri, 26 Dec 2014 06:52:15 GMT
  Authorization: authorization string

  • 响应

      HTTP/1.1 200 OK
  x-oss-request-id: 5a868ca0ebd74bcc8eff1f1a7c9bcd6c
  Date: Fri, 26 Dec 2014 06:48:46 GMT
  Last-Modified: Wed, 12 Oct 2009 17:50:00 GMT
  ETag: "fba9dede5f27731c9771645a39863328"
  Content-Length: 434234
  Content-Type: text/plain
  Connection: keep-alive
  x-oss-storage-class: STANDARD
  x-oss-object-type: Normal
  Server: 
  [data]

错误码

错误码 描述 状态码 描述
... ... ... ...