文档首页/ 对象存储服务 OBS/ API参考/ API/ 对象操作/ 下载对象
更新时间：2024-10-21 GMT+08:00
查看PDF
分享

下载对象

功能介绍

GET操作从对象存储下载对象。使用GET接口前，请确认必须拥有对象的READ权限。如果对象Owner向匿名用户授予READ访问权限，则可以在不使用鉴权头域的情况下访问该对象。

服务端加密

如果客户端的对象上传时，使用了客户提供的加密密钥进行服务端加密，当下载对象时，同样也必须在消息中提供密钥。

多版本

默认情况下，获取的是最新版本的对象。如果最新版本的对象是删除标记，则返回对象不存在。如果要获取指定版本的对象，请求可携带versionId消息参数。

归档或深度归档存储对象

如果要下载的对象是归档或深度归档存储类对象，由于对象存储在存档设备中，您必须先使用对象恢复，然后才能下载该归档或深度归档存储对象。对象处于不同的恢复状态时，给出不同响应：如果对象已恢复，下载对象成功时需要返回x-obs-restore头域指示恢复失效时间。对未恢复或正在恢复的归档或深度归档存储对象发送下载请求时，会返回错误403 Forbidden。

请求消息样式

1
2
3
4
5
6
 
GET /ObjectName HTTP/1.1 
Host: bucketname.obs.cn-north-4.myhuaweicloud.com 
Date: date
Authorization: authorization
Range:bytes=byte_range 
<Optional Additional Header>

其中Range字段可选，如果没有的话得到全部内容。

请求消息参数

GET操作获取对象内容时，允许用户通过请求参数的方式对一些消息头值进行重写，可以重写的消息头有：Content-Type、Content-Language、Expires、Cache-Control、Content-Disposition以及Content-Encoding共6个。另外所需恢复的对象拥有多个版本时，可以通过versionId参数，指定需要下载的版本。具体的说明如表1所示。

OBS不会处理请求中携带的Accept-Encoding，也不会对上传的数据做任何压缩、解压的操作，压缩解压的操作由客户端决定。某些HTTPClient在默认情况下可能会根据服务端返回的Content-Encoding对数据做相应的解压处理，客户端程序需要根据自己的需求决定是否做解压处理以及如何解压（修改OBS端保存的对象元数据Content-Encoding或者在下载对象时对Content-Encoding进行重写）。如果在下载对象的请求中指明了重写消息头，OBS返回的HTTP标准消息头中将以请求中指定的重写内容为准。

表1 请求消息参数

参数名称

参数类型

是否必选

描述

response-content-type

String

否

参数解释：

下载对象时重写响应中的Content-Type头。

约束限制：

无

取值范围：

参见HTTP标准头域Content-Type的取值。

默认取值：

无

response-content-language

String

否

参数解释：

下载对象时重写响应中的Content-Language头。

约束限制：

无

取值范围：

参见HTTP标准头域Content-Language的取值。

默认取值：

无

response-expires

String

否

参数解释：

下载对象时重写响应中的Expires头。

约束限制：

无

取值范围：

参见HTTP标准头域Expires的取值。

默认取值：

无

response-cache-control

String

否

参数解释：

下载对象时重写响应中的Cache-Control头。

约束限制：

无

取值范围：

参见HTTP标准头域Cache-control的取值。

默认取值：

无

response-content-disposition

String

否

参数解释：

下载对象时重写响应中的Content-Disposition头。

示例：

response-content-disposition=attachment; filename*=utf-8''name1

下载对象重命名为“name1”，如果name1中存在中文，需要将中文进行URL编码。

约束限制：

无

取值范围：

无

默认取值：

无

response-content-encoding

String

否

参数解释：

下载对象时重写响应中的Content-Encoding头。

约束限制：

无

取值范围：

参见HTTP标准头域Content-Encoding的取值。

默认取值：

无

versionId

String

否

参数解释：

对象的版本号，用于指定获取对象的版本号。

约束限制：

无

取值范围：

长度为32的字符串。

默认取值：

无，如果不设置则默认获取最新版本的对象。

x-image-process

String

否

参数解释：

图片处理服务，描述针对对象的图片处理命令或处理样式。

示例：

命令方式：x-image-process=image/commands

样式方式：x-image-process=style/stylename

