CopyObject
更新时间 2026-04-10 20:11:12
最近更新时间: 2026-04-10 20:11:12
功能说明
CopyObject请求复制指定的对象，对象的大小不能超过5G。
请求消息样式
PUT /{Bucket}/{Key}HTTP/1.1
Host: xxx.zos.ctyun.cn
X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
X-Amz-Date: 20220406T134209Z
Authorization: authorization string
x-amz-acl: ACL
x-amz-copy-source: CopySource
x-amz-metadata-directive: MetadataDirective
x-amz-storage-class: StorageClass
x-amz-tagging: Tagging请求消息参数
| 参数名称 | 描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释： Bucket名称。 | String | 是 |
| Key | 参数解释： 对象的Key。 | String | 是 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。但可以带附加消息头，附加请求消息头如下表所示。
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| x-amz-acl | 参数解释： 参见Put ACL。 | String | 否 |
| x-amz-copy-source | 参数解释： 指定copy的源，格式 {source-bucket}/{source-object}。 | String | 是 |
| x-amz-metadata-directive | 参数解释： 指定复制时元数据的复制模式。 取值范围： - COPY：直接用源对象的meta - REPLACE：用请求参数里的meta替代源对象的meta 默认取值： COPY | String | 否 |
| x-amz-storage-class | 参数解释： 目的对象存储级别。 取值范围： - STANDARD：标准存储 - STANDARD_IA：低频存储 - GLACIER：归档存储 默认取值： STANDARD | String | 否 |
| x-amz-tagging | 参数解释： 设置目的对象TAG，参见Put Object Tagging。 | String | 否 |
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
Content-Length: length
x-amz-request-id: tx000000000000000000006-0062553c17-1e4cb-default
Date: Tue, 12 Apr 2022 08:45:11 GMT
Connection: Keep-Alive
x-amz-version-id: VersionId
<?xml version="1.0" encoding="UTF-8"?>
<CopyObjectResult>
<ETag>string</ETag>
<LastModified>timestamp</LastModified>
</CopyObjectResult>响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。
响应消息元素
| 参数名称 | 描述 | 类型 |
|---|---|---|
| CopyObjectResult | 参数解释： 复制结果信息的容器。 | Container |
表CopyObjectResult
| 参数名称 | 描述 | 类型 |
|---|---|---|
| ETag | 参数解释： 目的对象的ETag。 | String |
| LastModified | 参数解释： 源对象的修改时间。 | Date |
错误码
请参见调用前必知-错误码-全局错误码。
