此操作用来向指定Bucket中添加一个文件，要求发送请求者对该Bucket有写权限，用户必须添加完整的文件。

说明
文件名称不能包含ASCII码为0的字符（NUL）。

请求语法

PUT /ObjectName HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue

请求头

名称
描述
是否必须
Cache-Control
按照请求/回应的方式用来定义缓存行为。
类型：字符串。
否
Content-Disposition
指出文件的描述性的信息。
类型：字符串。
否
Content-Encoding
指出文件所使用的编码格式。
类型：字符串。
否
Content-Length
指定文件的大小，单位为字节。
类型：字符串。
是
Content-MD5
按照RFC 1864，使用base64编码格式生成信息的128位MD5值。此请求头可以用作数据完整性检查，以验证数据是否与客户端发送的数据相同。
类型：字符串。
否
Content-Type
标准的MIME类型用来描述内容格式。
类型：字符串。
取值：MIME类型。默认值为application/octet-stream。
否
Expires
文件不再被缓存的时间。
类型：字符串。
否
x-amz-meta-
任何头以这个前缀开始都会被认为是用户的元数据，当用户检索时，它将会和文件一起被存储并返回。PUT请求头大小限制为8KiB。在PUT请求头中，用户定义的元数据大小限制为2KiB。
类型：字符串。
否
x-amz-limit
文件上传限制的速率。格式为：x-amz-limit:rate=xxx。
类型：字符串。
取值：大于0的正整数，单位是KiB/s。当取值是大于0小于128的整数时，按速率等于128KiB/s处理。 
否
x-amz-storage-class
数据的存储类型。
类型：字符串。
取值: 
STANDARD：标准存储。
STANDARD_IA：低频访问存储。
默认值为STANDARD。
否
x-ctyun-data-location
设置数据存储的位置。香港节点不支持此参数。
类型：字符串。
取值：
格式为：type=Local,scheduleStrategy=scheduleStrategy或者type=Specified,location=location,scheduleStrategy=scheduleStrategy
type：指定数据存储位置的类型，取值为Local或者Specified。local表示就近写入，Specified表示指定位置。如果type取值为Specified，则需要指定具体的数据位置location，location可以填写多个，以逗号分隔。对于对象存储网络，可取值为：ChengDu、GuiYang、LaSa、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou；对于对象存储网络2，可取值为：NeiMeng1、HangZhou1。
scheduleStrategy：调度策略，取值为：
Allowed：允许OOS自动调度数据存储位置。
NotAllowed：不允许OOS自动调度数据存储位置。

请求参数

请求示例

在名叫example-bucket的Bucket中，存储一张叫my-image.jpg的图片。

PUT /my-image.jpg HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Date: Mon, 03 Sep 2012 17:50:00 GMT
Authorization: SignatureValue
Content-Type: image/jpeg
Content-Length: 11434
[11434 bytes of object data]

响应示例

HTTP/1.1 100 Continue
 
HTTP/1.1 200 OK
x-amz-request-id: 767bc103031946fa81fbfdf4f6fcbbbdc0b1b3b5b7b9bbbdbf
Date: Mon, 03 Sep 2012 17:50:00 GMT
ETag: "1b2cf535f27731c974343645a3985328"
Content-Length: 0
Server: CTYUN