详见《图片处理特性指南》。

约束限制：

无

取值范围：

命令方式：image/命令参数。

样式方式：style/样式名称。

默认取值：

如果不输入处理命令，将返回原图。

attname

String

否

参数解释：

下载对象时重写响应中的Content-Disposition头。

示例：

attname=name1

下载对象重命名为“name1”。

约束限制：

无

取值范围：

无

默认取值：

无

请求消息头

该请求除使用公共消息头外，还可以使用附加的消息头来完成获取对象的功能，消息头的意义如表2所示。

表2 请求消息头

消息头名称

消息头类型

是否必选

描述

Range

String

否

参数解释：

获取对象时，获取在Range范围内的对象内容。如果Range不合法则忽略此字段获取整个对象。

约束限制：

  • Range是一个范围，它的起始值最小为0，最大为对象长度减1。Range范围的起始值为必填项，如果Range只包含起始值，表示获取起始值到对象长度减1这个区间的对象内容。

    bytes=byte_range

    示例1：bytes=0-4

    示例2：bytes=1024

    示例3：bytes=10-20,30-40（表示多个区间）

  • 携带Range头域后，响应消息的ETag仍是对象的ETag，而不是Range范围内对象的ETag。

取值范围：

Range是一个范围，它的起始值最小为0，最大为对象长度减1。

默认取值：

无

If-Modified-Since

符合http://www.ietf.org/rfc/rfc2616.txt规定格式的HTTP时间字符串。

否

参数解释：

如果对象在请求中指定的时间之后有修改，则返回对象内容；否则的话返回304（not modified）。

约束限制：

此参数指定的时间不能晚于当前的服务器时间（GMT时间），否则参数不生效。

取值范围：

符合http://www.ietf.org/rfc/rfc2616.txt规定格式的HTTP时间字符串。

  1. EEE, dd MMM yyyy HH:mm:ss z
  2. EEEE, dd-MMM-yy HH:mm:ss z
  3. EEE MMM dd HH:mm:ss yyyy

对应示例：

  1. if-modified-since: Sun, 06 Nov 1994 08:49:37 GMT
  2. if-modified-since: Sunday, 06-Nov-94 08:49:37 GMT
  3. if-modified-since: Sun Nov 6 08:49:37 1994

默认取值：

无

If-Unmodified-Since

符合http://www.ietf.org/rfc/rfc2616.txt规定格式的HTTP时间字符串。

否

参数解释：

如果对象在请求中指定的时间之后没有修改，则返回对象内容；否则的话返回412（precondition failed）。

约束限制：

此参数指定的时间不能晚于当前的服务器时间（GMT时间），否则参数不生效。

取值范围：

符合http://www.ietf.org/rfc/rfc2616.txt规定格式的HTTP时间字符串。

  1. EEE, dd MMM yyyy HH:mm:ss z
  2. EEEE, dd-MMM-yy HH:mm:ss z
  3. EEE MMM dd HH:mm:ss yyyy

对应示例：

  1. if-unmodified-since: Sun, 06 Nov 1994 08:49:37 GMT
  2. if-unmodified-since: Sunday, 06-Nov-94 08:49:37 GMT
  3. if-unmodified-since: Sun Nov 6 08:49:37 1994

默认取值：

无

If-Match

String

否

参数解释：

如果对象的ETag和请求中指定的ETag相同，则返回对象内容，否则的话返回412（precondition failed）。

（ETag值，例：0f64741bf7cb1089e988e4585d0d3434）

约束限制：

无

取值范围：

对象的ETag

默认取值：

无

If-None-Match

String

否

参数解释：

如果对象的ETag和请求中指定的ETag不相同，则返回对象内容，否则的话返回304（not modified）。

（ETag值，例：0f64741bf7cb1089e988e4585d0d3434）

约束限制：

无

取值范围：

对象的ETag

默认取值：

无

x-obs-server-side-encryption-customer-algorithm

String

否。当使用SSE-C方式时，必选。

参数解释：

在SSE-C加密方式下使用该头域，该头域表示加密使用的算法。

示例：x-obs-server-side-encryption-customer-algorithm：AES256

约束限制：

需要和x-obs-server-side-encryption-customer-key、 x-obs-server-side-encryption-customer-key-MD5一起使用。

