对象存储

产品文档

对象存储

Put Object

描述

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

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

请求

语法

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、REDUCED_REDUNDANCY、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

响应元素

无特殊响应元素

示例

请求示例

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
更新时间:2020-12-16 12:09:54