文档中心 > GetObject
GetObject

最近更新时间:2021-11-19

使用GetObject接口获取Object。

您需要具有对文件的读权限。如果您授予匿名用户读权限,那么该操作可以不做签名。


覆盖响应头

有时您想覆盖GET响应中的某些响应头值。例如,您可以在GET请求中覆盖Content-Type响应头的值。

您可以使用以下查询参数用于覆盖一组响应头的值。这些响应标头值仅在成功请求时发送,即在返回HTTP状态码200 OK时发送。您可以使用数个这列出的的响应头集合。你可以重写为GET响应的响应头Content-Type,Content-Language,Expires,Cache-Control,Content-Disposition,和Content-Encoding。要在GET响应中覆盖这些标头值,请使用以下请求参数。

注意:使用这些参数时,必须使用授权标头或预签名 URL 对请求进行签名。它们不能与无符号(匿名)请求一起使用。

  • response-content-type

  • response-content-language

  • response-expires

  • response-cache-control

  • response-content-disposition

  • response-content-encoding

请求语法

GET /ObjectName HTTP/1.1

Host: examplebucket.region.unicloudsrv.com

Date: date

Authorization: authorization string

Range:bytes=byte_range

请求示例

GET /my-image.jpg HTTP/1.1

Host: test.oss-cn-north-1.unicloudsrv.com

Date: Wed, 28 Oct 2009 22:32:00 GMT

Authorization: authorization string

返回示例

HTTP/1.1 200 OK

Date: Wed, 28 Oct 2009 22:32:00 GMT

Last-Modified: Wed, 12 Oct 2009 17:50:00 GMT

ETag: "fba9dede5f27731c9771645a39863328"

Content-Length: 434234

Content-Type: text/plain

Connection: close

[434234 bytes of object data]


GZip压缩功能

如果您在GET请求的Header中添加Accept-Encoding: gzip,返回内容将会使用gzip编码进行压缩,以减小网络流量。为了降低服务端压力,目前只支持常见文本文件。

请求示例

GET /data.html HTTP/1.1

Host: bucket.oss-cn-north-1.unicloudsrv.com

User-Agent: curl/7.79.1

Accept: */*

Accept-Encoding: gzip

返回示例

HTTP/1.1 200 OK

Accept-Ranges: bytes

Cache-Control: no-store

Content-Encoding: gzip

Content-Type: application/x-gzip

Date: Wed, 17 Nov 2020 08:54:02 GMT

ETag: "57a2144b14b5089e3095c4424b7cfc91"

Last-Modified: Wed, 17 Nov 2020 08:52:27 GMT

Server: UOS Server

Vary: Origin

Vary: Accept-Encoding

X-Amz-Object-Type: Normal

X-Amz-Storage-Class: STANDARD

X-Xss-Protection: 1

Content-Length: 64