腾讯云对象存储PutObject

PutObject描述

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

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

请求语法PUT/ObjectNameHTTP/1.1Host:bucket.s3.region.jdcloud-oss.comDate:dateAuthorization:authorizationstring(seeAuthenticatingRequests(AWSSignatureVersion4))请求元素

无请求元素

请求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-LengthObject的大小,单位为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
ValidValues:MIMEtypes
Constraints:None否Expect客户端使用Expect告知腾讯云对象存储,期望出现某种特定的行为。若腾讯云对象存储无法做出回应而发生错误时,请求报文主体将不会发送。
Type:String
Default:None
ValidValues:100-continue
Constraints:None否ExpiresObject缓存过期时间。
Type:String
Default:None
Constraints:None否x-amz-storage-classObject存储类型,如果未指定,默认为标准存储。
Type:Enum
Default:STANDARD
ValidValues:STANDARD、GLACIER、REDUCED_REDUNDANCY、STANDARD_IA否x-amz-meta-以x-amz-meta-前缀开头的Header为用户自定义Header。自定义Header的大小(包括key、value)UTF-8编码下不能超过2K。否响应响应Header

无特殊Header

响应元素

无特殊响应元素

示例请求示例PUT/my-image.jpgHTTP/1.1Host:oss-example.s3.region.jdcloud-oss.comDate:Wed,12Oct200917:50:00GMTAuthorization:authorizationstringContent-Type:text/plainContent-Length:11434Expect:100-continue[11434bytesofobjectdata]
响应示例HTTP/1.1100ContinueHTTP/1.1200OKx-amz-request-id:0A49CE4060975EACDate:Wed,12Oct200917:50:00GMTETag:"1b2cf535f27731c974343645a3985328"Content-Length:0Connection:closeServer:JDCloud腾讯云对象存储