obsutil cp obs://srcbucket/key obs://dstbucket/[dest] [-dryRun][-u] [-crr] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

批量复制对象

obsutil cp obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun][-f] [-flat] [-u] [-crr] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

macOS/Linux操作系统

复制单个对象

./obsutil cp obs://srcbucket/key obs://dstbucket/[dest] [-dryRun] [-u] [-crr] [-vlength] [-vmd5] [-p=1] [-threshold=52428800] [-versionId=xxx] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

批量复制对象

./obsutil cp obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun] [-f] [-flat] [-u] [-crr] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例：

以Windows操作系统为例，运行obsutil cp obs://bucket-test/key obs://bucket-test2 ，复制单个对象。

obsutil cp obs://bucket-test/key obs://bucket-test2
Start at 2024-09-30 08:30:09.0815415 +0000 UTC

Parallel:      3                   Jobs:          3
Threshold:     50.00MB             PartSize:      auto
CheckpointDir: xxxx

[=====================================================] 100.00% 6/s 0s
Waiting for the copied key to be completed on server side.
Copy successfully, 19B, obs://bucket-test/key --> obs://bucket-test2/key
ext.txt, cost [1708], status [200], request id [00000192420D227E4017336A12F1DC22]

以Windows操作系统为例，运行obsutil cp obs://bucket-test/temp/ obs://bucket-test2 -f -r，批量复制对象。

obsutil cp obs://bucket-test/temp/ obs://bucket-test2 -r -f
Start at 2024-09-30 08:34:02.7819703 +0000 UTC

Parallel:      5                   Jobs:          5
Threshold:     50.00MB             PartSize:      auto
CheckpointDir: xxxx

Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5
OutputDir: xxxx

[=============================================================] 100.00% 10/s 0s
Succeed count:   5         Failed count:    0
Metrics [max cost:298 ms, min cost:192 ms, average cost:238.00 ms, average tps:9.71, transferred size: 7.20MB]
Task id: 0476929d-9d23-4dc5-b2f8-0a0493f027c5

更多运行示例，请参见常见示例。

参数说明：

