PutObject
更新时间 2026-04-10 20:11:10
最近更新时间: 2026-04-10 20:11:10
功能说明
PutObject请求上传指定的对象。
请求消息样式
PUT /{Bucket}/{Key}?append&position=position HTTP/1.1
Host: xxx.zos.ctyun.cn
X-Amz-Content-Sha256: Content-SHA256
X-Amz-Date: Date
Authorization: Auth String
Content-MD5: ContentMD5
x-amz-acl: ACL
x-amz-storage-class: StorageClass
x-amz-metadata-*: Metadata
Body请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释： Bucket的名称。 | String | 是 |
| Key | 参数解释： 对象的Key。 | String | 是 |
| append | 参数解释： 追加上传。 | String | 否 |
| position | 参数解释： 追加上传位置。 | String | 否 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。可以带附加消息头，附加请求消息头如下表所示：
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Content-MD5 | 参数解释： 指定对象数据的MD5，若指定，则会校验接收的数据MD5是否一致。 | String | 否 |
| x-amz-storage-class | 参数解释： STANDARD | String | 否 |
| x-amz-acl | 参数解释： 上传对象的ACL。 取值范围： - private：私有，对象的所有者拥有完全控制的权限，其他任何人都没有访问权限。 - public-read：公共读，所有人可以获取该对象。 - public-read-write：公共读写，由于底层限制，所有人可以获取该对象，不支持写对象。如需要公共写请提工单申请。 - authenticated-read：所有经过认证的用户都可以访问该对象。 默认取值： private | String | 否 |
| x-amz-metadata | 参数解释： 用户指定的元数据信息。 | String | 否 |
请求消息元素
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Body | 参数解释： 上传的对象数据。 | Binary | 否 |
响应消息样式
HTTP/1.1 Status Code
Content-Length: 0
ETag: ETag
Accept-Ranges: bytes
x-amz-version-id: VersionId
x-amz-request-id: Request Id
Date: Date
Connection: Keep-Alive响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。 除公共响应消息头之外，还可能返回如下的消息头：
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| ETag | 参数解释： 对象的ETag。 | String |
| x-amz-version-id | 参数解释： 对象的版本号。 | String |
响应消息元素
该请求的响应中不带有响应元素。
错误码
请参见调用前必知-错误码-全局错误码。
