此操作用来向指定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。 | 否 |
| x-ctyun-data-location | 设置数据存储的位置。 注意 香港节点不支持此参数。 类型:字符串。 取值: 格式为:type=Local,scheduleStrategy=scheduleStrategy或者type=Specified,location=location,scheduleStrategy=scheduleStrategy
|
请求参数
| 名称 | 描述 | 是否必须 |
|---|---|---|
| BucketName | 存储桶名称。 | 是 |
请求示例
在名叫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
Content-Type: image/jpeg
Content-Length: 11434
Authorization: SignatureValue
[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