参数	约束	描述
srcbucket	必选	源桶名。
dstbucket	必选	目标桶名。
dest	可选	复制对象时的目标对象名，或批量复制时目标对象名前缀。
key	复制对象时必选批量复制时可选	复制对象时的源对象名，或批量复制时源对象名前缀。规则如下：复制对象时，该值不能为空。如果“dest”为空，则将源对象复制到目标桶的根目录。如果“dest”以“/”结尾，则目标对象名为dest+源对象名；否则，目标对象名为“dest”的值。批量复制时，如果该值为空，则表示复制源桶中的所有对象；否则，复制源桶中以该值为对象名前缀的所有对象。目标对象名的确认规则为：如果“dest”以“/”结尾，目标对象名为dest+源对象名。如果“dest”不以“/”结尾，目标对象名为dest+/+源对象名。批量复制且该值不为空时，如果未设置“flat”参数，则复制时源对象名会包含上一级父对象名前缀；如果设置了“flat”参数，则复制时源对象名不包含上一级父对象名前缀。说明：请参考复制示例理解该参数的使用方式。
fr	附加参数，复制对象时可选	复制对象时生成结果清单文件。
flat	附加参数，批量复制时可选	批量复制时，不包含上一级父对象名前缀。
dryRun	附加参数，可选	测试模式运行，不执行实际的复制操作。
crr	附加参数，可选	复制时使用客户端跨区域复制模式，以通过数据流的方式从源桶直接复制数据到目标桶，且两个桶可以是任意两个OBS服务的桶。如果设置了该参数，必须确保更新了配置文件中客户端跨区域复制的相关配置信息，具体可参考更新配置文件。开启跨区域复制后，因为会占用执行命令主机上传和下载的双向带宽、CPU和内存等资源，可能会影响执行命令主机的性能。说明：复制时源桶对应的配置信息为配置文件中的“akCrr/skCrr/tokenCrr/endpointCrr”，目标桶对应的配置信息为配置文件中的“ak/sk/token/endpoint”。
vlength	附加参数，可选	复制完成后，验证目标桶对象大小是否与源桶中对象的大小一致。该参数必须与“crr”参数配合使用。
vmd5	附加参数，可选	复制完成后，验证目标桶的MD5值是否与源桶中对象的MD5值一致。该参数必须与“crr”参数配合使用。源桶中对象必须包含元数据x-obs-meta-md5chksum，否则会忽略MD5值校验。MD5值校验通过后，会将该值设置为目标对象元数据x-obs-meta-md5chksum，用于下载或复制时校验MD5。如果您的业务涉及加密场景，请勿使用该参数。
u	附加参数，可选	增量复制操作，设置该参数后，复制每个源对象时会对比目标桶中对应路径的目标对象，仅在目标对象不存在，或者目标对象大小与源对象大小不一致，或者目标对象的最后修改时间早于源对象的最后修改时间时进行复制。
p	附加参数，可选	每个分段复制任务的最大并发数，默认为配置文件中的defaultParallels。注意：对于未携带 crr 参数的桶间复制任务，该参数的取值范围上限为 10,000。
threshold	附加参数，可选	开启分段复制任务的阈值。如果待复制的源对象小于该阈值，则使用直接复制模式；否则使用分段复制模式。默认为配置文件中的defaultBigfileThreshold。单位：字节支持带容量单位配置，例如：配置1MB代表1048576字节。说明：直接复制模式不会产生断点记录文件，不支持断点续传。
versionId	附加参数，复制对象时可选	复制单个对象时可指定的源对象版本号。
acl	附加参数，可选	复制对象时可指定的目标对象的预定义访问策略。支持的值： private：私有读写，除对象ACL授权外的其他用户无对象的访问权限。 public-read：公共读，任何用户都可以对桶内对象进行读操作。 public-read-write：公共读写，任何用户都可以对桶内对象进行读/写/删除操作。 bucket-owner-full-control：桶拥有者完全控制，其他任何人都没有访问权限。
sc	附加参数，可选	复制对象时可指定的目标对象的存储类型。支持的值： standard：标准存储，访问时延低、吞吐量高，适用于有大量热点文件（平均一个月多次）或小文件（小于1MB）。 warm：低频访问存储，可用性略低于standard，适用于不频繁访问（平均一年少于12次）但在需要时也要求快速访问数据的业务场景。 cold：归档存储，安全、持久且成本极低，适用于很少访问（平均一年访问一次）数据的业务场景。 deep-archive：深度归档存储，适用于长期不访问（平均几年访问一次）数据的业务场景，其成本相比归档存储更低，但相应的数据恢复时间将更长，一般为数小时。
meta	附加参数，可选	复制对象时可指定的标准和自定义元数据。标准元数据包括：Content-Type、Content-Encoding、Cache-Control、Content-Disposition、Content-Language、Expires。自定义元数据格式为：key:value，多个自定义元数据使用#链接。例如key1:value1#key2:value2#key3:value3，其含义是，复制文件后，桶内目标对象包含三组自定义元数据，分别为：key1:value1、key2:value2、key3:value3。
fs	附加参数，可选	是否使用并行文件系统的列举方式，如果桶是并行文件系统，推荐加上该参数。该参数开启后，会忽略marker和limit值，统计桶或者并行文件系统或者指定目录的大小。 Util 5.5.12版本及以上支持该参数。该列举方式会因为目录结构，耗时差别很大。
ps	附加参数，可选	每个分段复制任务的段大小。默认为配置文件中的defaultPartSize，支持配置为auto，此时obsutil会根据源文件大小自动设置每个分段任务的段大小。取值范围：100KB~5GB 单位：字节。支持带容量单位配置，例如，配置1MB代表1048576字节。
cpd	附加参数，可选	生成断点记录文件的文件夹，默认为运行obsutil命令的用户目录的子文件夹.obsutil_checkpoint。每个分段复制任务会产生唯一对应的断点记录文件并保存至该文件夹的upload子文件夹下。分段任务执行成功后，对应的断点记录文件会被自动删除；分段任务执行失败或被中断后，下次执行该分段任务时会尝试通过对应的断点记录文件恢复任务。
r	附加参数，批量复制时必选	按指定源桶的对象名前缀批量复制对象。
f	附加参数，批量复制时可选	强制操作，不进行询问提示。
j	附加参数，批量复制时可选	批量复制时的最大并发数，默认为配置文件中的defaultJobs。注意：对于未携带 crr 参数的桶间复制任务，该参数的取值范围上限为 10,000。说明：工具会保证该值至少为1。
exclude	附加参数，批量复制时可选	不包含源对象的匹配模式，设置该参数后，如果待复制的对象名匹配该参数，则跳过该对象的复制。如：.txt，代表所有后缀为.txt的文件自动跳过，不复制。 “”匹配多个任意字符，如：“abc.txt”表示匹配所有以“abc”开头，中间可以包含任意数量的任意字符，以“.txt”结尾的文件名。 “?”匹配单个任意字符，如：“abc?.txt”表示匹配所有以“abc”开头，中间包含1个任意字符，以“.txt”结尾的文件名。您可以使用“\”代表匹配“”字符本身，使用“\?”代表匹配“?”字符本身。支持指定多个exclude参数，如 -exclude=.xxx -exclude=.xxx 约束限制：* 该匹配模式仅适用于对象名非“/”结尾的对象。说明：建议使用引号传递该匹配模式（Linux/Mac操作系统使用单引号，Windows操作系统使用双引号）防止特殊符号被操作系统转义，导致不可预期的结果。该匹配模式作用于对象全路径（含从根路径开始的对象前缀和对象名，例如，桶内对象路径为obs://bucket/src1/src2/test.txt，则对象的全路径为src1/src2/test.txt）。
include	附加参数，批量复制时可选	包含源对象的匹配模式，设置该参数后，如果待复制的对象名匹配该参数，则复制该对象。如：.txt，代表所有后缀为.txt的对象将会被复制。 “”匹配多个任意字符，如：“abc.txt”表示匹配所有以“abc”开头，中间可以包含任意数量的任意字符，以“.txt”结尾的文件名。 “?”匹配单个任意字符，如：“abc?.txt”表示匹配所有以“abc”开头，中间包含1个任意字符，以“.txt”结尾的文件名。您可以使用“\”代表匹配“”字符本身，使用“\?”代表匹配“?”字符本身。支持指定多个include参数，如 -include=.xxx -include=.xxx 约束限制：* 该匹配模式仅适用于对象名非“/”结尾的对象。如果同时配置了exclude和include参数，则首先执行exclude的匹配规则，如果待复制的对象名不匹配exclude参数，则判断待复制的对象名是否匹配include参数，如果匹配则复制该对象，否则跳过该对象的复制。示例： ./obsutil cp obs://src-bucket/ obs://target-bucket/ -include=/src-object/* -f -r 以上命令的含义是：复制src-bucket桶下符合匹配规则的文件到target-bucket桶下，匹配规则是以“src-object/”开头的对象名称。说明：建议使用引号传递该匹配模式（Linux/Mac操作系统使用单引号，Windows操作系统使用双引号）防止特殊符号被操作系统转义，导致不可预期的结果。该匹配模式作用于对象全路径（含从根路径开始的对象前缀和对象名，例如，桶内对象路径为obs://bucket/src1/src2/test.txt，则对象的全路径为src1/src2/test.txt）。
timeRange	附加参数，批量复制时可选	复制对象时的时间段匹配模式，仅复制最后修改时间在该时间段内的对象。该匹配模式优先级低于文件名匹配模式：exclude和include，即优先执行exclude和include参数匹配，然后执行该匹配模式。该匹配模式表示的时间是UTC时间。使用“time1-time2”，代表匹配的时间段，其中time1必须小于等于time2，格式为yyyyMMddHHmmss。时间格式支持自动补全，例如：yyyyMMdd等价于yyyyMMdd000000，yyyyMM等价于yyyyMM01000000。使用“-time2”，代表匹配最后修改时间在time2之前的所有文件，使用“time1-”，代表匹配最后修改时间time1之后的所有文件。该匹配模式仅适用于对象名非“/”结尾的对象。
mf	附加参数，可选	设置名称匹配模式（include、exclude）和时间匹配模式（timeRange）对对象名以“/”结尾的对象也生效。
o	附加参数，可选	生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果、失败结果、警告结果三个文件）。默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。结果清单文件命名规则：cp_{succeed \| failed \| warning}_report_时间_TaskId.txt。单个结果清单文件默认情况下最大为30MB，可在配置文件中通过recordMaxLogSize分别配置。单个结果清单文件默认情况下最多可保留1024个文件，可在配置文件中通过recordBackups分别配置。当涉及多文件/文件夹时，如需确认失败任务的具体错误信息，可参考结果清单文件夹下的失败结果清单文件“cp_failed_report_时间_TaskId.txt”和日志路径下的日志文件。
bucket-cname	附加参数，可选	指定桶绑定的自定义域名说明： Util 5.7.9版本及以上支持该参数。
config	附加参数，可选	运行当前命令时的自定义配置文件。可支持的配置参数请参考配置参数说明。
e	附加参数，可选	指定终端节点。
i	附加参数，可选	指定用户的AK。
k	附加参数，可选	指定用户的SK。
t	附加参数，可选	指定用户的securitytoken。

