您可以使用 cp 命令拷贝对象。

注意事项

不支持将父目录的对象直接拷贝到子目录，或将子目录的对象直接拷贝到父目录。

命令语法

Linux/macOS

Windows

拷贝单个对象

./tosutil cp tos://srcbucket/srckey tos://dstbucket/[dstkey] [-dryRun] [-u] [-pipe] [-pe=xxx] [-p=1] [-threshold=104857600] [-ps=auto] [-cpd=xxx] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-sse=xxx] [-sseKeyId=xxx] [-contentType=xxx] [-contentDisposition=xxx] [-contentEncoding=xxx] [-contentLanguage=xxx] [-cacheControl=xxx] [-expires=xxx] [-fr] [-o=xxx] [-bt=xxx] [-sbt=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

批量拷贝对象

./tosutil cp tos://srcbucket[/srcprefix] tos://dstbucket[/dstprefix] -r [-dryRun] [-u] [-pipe] [-pe=xxx] [-flat] [-j=1] [-p=1] [-threshold=104857600] [-nfj=1] [-ps=auto] [-cpd=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-sse=xxx] [-sseKeyId=xxx] [-contentType=xxx] [-contentDisposition=xxx] [-contentEncoding=xxx] [-contentLanguage=xxx] [-cacheControl=xxx] [-expires=xxx] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-dmf] [-o=xxx] [-bt=xxx] [-sbt=xxx] [-bfs=1] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

性能优化建议

tosutil 支持通过 -j 及 -p 参数调整并发数。当您批量上传大文件时，实际并发数为 -j 乘以 -p 参数。调整建议如下：

资源不充足场景

当网络、内存等资源不充足的场景下，建议您不要设置过高的并发数，避免因资源占满导致的性能下降或失败等问题。您可以根据实际资源情况，先设置一个较低的并发数，然后逐渐增大参数，直至调整至一个较优的设置。

提升整体执行的 QPS 和带宽

上传、下载、拷贝小文件：需要设置较高的并发数提升 QPS。

上传、下载、拷贝大文件：避免并发数过高导致带宽抢占造成性能衰减。

您可以通过 -nfj 参数和 -j 参数分别控制非分片任务和分片任务的并发数。例如设置 -j=100，-nfj=80，表示总并发数为 100，当执行非分片任务（一般是小文件）时，最大的并发数为 80；当执行分片任务（一般是大文件）时，最大的并发数为 20。

公网运行场景

由于公网网络不稳定以及客户端带宽较低等因素，容易导致上传缓慢且失败等问题，您可以参考以下建议调整参数：

调大配置文件中的 maxRetryCount 参数，通过不断重试错误解决公网网络不稳定的问题。

如果客户端带宽有限，您需要合理减少 -j 和 -p 参数，避免因并发过高导致客户端超带宽，进而出现断流失败等情况。

合理调整 -ps 参数，降低分片大小，有利于提高单个分片上传/下载/复制的成功率。

参数说明

通用可选参数的说明，请参见通用可选参数。

