tcb storage objects cp
把对象复制到新位置，可跨 bucket。
v3.4.0+
PG 模式存储命令自 @cloudbase/cli@3.4.0 起提供。
语法
tcb storage objects cp <srcKey> <dstKey> -b <bucketId> [options]
参数
| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
<srcKey> | 是 | 源对象名 | — |
<dstKey> | 是 | 目标对象名 | — |
-b, --bucket <bucketId> | 是 | 源 Bucket ID | — |
--dst-bucket <bucketId> | 否 | 目标 Bucket ID | 与源 Bucket 相同 |
--copy-metadata <bool> | 否 | 是否复制源对象 metadata | true |
--metadata <json> | 否 | 系统 metadata JSON，与源 metadata 合并；COS 仅识别 cacheControl / mimetype / contentType | — |
--user-metadata <json> | 否 | 用户自定义 metadata JSON，整体替换目标 user_metadata | — |
--upsert | 否 | 允许覆盖目标位置已有对象 | false |
--json | 否 | 输出 SDK 原始返回 ICopyObjectHttpResult | — |
校验规则：
- 同 bucket 下源 key 与目标 key 相同且未传
--upsert时，以INVALID_PARAM拒绝。 --metadata/--user-metadata仅在--copy-metadata false时生效，其他情况下传入会被 CLI 拒绝。
示例
tcb storage objects cp test/hello.txt test/hello-copy.txt -b my-bucket
tcb storage objects cp test/hello.txt backup/hello.txt -b my-bucket --dst-bucket backup-bucket