腾讯云对象存储GetObject

GetObject描述

该操作可以从腾讯云对象存储中取回Object,你必须对该Object有READ权限。如果该Object权限为公有读,则可在不进行签名认证的情况下取回Object。

注:支持通过x-amz-customize-back-source-url、x-amz-customize-back-source-param头指定数据拉取,指定后下载该对象时,将会拉取请求头提供的URL数据,并返回给用户。

请求语法GET/ObjectNameHTTP/1.1Host:bucket.s3.region.jcloudcs.comDate:dateAuthorization:authorizationstring(seeAuthenticatingRequests(AWSSignatureVersion4))Range:bytes=byte_range
请求参数

无请求参数

请求Header

除了共用的请求Header之外,该操作的实现还可以使用以下请求头,请求Header大小不超过8KB。

名称描述必须Range指定字节范围下载Object
Type:String
Default:None
Constraints:None否If-Modified-Since若Object在指定时间后修改,则返回该Object,否则返回304(notmodified)
Type:String
Default:None
Constraints:None否If-Unmodified-Since若Object在指定时间后未修改,则返回该Object,否则返回412(preconditionfailed)。
Type:String
Default:None
Constraints:None否If-Match如果ETag与指定的相同,则返回该Object,否则返回412(preconditionfailed)。
Type:String
Default:None
Constraints:None否IF-None-Match如果ETag与指定的不同,则返回该Object,否则返回304(notmodified)。
Type:String
Default:None
Constraints:None否x-amz-customize-back-source-url回源地址,支持如http://www.example.com:1000/path格式。
Type:String
Default:None否x-amz-customize-back-source-parambase64编码的json字符串。参数同镜像回源设置。
Type:String
Default:None否

注意:

  • 如果If-Match与If-Unmodified-Since同时在请求中,若If-Match为ture,If-Unmodified-Since为false,腾讯云对象存储将会返回200OK
  • 如果If-None-Match与If-Modified-Since同时在请求中,若If-None-Match为false,If-Modified-Since为true,腾讯云对象存储将会返回403NotModified

响应响应Header名称描述x-amz-storage-class提供Object的存储类型信息。非标准存储情况下,腾讯云对象存储将会返回该Headerx-amz-restore该对象的还原信息及副本生命周期响应元素

无响应元素

示例请求示例GET/my-image.jpgHTTP/1.1Host:oss-example.s3.region.jcloudcs.comDate:Mon,3Oct201622:32:00GMTAuthorization:authorizationstring
返回示例HTTP/1.1200OKx-amz-request-id:318BC8BC148832E5Date:Mon,3Oct201622:32:00GMTLast-Modified:Wed,12Oct200917:50:00GMTETag:"fba9dede5f27731c9771645a39863328"Content-Length:434234[434234bytesofobjectdata]