Put Object

描述

该操作可将一个object上传到bucket中，要求操作者有bucket的WRITE权限。

您可以使用Content-MD5 来确保数据完整性，OSS将根据提供的MD5校验Object，若不匹配，则返回错误。另外，您也可以在上传object计算MD5，并与返回的ETag进行比对。

在PutObject前需要确保对应的Bucket已经存在，OSS支持Object文件的长度范围是0Byte-5GB。如果需要上传大于5GB的文件，请参考分片上传指南

请求

语法

PUT /ObjectName HTTP/1.1
Host: <bucket>.s3.<region>.jdcloud-oss.com
Date: <date>
Authorization: <authorization string> (see Authenticating Requests (AWS Signature Version4))

请求元素

无请求元素

请求Header

该操作可使用以下请求Header以及通用的请求Header（请参阅常见请求Header）；Header大小不超过8KB。

名称	描述	必须
Cache-Control	指定该Object被下载时的网页的缓存行为；更详细描述请参照RFC2616。 Type: String Default: None Constraints: None	否
Content-Disposition	指定返回的Object该以何种形式展示,长度限制为100个字节；更详细描述请参照RFC2616。 Type: String Default: None Constraints: None	否
Content-Encoding	它的值表示消息主体进行了何种方式的内容编码转换，用来告知客户端应该怎样解码才能获取在 Content-Type 中标示的媒体类型内容；更详细描述请访问RFC2616。 Type: String Default: None Constraints: None	否
Content-Length	Object的大小，单位为byte；更详细描述请参照RFC2616。 Type: String Default: None Constraints: None	是
Content-MD5	对报文主体进行MD5算法获得128位二进制数，再通过Base64编码写入Content-MD5。可用于数据完整性检查。 Type: String Default: None Constraints: None	否
Content-Type	表示请求中的MIME类型。 Type: String Default: binary/octet-stream Valid Values: MIME types Constraints: None	否
Expect	客户端使用Expect告知OSS，期望出现某种特定的行为。若OSS无法做出回应而发生错误时，请求报文主体将不会发送。 Type: String Default: None Valid Values: 100-continue Constraints: None	否
Expires	Object缓存过期时间。 Type: String Default: None Constraints: None	否
x-amz-storage-class	Object存储类型，如果未指定，默认为标准存储。 Type: Enum Default: STANDARD Valid Values: STANDARD、 GLACIER、STANDARD_IA	否
x-amz-tagging	设置对象标签。如"Key1=Value1" Type: String Default: None Constraints:标签键和标签值需分别做urlencode。该标签头大小不能超过2K。标签个数不能超过10个。	否
x-amz-meta-*	以x-amz-meta- 前缀开头的Header为用户自定义Header。自定义Header的大小（包括key、value）UTF-8编码下不能超过2K。	否

响应

响应Header

无特殊Header

响应元素

无特殊响应元素

注意事项

1. 由于OSS本身是一个(key-value)的存储系统，所以原则上并不会存在“文件夹”的概念。若需要按照文件夹来划分，可以把 “/” 符号作为分隔符模拟文件夹。例如上传object为 “work/test/123.txt”，控制台显示时会根据“/”自动切分，创建work文件夹下面的test文件夹和test文件夹下的123.txt文件。

2. OSS目前不支持Version，如果请求者重复Put一个Object，之前上传的数据将被覆盖。

示例

请求示例

PUT /my-image.jpg HTTP/1.1
Host: oss-example.s3.<region>.jdcloud-oss.com 
Date: Wed, 12 Oct 2009 17:50:00 GMT
Authorization: <authorization string>
Content-Type: text/plain
Content-Length: 11434
Expect: 100-continue
[11434 bytes of object data]

响应示例

HTTP/1.1 100 Continue

HTTP/1.1 200 OK
x-amz-request-id: 0A49CE4060975EAC
Date: Wed, 12 Oct 2009 17:50:00 GMT
ETag: "1b2cf535f27731c974343645a3985328"
Content-Length: 0
Connection: close
Server: JDCloudOSS