取值范围：

AES256

默认取值：

无

x-obs-server-side-encryption-customer-key

String

否。当使用SSE-C方式时，必选。

参数解释：

在SSE-C加密方式下使用该头域，该头域表示加密使用的密钥。该密钥用于解密对象。

示例：x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=

约束限制：

该头域由256-bit的密钥经过base64-encoded得到，需要和x-obs-server-side-encryption-customer-algorithm、x-obs-server-side-encryption-customer-key-MD5一起使用。

取值范围：

无

默认取值：

无

x-obs-server-side-encryption-customer-key-MD5

String

否。当使用SSE-C方式时，必选。

参数解释：

在SSE-C加密方式下使用该头域，该头域表示加密使用的密钥的MD5值。MD5值用于验证密钥传输过程中没有出错。

示例：x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==

约束限制：

该头域由密钥的128-bit MD5值经过base64-encoded得到，需要和x-obs-server-side-encryption-customer-algorithm、x-obs-server-side-encryption-customer-key一起使用。

取值范围：

密钥ID MD5的base64值。

默认取值：

无

请求消息元素

该请求消息中不使用消息元素。

响应消息样式

1
2
3
4
5
6
7
8
 
HTTP/1.1 status_code 
Content-Type: type 
Date: date 
Content-Length: length 
Etag： etag 
Last-Modified： time 

<Object Content>

响应消息头

该请求的响应消息使用公共消息头，具体请参考表1。

除公共响应消息头之外，还可能使用如下表3中的消息头。

表3 附加响应消息头

消息头名称

消息头类型

描述

x-obs-expiration

String

参数解释：

对象的过期时间。

约束限制：

当对象单独设置了对象lifecycle，过期时间以对象lifecycle为准，该消息头用expiry-date描述对象的详细过期信息；如果对象没有设置对象lifecycle，设置了桶级别lifecycle，过期时间以桶级别lifecycle为准，该消息头用expiry-date和rule-id两个键值对描述对象的详细过期信息；否则不显示该头域。

取值范围：

时间格式为：EEE, dd MMM yyyy HH:mm:ss z

示例：expiry-date=Sun, 06 Nov 1994 08:49:37 GMT

默认取值：

无

x-obs-website-redirect-location

String

参数解释：

当桶设置了Website配置，就可以设置对象元数据的这个属性，Website接入点返回301重定向响应，将获取这个对象的请求重定向到该属性指定的桶内另一个对象或一个外部的URL，该参数指明对象的重定向地址。

例如，重定向请求到桶内另一对象：

x-obs-website-redirect-location:/anotherPage.html

或重定向请求到一个外部URL：

x-obs-website-redirect-location:http://www.example.com/

OBS将这个值从头域中取出，保存在对象的元数据“WebsiteRedirectLocation”中。

约束限制：

  • 必须以“/”、“http://”或“https://”开头，长度不超过2KB。
  • OBS仅支持为桶根目录下的对象设置重定向，不支持为桶中文件夹下的对象设置重定向。

默认取值：

无

x-obs-delete-marker

Boolean

参数解释：

标识删除的对象是否是删除标记。如果不是，则响应中不会出现该消息头。

取值范围：

  • true：是删除标记。
  • false：不是删除标记。

默认取值：

false

x-obs-version-id

String

参数解释：

对象的版本号。

约束限制：

如果该对象无版本号，则响应中不会出现该消息头。

取值范围：

长度为32的字符串。

默认取值：

无

x-obs-server-side-encryption

String

参数解释：

该头域表示服务端的加密方式。

示例：x-obs-server-side-encryption：kms

约束限制：

如果服务端加密是SSE-KMS方式，响应包含该头域。

取值范围：

  • kms
  • AES256

默认取值：

无

x-obs-server-side-data-encryption

String

参数解释：

如果服务端加密是SSE-KMS方式，且数据加密算法为SM4，响应包含该头域。

示例：x-obs-server-side-data-encryption：SM4

约束限制：

无

取值范围：

SM4：国密SM4算法。

默认取值：

无

x-obs-server-side-encryption-kms-key-id

String

参数描述：

当加密方式为SSE-KMS且使用指定密钥加密时，需输入密钥ID。密钥ID获取方法请参见查看密钥。

约束限制：