响应结果：

字段名	描述
Parallel	请求中的-p参数。
Jobs	请求中的-j参数。
Threshold	请求中的-threshold参数。
PartSize	请求中的-ps参数。
Exclude	请求中的-exclude参数。
Include	请求中的-include参数。
TimeRange	请求中的-timeRange参数。
VerifyLength	请求中的-vlength参数。
VerifyMd5	请求中的-vmd5参数。
CheckpointDir	请求中的-cpd参数。
OutputDir	请求中的-o参数。
ArcDir	请求中的-arcDir参数。
Succeed count	成功的任务数。
Failed count	失败的任务数。
Skip count	增量上传/下载/复制、同步上传/下载/复制跳过的任务数。说明：跳过的任务数也会记录到成功的任务数中。
Warning count	执行完成但包含警告的任务数。说明：产生警告的任务可能是失败的也可能是成功的，需要根据成功或失败的结果清单进一步判断。产生警告的任务数与成功/失败任务数是相互独立的，总任务数仍是成功的任务数+失败的任务数。
Succeed bytes	上传/下载成功的字节数。
max cost	所有任务中的最长耗时，单位：毫秒。
min cost	所有任务中的最短耗时，单位：毫秒。
average cost	平均耗时，单位：毫秒。
average tps	平均每秒的任务完成个数。
Task id	每次运行的唯一标识号，用于查找批量任务生成的结果清单文件。

