Put Object
该 API 接口用于向指定 Bucket 上传一个 Object。
使用须知
-
该操作要求请求者对指定的 Bucket 拥有可写权限。
-
Bucket 中的文件夹是模拟概念,控制台展现文件列表时,会自动根据 Object 名中的
/
生成文件夹。 -
用户可以调用此接口上传空的 Object,并指定 Object 名以
/
结尾,来创建一个空文件夹。 -
若指定的 Bucket 中已存在同名的 Object,QingStor 对象存储会在该 Object 完整上传完成后,替换已有 Object。
-
若同时有多个上传请求写入同一个 Object Key,则最后一个被 QingStor 对象存储处理的请求会覆盖之前上传的 Object 内容。
-
在用户调用该 API 上传数据之前,用户可以只发送 HTTP 请求头,不携带请求实体,并在请求头中添加
Expect: 100-continue
,来提前得知该请求是否能被 QingStor 对象存储正确接受与处理。当用户上传的对象实体非常庞大时,可以通过该方式提前知道该上传请求中的认证信息是否正确,请求域名是否需要重定向等,从而减少不必要的数据传输。 -
若指定的 Bucket 被设置为匿名用户可写,则请求中可不携带用户认证信息;
-
若指定的 Bucket 被设置为匿名用户可写,但请求中仍然携带了用户认证信息,则 QingStor 对象存储仍然会对该用户进行认证,当 QingStor 对象存储认证该用户不拥有该 Bucket 的可写权限,该请求返回错误。
请求语法
PUT /<object-name> HTTP/1.1
Host: <bucket-name>.<zone-id>.qsstor.com
Date: <date>
Authorization: <authorization-string>
请求参数
无。
请求头
QingStor 对象存储上传 Object 时,支持标准 HTTP 请求头和自定义请求头。若用户上传 Object 时设置了这些请求头,则下载该 Object 时,相应的请求头的值会自动使用上传 Object 时设置的值。各请求头字段说明如下:
标准 HTTP 头
字段名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
Content-Length |
String |
对象实体的大小 |
是 |
Content-MD5 |
String |
对象实体的 MD5 值,用于检查对象在传输过程中是否出错或被篡改 |
否 |
此接口还需要包含 Host、Date 等公共请求头。详细内容可参见公共请求头。
元数据
若用户需创建 Object 元数据,可参考对象元数据相关内容,添加相应请求头。
加密对象
若用户需加密 Object,可参考加密对象相关内容,添加相应请求头。
存储级别
若用户需指定上传 Object 的存储级别,可添加如下请求头:
字段名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
x-qs-storage-class |
String |
指定对象的存储级别。默认值为
|
否 |
请求消息体
Object 实体内容。
响应消息体
该 API 成功返回 201 时,没有响应消息体,失败返回错误码对应的 Json 格式消息体,详情参考错误码列表。
错误码
该 API 为幂等操作。成功则返回 201,失败的返回码参考错误码列表。
示例
请求示例
PUT /myphoto.jpg HTTP/1.1
Host: mybucket.pek3a.qsstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
Content-Length: 7987
Authorization: authorization string
[7987 bytes of object data]
响应示例
HTTP/1.1 201 CREATED
Server: QingStor
Date: Sun, 16 Aug 2015 09:05:00 GMT
ETag: "0c2f573d81194064b129e940edcefe9b"
Content-Length: 0
Connection: close
x-qs-request-id: aa08cf7a43f611e5886952542e6ce14b