当您设置了x-obs-server-side-encryption头域且赋值为“kms”，即选择kms加密方式时，才能使用该头域指定加密密钥。

默认取值：

当您选择使用kms加密方式，但未设置此头域时，默认的主密钥将会被使用。如果默认主密钥不存在，系统将默认创建并使用。

x-obs-server-side-encryption-customer-algorithm

String

参数解释：

如果服务端加密是SSE-C方式，响应包含该头域，该头域表示解密使用的算法。

示例：x-obs-server-side-encryption-customer-algorithm：AES256

约束限制：

无

取值范围：

AES256

默认取值：

无

x-obs-server-side-encryption-customer-key-MD5

String

参数解释：

如果服务端加密是SSE-C方式，响应包含该头域，该头域表示解密使用的密钥的MD5值。

示例：x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==

取值范围：

密钥ID MD5的base64值。

默认取值：

无

x-obs-object-type

String

参数解释：

对象的类型。

约束限制：

对象为非Normal对象时，会返回此头域。

取值范围：

Appendable

默认取值：

无

x-obs-next-append-position

Integer

参数解释：

指明下一次请求应该提供的position。

约束限制：

对象为Appendable对象时，会返回此头域。

取值范围：

无

默认取值：

无

x-obs-tagging-count

String

参数解释：

对象关联的标签个数。

示例：x-obs-tagging-count:1

约束限制：

仅当有读取标签权限时返回该参数。

取值范围：

无

默认取值：

无

响应消息元素

该请求的响应消息中不带消息元素。

错误响应消息

无特殊错误，所有错误已经包含在表2中。

请求示例：下载整个对象

1
2
3
4
5
6
 
GET /object01 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:24:33 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=

响应示例：下载整个对象

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D3F2A89604C49ABEE55E
Accept-Ranges: bytes
ETag: "3b46eaf02d3b6b1206078bb86a7b7013"
Last-Modified: WED, 01 Jul 2015 01:20:29 GMT
Content-Type: binary/octet-stream
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSQwxJ2I1VvxD/Xgwuw2G2RQax30gdXU
Date: WED, 01 Jul 2015 04:24:33 GMT
Content-Length: 4572

[4572 Bytes object content]

请求示例：指定Range下载对象

指定Range下载对象（下载对象单个区间内容）

1
2
3
4
5
6
7
 
GET /object01 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: Mon, 14 Sep 2020 09:59:04 GMT
Range:bytes=20-30
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:mNPLWQMDWg30PTkAWiqJaLl3ALg=

指定Range下载对象（下载对象多个区间内容）

1
2
3
4
5
6
7
 
GET /object01 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: Mon, 14 Sep 2020 10:02:43 GMT
Range:bytes=20-30,40-50
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:ZwM7Vk2d7sD9o8zRsRKehgKQDkk=

响应示例：指定Range下载对象

指定Range下载对象（下载对象单个区间内容）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
 
HTTP/1.1 206 Partial Content
Server: OBS
x-obs-request-id: 000001748C0DBC35802E360C9E869F31
Accept-Ranges: bytes
ETag: "2200446c2082f27ed2a569601ca4e360"
Last-Modified: Mon, 14 Sep 2020 01:16:20 GMT
Content-Range: bytes 20-30/4583
Content-Type: binary/octet-stream
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSn2JHu4okx9NBRNZAvBGawa3lt3g31g
Date: Mon, 14 Sep 2020 09:59:04 GMT
Content-Length: 11

[ 11 Bytes object content]

指定Range下载对象（下载对象多个区间内容）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
 
HTTP/1.1 206 Partial Content
Server: OBS
x-obs-request-id: 8DF400000163D3F2A89604C49ABEE55E
Accept-Ranges: bytes
ETag: "2200446c2082f27ed2a569601ca4e360"
Last-Modified: Mon, 14 Sep 2020 01:16:20 GMT
Content-Type: multipart/byteranges;boundary=35bcf444-e65f-4c76-9430-7e4a68dd3d26
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSIBWFOVW8eeWujkqSnoIANC2mNR1cdF
Date: Mon, 14 Sep 2020 10:02:43 GMT
Content-Length: 288