参数名	参数类型	描述
srcbucket	String	复制对象的源桶名。
srckey	String	复制的源对象名。
dstbucket	String	复制对象的目的桶名。
dstkey	String	复制对象的目的对象名。
srcprefix	String	批量复制时的源对象名前缀。
dstprefix	String	批量复制时的目的对象名前缀。
-r	Bool	执行批量上传、下载或复制操作。
-dryRun	Bool	测试模式运行，不执行实际的上传、下载或复制操作。
-recover	String	待恢复上传、下载或复制对象任务的结果清单文件任务 ID。
-u	Bool	增量上传、下载或复制对象，设置该参数后，会比较源端和目标端，建议您在以下场景下使用该参数：目标端不存在。目标端与源端的文件大小不一致。目标端的最后修改时间早于源端的最后修改时间时执行对应的操作。
-pipe	Bool	使用管道流模式复制对象。
-pe	String	使用管道流模式复制对象时指定目标桶的 endpoint。
-flat	Bool	上传、下载或复制对象时不包含相对父目录。
-j	Integer	批量任务的最大并发数，-j=1 表示批量任务的最大并发数为 1。默认为配置文件中的 defaultJobs，默认值为 3。
-p	Integer	每个分片任务的最大并发数，-p=1 表示分片任务的最大并发数为 1 。默认为配置文件中的 defaultParallels，默认值为 20。
-threshold	Integer	开启分片任务的阈值，单位：字节，默认为配置文件中的 defaultBigfileThreshold。说明支持带容量单位配置，例如，配置 1MB 代表 1048576 字节。
-nfj	Integer	批量任务的处理普通文件或对象（非分片任务）的最大并发数。当设置该参数后，-j 参数设置的并发数会分为两部分，普通文件的并发数为 nfj，分片任务的并发数为 j-nfj。仅在批量操作时生效。
-ps	Integer/String	每个分片任务的段大小，单位：字节，默认为配置文件中的 defaultPartSize。说明支持带容量单位配置，例如，配置 1MB 代表 1048576 字节。
-cpd	String	生成断点记录文件的文件夹，默认为配置文件中的 defaultCheckpointDir。
-versionId	String	下载或复制单个对象的版本号。
-acl	String	上传或复制对象时可指定的预定义访问策略。支持的值如下： private public-read public-read-write authenticated-read bucket-owner-read bucket-owner-full-control bucket-owner-entrusted
-sc	Enum	复制对象时可指定的对象存储类型，取值说明如下： STANDARD：标准存储，默认值。 IA：低频访问存储。 ARCHIVE_FR：归档闪回存储。 ARCHIVE：归档存储。 COLD_ARCHIVE：冷归档存储。 DEEP_COLD_ARCHIVE：深度冷归档存储。说明当前仅华北2（北京）、华东2（上海）和华南1（广州）支持冷归档存储。当前仅华北2（北京）、华东2（上海）和华南1（广州）支持深度冷归档，且都处于邀测状态，如您需要使用该存储类型，请联系客户经理。
-meta	String	上传或复制对象时可指定的自定义元数据。
-sse	String	上传、复制对象时使用的服务端加密算法，支持的值： aes256 kms 默认为配置文件中的 defaultSse。
-sseKeyId	String	上传、复制对象且指定服务端加密算法为 kms 时，使用的 kms 密钥，默认为配置文件中的 defaultSseKeyId。
-contentType	String	上传、复制对象时设置对象的 Content-Type。
-contentDisposition	String	上传、复制对象时设置对象的 Content-Disposition。
-contentEncoding	String	上传、复制对象时设置对象的 Content-Encoding。
-contentLanguage	String	上传、复制对象时设置对象的 Content-Language。
-cacheControl	String	上传、复制对象时设置对象的 Cache-Control。
-expires	String	上传、复制对象时设置对象的 Expires，格式为：YYYYMMDDHHmmSS。
-include	String	上传、下载或复制时对包含文件的名称匹配模式，支持以下字符： ? ：匹配单个任意字符。 * ：匹配多个任意字符。 # ：作为分隔符。例如 -include=.png#.txt 表示匹配所有以 .png 和 .txt结尾的文件。说明为了避免因操作系统转义特殊符号的导致的解析失败等问题，建议您使用引号设置名称匹配模式。名称匹配模式只在上传文件夹或文件列表时生效。名称匹配模式在文件全路径生效（包含文件名和文件目录）。
-exclude	String	上传、下载或复制时对不包含文件的名称匹配模式，支持以下字符： ? ：匹配单个任意字符。 * ：匹配多个任意字符。 # ：作为分隔符。例如 -exclude=.png#.txt 表示匹配所有以 .png 和 .txt结尾的文件。说明为了避免因操作系统转义特殊符号导致的解析失败等问题，建议您使用引号设置名称匹配模式。名称匹配模式只在上传文件夹或文件列表时生效。名称匹配模式在文件全路径生效（包含文件名和文件目录）。
-timeRange	String	上传、下载或复制时文件最后修改时间的时间段匹配模式，格式为：YYYYMMDDHHmmSS-YYYYMMDDHHmmSS。
-dmf	Bool	设置名称匹配模式 -include/-exclude 和时间段匹配模式 -timeRange 对文件夹不生效。
-marker	String	批量复制时指定列举对象的开始位置。
-fr	Bool	操作单个对象时生成结果清单文件。
-o	String	生成结果清单文件的文件夹，默认为配置文件中的 defaultOutputDir。
-bt	String	复制对象时，目标存储桶的类型。取值说明如下： fns：扁平桶。 hns：分层桶。如果未指定存储桶的类型，则默认从桶元数据获取存储桶的类型。
-sbt	String	复制对象时，源存储桶的类型。取值说明如下： fns：扁平桶。 hns：分层桶。如果未指定存储桶的类型，则默认从桶元数据获取存储桶的类型。
-bfs	Integer	使用分层列举的方式批量复制对象，并指定分层列举的并发度。

使用示例

拷贝单个对象

以下命令用于将 bucketname 桶中的 object1.png 对象，复制到 tosutil 桶中，复制后对象命名为 destobject.png。

命令

./tosutil cp tos://bucketname/object1.png tos://tosutil/destobject.png

返回

Start at 2022-10-27 10:57:24.353686 +0000 UTC

Parallel: 1 Jobs: 5
Threshold: 100.00MB PartSize: auto
CheckpointDir: /.tosutil_checkpoint

Copy successfully, 55.98KB, tos://bucketname/object1.png --> tos://tosutil/destobject.png, cost [154], status [200], request id [55fa485a6414248e635a6414-ac13a11a-1oo0Zg-CO-cb-tos-bj]

批量拷贝对象

以下命令用于将 bucketname 桶中前缀为 object 的对象，复制到 tosutil 桶中，复制后对象前缀为 destobject。

命令

./tosutil cp tos://bucketname/object tos://tosutil/destobject -r

返回

Start at 2022-10-27 10:57:43.32094 +0000 UTC

Parallel: 1 Jobs: 5
Threshold: 100.00MB PartSize: auto
CheckpointDir: /Users/.tosutil_checkpoint
OutputDir: /Users/.tosutil_output

[-------------------------------------------------] 100.00% tps:23.37 4/4 371ms
Succeed count is: 4 Failed count is: 0
Metrics [max cost:330 ms, min cost:92 ms, average cost:186.25 ms, average tps:10.75]

Task id is: 2ee1abfa-55e6-11ed-b269-aa665a3c7f26

对象存储