通过彻底删除带删除标记的当前版本来找回对象

桶开启多版本控制后删除对象时，对象不会被真正删除，OBS会插入一个删除标记来标识对象的最新版本是删除状态，之前的当前版本对象变为历史版本对象。可以通过彻底删除带删除标记的对象来找回对象。

OBS支持通过管理控制台、API、SDK、obsutil方式删除带删除标记的当前版本来找回对象，不支持通过OBS Browser+方式删除带删除标记的当前版本来找回已删除对象。

使用OBS控制台

在OBS管理控制台左侧导航栏选择“桶列表”。
在桶列表中，单击待操作的桶，进入“对象”页面。
打开对象列表上方的“历史版本”开关。
在“最后修改时间”列找到带“删除标记”的对象，单击其操作列的“彻底删除”。

也可以选中所有带“删除标记”的对象，单击对象列表上方的“彻底删除”来批量找回对象。
在“彻底删除对象”弹窗，单击“确定”。

可以看到“删除标记”消失，且最近的一个历史版本对象成为当前版本对象，即找回对象。

使用API

此场景下，待删除对象的版本ID“versionId”为带删除标记对象的版本ID。查询带删除标记对象的版本ID，详情请参见查看多版本对象。

删除对象

使用SDK

此场景下，待删除对象的版本ID“versionId”为带删除标记对象的版本ID。查询带删除标记对象的版本ID，详情请参见查看多版本对象。

使用命令行工具obsutil

此场景下，待删除对象的版本ID“versionId”为带删除标记对象的版本ID。查询带删除标记对象的版本ID，详情请参见查看多版本对象。

命令结构：

Windows操作系统

删除单个对象

obsutil rm obs://bucket/key [-f] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

批量删除对象

obsutil rm obs://bucket/[key] -r [-j=1] [-f] [-v] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

macOS/Linux操作系统

删除单个对象

./obsutil rm obs://bucket/key [-f] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

批量删除对象

./obsutil rm obs://bucket/[key] -r [-j=1] [-f] [-v] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例：

以Windows操作系统为例，运行obsutil rm obs://bucket-test/key -f，删除bucket-test桶中名为key的单个对象。

obsutil rm obs://bucket-test/key -f

Start at 2024-09-25 04:48:10.1147483 +0000 UTC