--35bcf444-e65f-4c76-9430-7e4a68dd3d26
Content-type: binary/octet-stream
Content-range: bytes 20-30/4583
[ 11 Bytes object content]
--35bcf444-e65f-4c76-9430-7e4a68dd3d26
Content-type: binary/octet-stream
Content-range: bytes 40-50/4583
[ 11 Bytes object content]
--35bcf444-e65f-4c76-9430-7e4a68dd3d26

请求示例：下载缩放图片

1
2
3
4
5
6
 
GET /example.jpg?x-image-process=image/resize,w_100 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:20:51 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:9Nsx45WjaVxlLnxlO9awasXn83N=

响应示例：下载缩放图片

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D3F2A89604C49ABEE55E
x-image-process:image/resize,w_100
Accept-Ranges: bytes
ETag: "3b46eaf02d3b6b1206078bb86a7b7013"
Last-Modified: WED, 01 Jul 2015 01:20:29 GMT
Content-Type: image/jpeg
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSQwxJ2I1VvxD/Xgwuw2G2RQax30gdXU
Date: WED, 01 Jul 2015 04:20:51 GMT
Content-Length: 49

[ 49 Bytes object content]

请求示例：判断对象Etag值

如果对象Etag值匹配则下载该对象

1
2
3
4
5
6
7
 
GET /object01 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:24:33 GMT
If-Match: 682e760adb130c60c120da3e333a8b09
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=

响应示例：判断对象Etag值，Etag不匹配

如果存储的对象的Etag值不是682e760adb130c60c120da3e333a8b09，则提示下载失败

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
 
HTTP/1.1 412 Precondition Failed
Server: OBS
x-obs-request-id: 8DF400000163D3F2A89604C49ABEE55E
Content-Type: application/xml
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSQwxJ2I1VvxD/Xgwuw2G2RQax30gdXU
Date: WED, 01 Jul 2015 04:20:51 GMT

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Error>
  <Code>PreconditionFailed</Code>
  <Message>At least one of the pre-conditions you specified did not hold</Message> 
  <RequestId>8DF400000163D3F2A89604C49ABEE55E</RequestId>      
  <HostId>ha0ZGaSKVm+uLOrCXXtx4Qn1aLzvoeblctVXRAqA7pty10mzUUW/yOzFue04lBqu</HostId>
  <Condition>If-Match</Condition>
</Error>

响应示例：判断对象Etag值匹配，下载成功

如果存储的对象的Etag值是682e760adb130c60c120da3e333a8b09，则下载成功

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 5DEB00000164A21E1FC826C58F6BA001
Accept-Ranges: bytes
ETag: "682e760adb130c60c120da3e333a8b09"
Last-Modified: Mon, 16 Jul 2015 08:03:34 GMT
Content-Type: application/octet-stream
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSbkdml1sLSvKnoHaRcOwRI+6+ustDwk
Date: Mon, 16 Jul 2015 08:04:00 GMT
Content-Length: 8

[ 8 Bytes object content]

请求示例：在URL中携带签名下载对象

GET /object02?AccessKeyId=H4IPJX0TQTHTHEBQQCEC&Expires=1532688887&Signature=EQmDuOhaLUrzrzRNZxwS72CXeXM%3D HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: Fri, 27 Jul 2018 10:52:31 GMT

响应示例：在URL中携带签名下载对象

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 804F00000164DB5E5B7FB908D3BA8E00
ETag: "682e760adb130c60c120da3e333a8b09"
Last-Modified: Mon, 16 Jul 2015 08:03:34 GMT
Content-Type: application/octet-stream
x-obs-id-2: 32AAAUJAIAABAAAQAAEAABAAAQAAEAABCTlpxILjhVK/heKOWIP8Wn2IWmQoerfw
Date: Fri, 27 Jul 2018 10:52:31 GMT
Content-Length: 8

[ 8 Bytes object content]

请求示例：下载对象并重命名，使用response-content-disposition参数

下载对象并重命名，使用response-content-disposition参数实现

1
2
3
4
5
6
 
GET /object01?response-content-disposition=attachment; filename*=utf-8''name1 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:24:33 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=

