文档简介：
PUT Object
Put操作用来向指定bucket中添加一个对象，要求发送请求者对该bucket有写权限，用户必须添加完整的对象。
请求语法
|
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类型用来描述内容格式。 默认值：application/octet-stream。 |
否 |
|
Expires |
对象不再被缓存的时间。 类型：String |
否 |
|
x-amz-meta- |
任何头以这个前缀开始都会被认为是用户的元数据，当用户检索时，它将会和对象一起被存储并返回。PUT请求头大小限制为8KB。在PUT请求头中，用户定义的元数据大小限制为2KB。 |
否 |
|
x-amz-limit |
对象上传限制的速率。 格式为：x-amz-limit:rate=xxx，取值为大于128的正整数，单位是KiB/s。 |
否 |
|
x-amz-storage-class |
数据的存储类型。 类型: String 取值: l STANDARD：标准存储 l REDUCED_REDUNDANCY：低冗余存储 l STANDARD_IA：低频访问存储 默认值: STANDARD |
否 |
|
x-ctyun-data-location |
设置Bucket的数据位置。 类型：key-value形式。 有效值： 格式为：type=Local,scheduleStrategy=scheduleStrategy或者type=Specified,location=location,scheduleStrategy=scheduleStrategy l type：指定数据存储位置的类型，取值为Local或者Specified。local表示就近写入，Specified表示指定位置。如果type取值为Specified，则需要指定具体的数据位置location，location可以填写多个，以逗号分隔，可取值为ChengDu、GuiYang、LaSa、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou。 l scheduleStrategy：调度策略，取值为： Ø Allowed：允许OOS自动调度数据存储位置 Ø NotAllowed：不允许OOS自动调度数据存储位置。 |
否 |
请求示例
在名叫myBucket的bucket中，存储一张叫my-image.jpg的图片。
|
PUT /my-image.jpg HTTP/1.1 Host: myBucket.oos-cn.ctyunapi.cn Date: Mon, 03Sep 2012 17:50:00 GMT Authorization: AWS 7799e793ce4624ee7e5a:xQE0diMbLRepdf3YB+FIEXAMPLE= Content-Type: image/ipeg Content-Length: 11434 [11434 bytes of object data] |
返回示例
|
HTTP/1.1 100 Continue
HTTP/1.1 200 OK x-amz-request-id: 0A49CE4060975EAC Date: Mon, 03 Sep 2012 17:50:00 GMT ETag: "1b2cf535f27731c974343645a3985328" Content-Length: 0 Connection: close Server: CTYUN |
副本模式
标准存储和低频访问存储使用的动态冗余模式的方式存储数据，默认情况下，OOS将采用动态冗余模式的方式来存储数据。但对于那些不太重要，可以重复生成的数据，用户可以在请求头中设置x-amz-storage-class为REDUCED_REDUNDANCY，选择减少冗余策略来降低成本。