Delete object [key] in the bucket [bucket-test] successfully, cost [152], request id [0000016979E1D2B2860BB5181229C72C]

以Windows操作系统为例，运行obsutil rm obs://bucket-test -r -f，删除bucket-test桶中所有对象。

obsutil rm obs://bucket-test -r -f
Start at 2024-09-30 08:46:55.5335644 +0000 UTC

[===============================================] 100.00% 21s
Succeed count:   1313      Failed count:    0
Task id: 95936984-f81a-441a-bba0-1fd8254d9241

以Windows操作系统为例，运行obsutil rm obs://bucket-test/key -r -f，删除bucket-test桶中所有以key为前缀的对象和文件夹。

obsutil rm obs://bucket-test/key -r -f
Start at 2024-09-30 08:49:09.5602115 +0000 UTC

[===============================================] 100.00% 21s
Succeed count:   10      Failed count:    0
Task id: 79ab59ec-7e00-4f22-8c88-465faa834125

参数说明：

参数	约束	描述
bucket	必选	桶名。
key	删除单个对象时必选批量删除对象时可选	待删除的对象名，或批量删除的对象名前缀。说明：批量删除对象时，如果该参数为空，则表示删除桶中所有的对象。请谨慎操作。
fr	附加参数，删除单个对象时可选	删除单个对象时生成结果清单文件。
f	附加参数，可选	强制操作，不进行询问提示。请谨慎使用。
versionId	附加参数，删除单个对象时可选	待删除对象的版本号。
r	附加参数，批量删除对象时必选	按指定的对象名前缀批量删除对象。注意：批量删除对象时，会将与前缀匹配的所有对象删除，请谨慎使用。
j	附加参数，批量删除对象时可选	批量删除对象时的最大并发数，默认为配置文件中的defaultJobs。说明：工具会保证该值至少为1。
v	附加参数，批量删除对象时可选	按指定的对象名前缀批量删除多版本对象和多版本删除标记。
o	附加参数，可选	生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果和失败结果两个文件），默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。说明：结果清单文件命名规则：rm_{succeed \| failed}_report_时间_TaskId.txt。单个结果清单文件默认情况下最大为30MB且最大可保留的文件个数为1024，可在配置文件中通过recordMaxLogSize和recordBackups分别配置。当涉及多文件/文件夹时，如需确认失败任务的具体错误信息，可参考结果清单文件夹下的失败结果清单文件“cp_failed_report_时间_TaskId.txt”和日志路径下的日志文件。
bucket-cname	附加参数，可选	指定桶绑定的自定义域名说明： Util 5.7.9版本及以上支持该参数。
config	附加参数，可选	运行当前命令时的自定义配置文件。可支持的配置参数请参考配置参数说明。
e	附加参数，可选	指定终端节点。
i	附加参数，可选	指定用户的AK。
k	附加参数，可选	指定用户的SK。
t	附加参数，可选	指定用户的securitytoken。

响应结果：

字段名	描述
Parallel	请求中的-p参数。
Jobs	请求中的-j参数。
Threshold	请求中的-threshold参数。
PartSize	请求中的-ps参数。
Exclude	请求中的-exclude参数。
Include	请求中的-include参数。
TimeRange	请求中的-timeRange参数。
VerifyLength	请求中的-vlength参数。
VerifyMd5	请求中的-vmd5参数。
CheckpointDir	请求中的-cpd参数。
OutputDir	请求中的-o参数。
ArcDir	请求中的-arcDir参数。
Succeed count	成功的任务数。
Failed count	失败的任务数。
Skip count	增量上传/下载/复制、同步上传/下载/复制跳过的任务数。说明：跳过的任务数也会记录到成功的任务数中。
Warning count	执行完成但包含警告的任务数。说明：产生警告的任务可能是失败的也可能是成功的，需要根据成功或失败的结果清单进一步判断。产生警告的任务数与成功/失败任务数是相互独立的，总任务数仍是成功的任务数+失败的任务数。
Succeed bytes	上传/下载成功的字节数。
max cost	所有任务中的最长耗时，单位：毫秒。
min cost	所有任务中的最短耗时，单位：毫秒。
average cost	平均耗时，单位：毫秒。
average tps	平均每秒的任务完成个数。
Task id	每次运行的唯一标识号，用于查找批量任务生成的结果清单文件。