响应示例：下载对象并重命名，使用response-content-disposition参数

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 804F00000164DB5E5B7FB908D3BA8E00
ETag: "682e760adb130c60c120da3e333a8b09"
Last-Modified: Mon, 16 Jul 2015 08:03:34 GMT
Content-Type: application/octet-stream
x-obs-id-2: 32AAAUJAIAABAAAQAAEAABAAAQAAEAABCTlpxILjhVK/heKOWIP8Wn2IWmQoerfw
Date: Fri, 27 Jul 2018 10:52:31 GMT
Content-Length: 8
Content-Disposition: attachment; filename*=utf-8''name1

[ 8 Bytes object content]

请求示例：下载对象并重命名，使用attname参数

下载对象并重命名，使用attname参数实现

1
2
3
4
5
6
 
GET /object01?attname=name1 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:24:33 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=

响应示例：下载对象并重命名，使用attname参数

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 804F00000164DB5E5B7FB908D3BA8E00
ETag: "682e760adb130c60c120da3e333a8b09"
Last-Modified: Mon, 16 Jul 2015 08:03:34 GMT
Content-Type: application/octet-stream
x-obs-id-2: 32AAAUJAIAABAAAQAAEAABAAAQAAEAABCTlpxILjhVK/heKOWIP8Wn2IWmQoerfw
Date: Fri, 27 Jul 2018 10:52:31 GMT
Content-Length: 8
Content-Disposition: attachment; filename*=utf-8''name1

[ 8 Bytes object content]

请求示例：带自定义返回消息头

GET /obj001?response-expires=Thu%2C%2001%20Feb%202015%2017%3A00%3A00%20GMT HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:37:22 GMT
Authorization: OBS UDSIAMSTUBTEST000003:2tod8LyZOGA0+46HMjmp176XRaI=

响应示例：带自定义返回消息头

Server: OBS
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSmpL2dv6zZLM2HmUrXKTAi258MPqmrp
x-obs-request-id: 0000018A2A73AF59D3085C8F8ABF0C65
Accept-Ranges: bytes
ETag: "21e7e5efb6b73de19e691d6c4e32a9cf"
Content-Disposition: attachment
Date: WED, 01 Jul 2015 02:37:22 GMT
Expires: Thu, 01 Feb 2015 17:00:00 GMT
Content-Type: binary/octet-stream
Content-Length: 392
 
[392 Bytes object content]

请求示例：指定versionId访问指定版本对象

GET /obj001?versionId=G001118A6803675AFFFFD3043F7F91D0 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:37:22 GMT
Authorization: OBS UDSIAMSTUBTEST000003:2tod8LyZOGA0+46HMjmp176XRaI=

响应示例：指定versionId访问指定版本对象

Server: OBS
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSmpL2dv6zZLM2HmUrXKTAi258MPqmrp
x-obs-request-id: 0000018A2A73AF59D3085C8F8ABF0C65
Accept-Ranges: bytes
x-obs-version-id: G001118A6803675AFFFFD3043F7F91D0
ETag: "21e7e5efb6b73de19e691d6c4e32a9cf"
Content-Disposition: attachment
Date: WED, 01 Jul 2015 02:37:22 GMT
Content-Type: binary/octet-stream
Content-Length: 392
 
[392 Bytes object content]

请求示例：获取使用服务器端加密存储的对象

GET /obj001 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:37:22 GMT
Authorization: OBS UDSIAMSTUBTEST000003:2tod8LyZOGA0+46HMjmp176XRaI=
x-obs-server-side-encryption-customer-key:d09s2lKS9cmQO9135fQXMCV8fsOP02aDWd441g
x-obs-server-side-encryption-customer-key-MD5:ZjQpad35Fiw1322Fwa
x-obs-server-side-encryption-customer-algorithm:AES256

响应示例：获取使用服务器端加密存储的对象

Server: OBS
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSmpL2dv6zZLM2HmUrXKTAi258MPqmrp
x-obs-request-id: 0000018A2A73AF59D3085C8F8ABF0C65
Accept-Ranges: bytes
ETag: "21e7e5efb6b73de19e691d6c4e32a9cf"
Content-Disposition: attachment
Date: WED, 01 Jul 2015 02:37:22 GMT
Content-Type: binary/octet-stream
Content-Length: 392
x-obs-server-side-encryption-customer-key-MD5:ZjQpad35Fiw1322Fwa
x-obs-server-side-encryption-customer-algorithm:AES256
 
[392 Bytes object content]
父主题： 对象操作

相关文档