设置对象复制
最近更新时间: 2024-10-17 17:10:00
功能描述
PUT Object - Copy 请求实现将一个文件从源路径复制到目标路径。建议文件大小1M 到 5G，超过5G 的文件请使用分块上传 Upload - Copy。在拷贝的过程中，文件元属性和 acl 可以被修改。 用户可以通过该接口实现文件移动，文件重命名，修改文件属性和创建副本。
请求
请求示例
PUT /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: GMT Date
Authorization: Auth String
x-cos-copy-source: <BucketName-APPID>.<Endpoint>/filepath说明：
Authorization: Auth String （详细请参阅请求签名章节）。
请求头
公共头部
该请求操作的实现使用公共请求头，了解公共请求头详情请参阅 公共请求头部 章节。
非公共头部
| 名称 | 描述 | 类型 | 必选 |
|---|---|---|---|
| x-cos-copy-source | 源文件 URL 路径，可以通过 versionid 子资源指定历史版本 | string | 是 |
| x-cos-metadata-directive | 是否拷贝源文件的元数据，枚举值：Copy, Replaced，默认值 Copy。假如标记为 Copy，则拷贝源文件的元数据；假如标记为 Replaced，则按本次请求的 Header 信息修改元数据。当目标路径和源路径一致，即用户试图修改元数据时，则标记必须为 Replaced | string | 否 |
| x-cos-copy-source-If-Modified-Since | 当 Object 在指定时间后被修改，则执行操作，否则返回412。可与 x-cos-copy-source-If-None-Match 一起使用，与其他条件联合使用返回冲突 | string | 否 |
| x-cos-copy-source-If-Unmodified-Since | 当 Object 在指定时间后未被修改，则执行操作，否则返回412。可与 x-cos-copy-source-If-Match 一起使用，与其他条件联合使用返回冲突 | string | 否 |
| x-cos-copy-source-If-Match | 当 Object 的 Etag 和给定一致时，则执行操作，否则返回412。可与 x-cos-copy-source-If-Unmodified-Since 一起使用，与其他条件联合使用返回冲突 | string | 否 |
| x-cos-copy-source-If-None-Match | 当 Object 的 Etag 和给定不一致时，则执行操作，否则返回412。可与 x-cos-copy-source-If-Modified-Since 一起使用，与其他条件联合使用返回冲突 | string | 否 |
| x-cos-acl | 定义 Object 的 ACL 属性。有效值：private，public-read；默认值：private | string | 否 |
| x-cos-grant-read | 赋予被授权者读的权限。格式：x-cos-grant-read: id="[OwnerUin]" | string | 否 |
| x-cos-grant-write | 赋予被授权者写的权限。格式：x-cos-grant-write: id="[OwnerUin]" | string | 否 |
| x-cos-grant-full-control | 赋予被授权者所有的权限。格式：x-cos-grant-full-control: id="[OwnerUin]" | string | 否 |
| x-cos-meta-* | 包括用户自定义头部后缀和用户自定义头部信息，将作为 Object 元数据返回，大小限制为2KB。 注意：用户自定义头部信息支持下划线，但用户自定义头部后缀不支持下划线 |
string | 否 |
请求体
该请求的请求体为空。
响应
响应头
公共响应头
该响应包含公共响应头，了解公共响应头详情请参阅 公共响应头部 文档。
响应体
该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：
<CopyObjectResult>
<ETag>"ba82b57cfdfda8bd17ad4e5879ebb4fe"</ETag>
<LastModified>2017-08-04T02:41:45</LastModified>
</CopyObjectResult>具体的数据内容如下：
| 名称 | 描述 | 类型 |
|---|---|---|
| CopyObjectResult | 返回复制结果信息 | String |
| ETag | 返回文件的 MD5 算法校验值。ETag 的值可以用于检查 Object 的内容是否发生变化。 | String |
| LastModified | 返回文件最后修改时间，GMT 格式 | String |
实际案例
请求
PUT /exampleobject HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: Fri, 04 Aug 2017 02:41:45 GMT
Connection: keep-alive Accept-Encoding: gzip, deflate Accept: */*
User-Agent: python-requests/2.12.4
Authorization: q-sign-algorithm=sha1&q-ak=AKID15IsskiBQKTZbAo6WhgcBqVls9SmuG00&q-sign-time=1480932292;1981012292&q-key-time=1480932292;1981012292&q-url-param-list=&q-header-list=host&q-signature=eacefe8e2a0dc8a18741d9a29707b1dfa5aa47cc
x-cos-copy-source: sourcebucket-1250000001.<Endpoint>/picture.jpg
Content-Length: 0响应
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 133
Connection: keep-alive
Date: Fri, 04 Aug 2017 02:41:45 GMT
Server: tencent-cos
x-cos-request-id: NTk4M2RlZTlfZDRiMDM1MGFfYTA1ZV8xMzNlYw==
<CopyObjectResult>
<ETag>"ba82b57cfdfda8bd17ad4e5879ebb4fe"</ETag>
<LastModified>2017-08-04T02:41:45</LastModified>
</CopyObjectResult>