PutObject
更新时间：2025-08-18 15:51:52
将完整文件通过单个请求上传到存储空间（bucket）中。
- 如果指定存储空间中已经存在同名文件，新的上传文件将会覆盖原有文件。
- 用户需拥有 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值，若传输过程中数据损坏，将返回 403 SignatureDoesNotMatch，提示MD5与原始值不一致,上传将不会成功。 |
否 |
| 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: AWS 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
本篇文档内容对您是否有帮助？
有帮助
我要反馈