PutObject

更新时间:2023-08-17 17:36:17

单次请求上传完整文件到空间内。

1、如果在指定的空间内已经有相同的对象键值,用户上传的新对象会覆盖原来的对象。
2、需要用户拥有wos:putObject权限

请求语法

PUT /Key+ HTTP/1.1
Host: Bucket.Endpoint
Cache-Control: CacheControl
Content-Disposition: ContentDisposition
Content-Encoding: ContentEncoding
Content-Language: ContentLanguage
Content-Length: ContentLength
Content-MD5: ContentMD5
Content-Type: ContentType
Expires: Expires
x-wos-storage-class: StorageClass

Body

URI请求参数

请求头部

除使用公共请求头部外,还支持

参数 描述 是否必填
Content-MD5 根据原始数据的MD5计算出来的值,参考鉴权方式,如果数据在传输过程中遭到破坏导致Content-MD5不一致,会响应403 SignatureDoesNotMatch
x-wos-storage-class 指定文件的存储类型,Standard-标准存储、IA-低频存储、Archive-归档存储。默认同空间的存储类型
x-wos-meta-* 客户自定义元数据,会在headObject、getObject时的头部原样返回

请求主体

Object Body

响应语法

HTTP/1 status_code

x-wos-request-id: request id

Date: date

Content-Length: length

Content-Type: type

Server: WS-web-server

响应头部

使用公共头部外,还包含

元素名称

描述

Etag上传数据的Entity tag

响应元素

示例

PUT /object02 HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
Accept: */*
Date: Sat, 03 Dec 2011 07:12:31 +0000
Authorization: WOS BF6C09F302931425E9A7:KUxrlwKGWYpUOTgwNxIHALsRdT4=
Content-Length


HTTP/1 200 OK
x-wos-request-id: 001B21A61C6C0000013402C4616D5285
Content-Type: text/xml
Etag: "33bee59f4c1f859a7aedd36779b321cf"
Date: Sat, 03 Dec 2011 07:12:31 GMT
Content-Length: 0
Server:WS-web-server
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!