CopyObject_对象存储_API调试

版本控制

• x-oss-copy-source默认拷贝 Object 的当前版本，您可以在 x-oss-copy-source 中加入 versionId 来拷贝指定的 Object 版本。拷贝 Object 时，如果源 Object 的对应版本为删除标记，则返回 404 表示该 Object 不存在。
• 如果需要恢复 Object 的早期版本为当前版本，您只需将 Object 的早期版本拷贝到同一个 Bucket 中，OSS 会将该 Object 对应早期版本置为当前版本。
• 如果目标 Bucket 已开启版本控制，OSS 将会为新拷贝的 Object 自动生成唯一的版本 ID，此版本 ID 将会在响应 Header 中的 x-oss-version-id 返回。如果目标 Bucket 未开启或者暂停了版本控制，OSS 将会为新拷贝的 Object 自动生成 version ID 为 null 的版本，且会覆盖原有 versionId 为 null 的版本。

使用限制

• 使用 CopyObject 接口时，Object 的大小限制说明如下：

  • 如果源 Bucket 和目标 Bucket 相同，则 Object 的大小无限制。

  • 如果源 Bucket 和目标 Bucket 不同，则建议拷贝小于 1 GB 的 Object。当您需要拷贝大于 1 GB 的 Object 时，请使用 UploadPartCopy 接口。

  使用 CopyObject 或 UploadPartCopy 接口均要求对源 Object 有读权限。

• 在非版本控制的 Bucket 中，当调用 CopyObject 接口拷贝文件时，如果源 Object 与目标 Object 为同一个 Object，则 OSS 只修改源 Object 的元数据，不拷贝源 Object 的内容。

• 在版本控制的 Bucket 中，不支持拷贝通过追加上传方式生成的 Object。

• 如果源 Object 为软链接，则只拷贝软链接，无法拷贝软链接指向的文件内容。

计量计费

• 调用一次 CopyObject 接口会对源 Object 和目标 Object 所在的 Bucket 各增加一次 Get 请求次数。
• 调用 CopyObject 接口会对目标 Object 所在的 Bucket 增加相应的存储量。
• 调用 CopyObject 接口更改 Object 存储类型会涉及数据覆盖。例如低频访问 IA 创建后 10 天内被覆盖为标准存储 Standard，则会产生 20 天的低频访问不足规定时长容量费用。关于存储费用的更多信息，请参见**存储费用**。