华为云用户手册

运行示例 以Windows操作系统为例，运行obsutil abort obs://bucket-test/key -u=xxx -f，删除单个分段上传任务。 obsutil abort obs://bucket-test/key -u=xxx -fStart at 2024-10-08 01:25:55.6771288 +0000 UTC[--------------------------------------------------] 100.00% tps:0.00 1/1 106msSucceed count: 1 Failed count: 0Metrics [max cost:54 ms, min cost:54 ms, average cost:54.00 ms, average tps:8.77]Task id: 4972589c-c775-41be-a288-bbee3edaaee9 以Windows操作系统为例，运行obsutil abort obs://bucket-test -r -f，批量删除桶中所有的分段上传任务。 obsutil abort obs://bucket-test -r -fStart at 2024-10-08 01:28:29.1980739 +0000 UTC[-----------------------------------------------] 100.00% tps:2924.55 3/3 202msSucceed count: 3 Failed count: 0Metrics [max cost:148 ms, min cost:61 ms, average cost:113.33 ms, average tps:14.63]Task id: cd2fd08e-fc31-47d9-b4b0-9f9a3376435f

参数说明 参数 约束 描述 bucket 必选 桶名。 key 删除单个分段上传任务时必选 批量删除分段上传任务时可选 待删除分段上传任务的对象名，或批量删除分段上传任务的对象名前缀。 说明： 批量删除分段上传任务时，如果该参数为空，则表示删除桶中所有的分段上传任务。 u 附加参数，删除单个分段上传任务时必选 待删除分段上传任务的ID。 说明： 该参数可以通过列举分段上传任务获取到。 fr 附加参数，删除单个分段上传任务时可选 删除单个分段上传任务时生成结果清单文件。 f 附加参数，可选 强制操作，不进行询问提示。 r 附加参数，批量删除分段上传任务时必选 按指定的对象名前缀批量删除分段上传任务。 j 附加参数，批量删除分段上传任务时可选 批量删除分段上传任务的最大并发数，默认为配置文件中的defaultJobs。 说明： 工具会保证该值至少为1。 o 附加参数，可选 生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果和失败结果两个文件），默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。 说明： 结果清单文件命名规则：abort_{succeed | failed}_report_时间_TaskId.txt。 单个结果清单文件默认情况下最大为30MB且最大可保留的文件个数为1024，可在配置文件中通过recordMaxLogSize和recordBackups分别配置。 config 附加参数，可选 运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。 e 附加参数，可选 指定终端节点。 i 附加参数，可选 指定用户的AK。 k 附加参数，可选 指定用户的SK。 t 附加参数，可选 指定用户的securitytoken。

命令结构 Windows操作系统 移动单个对象 obsutil mv obs://srcbucket/key obs://dstbucket/[dest] [-dryRun] [-u] [-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 mv obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun] [-f] [-flat] [-u] [-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 mv obs://srcbucket/key obs://dstbucket/[dest] [-dryRun] [-u] [-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 mv obs://srcbucket[/key] obs://dstbucket[/dest] -r [-dryRun] [-f] [-flat] [-u] [-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] 移动的源路径和目标路径不能完全相同。 批量移动时，源路径和目标路径不能相互嵌套。 不支持对并行文件系统的批量移动的操作。

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

运行示例 以Windows操作系统为例，运行obsutil chattri obs://bucket-test -acl=private，修改桶的访问策略为私有读写。 obsutil chattri obs://bucket-test -acl=privateStart at 2024-09-29 07:58:46.0506904 +0000 U TCS et the acl of bucket [bucket-test] to [private] successfully, request id [04050000016836C5DA6FB21F14A2A0C0]

命令结构 Windows操作系统 obsutil cp -recover=xxx [-dryRun] [-f] [-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] [-clear] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] macOS/Linux操作系统 ./obsutil cp -recover=xxx [-dryRun] [-f] [-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] [-clear] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例 以Windows操作系统为例，运行obsutil cp -recover=0476929d-9d23-4dc5-b2f8-0a0493f027c5 -f，批量复制对象。 obsutil cp -recover=0476929d-9d23-4dc5-b2f8-0a0493f027c5 -f Start at 2024-10-08 01:10:07.3809685 +0000 UTCParallel: 5 Jobs: 5Threshold: 50.00MB PartSize: autoVerifyLength: false VerifyMd5: falseCheckpointDir: xxxxTask id: a628d6da-c562-4a1f-b687-4fa125de0dc3OutputDir: xxxxTempFileDir: xxxx[========================================================] 100.00% tps:35.71 2.02 KB/s 7.20MB/7.20MB 0sSucceed count: 1 Failed count: 0Succeed bytes: xxxMetrics [max cost:90 ms, min cost:45 ms, average cost:63.80 ms, average tps:35.71, transferred size:70B]Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3

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

命令结构 Windows操作系统 obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] macOS/Linux操作系统 ./obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例 以Windows操作系统为例，运行obsutil cp -recover=3066a4b0-4d21-4929-bb84-4829c32cbd0f d:\ -f -r，批量下载对象。 obsutil cp -recover=3066a4b0-4d21-4929-bb84-4829c32cbd0f -f -rStart at 2024-10-08 01:10:07.3809685 +0000 UTCParallel: 5 Jobs: 5Threshold: 50.00MB PartSize: autoVerifyLength: false VerifyMd5: falseCheckpointDir: xxxxTask id: a628d6da-c562-4a1f-b687-4fa125de0dc3OutputDir: xxxxTempFileDir: xxxx[========================================================] 100.00% tps:35.71 2.02 KB/s 7.20MB/7.20MB 0sSucceed count: 1 Failed count: 0Succeed bytes: xxxMetrics [max cost:90 ms, min cost:45 ms, average cost:63.80 ms, average tps:35.71, transferred size:70B]Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3

参数说明 参数 约束 描述 recover 附加参数，必选 待恢复下载任务结果清单文件的任务号。 说明： 任务号（TaskId）可在每次下载任务运行完毕后获取，或者通过结果清单文件名查询（文件名除去后缀.txt后的后36位）。 待恢复的下载任务会从结果清单的文件夹中查找，结果清单文件夹的路径参考附加参数o。 tempFileDir 附加参数，可选 下载时保存临时文件的文件夹，默认为配置文件中的defaultTempFileDir。 说明： 由于分段下载时生成的临时文件会保存在该目录，请确保运行obsutil的用户对该路径有写权限。 该路径的可用空间需要大于待下载对象的大小。 dryRun 附加参数，可选 测试模式运行，不执行实际的上传操作。 u 附加参数，可选 增量下载操作，设置该参数后，下载每个对象时会对比本地对应路径的文件，仅在文件不存在，或者文件大小与对象大小不一致，或者对象的最后修改时间晚于文件的最后修改时间时进行下载。 注意： 在比较每个本地文件与桶内对象差异时，会产生一次HEAD请求费用。 vlength 附加参数，可选 下载完成后，验证本地文件大小是否与桶中对象的大小一致。 vmd5 附加参数，可选 下载完成后，验证本地文件的MD5值是否与桶中对象的MD5值一致。 说明： 桶中对象必须包含元数据x-obs-meta-md5chksum，否则会忽略MD5值校验。 注意： 如果您的业务涉及加密场景，请勿使用该参数。 p 附加参数，可选 每个分段下载任务的最大并发数，默认为配置文件中的defaultParallels。 threshold 附加参数，可选 开启分段下载任务的阈值，单位：字节，默认为配置文件中的defaultBigfileThreshold。 说明： 如果待下载的对象小于该阈值，则使用直接下载模式；否则使用分段下载模式。 直接下载模式不会产生断点记录文件，不支持断点续传。 支持带容量单位配置，例如，配置1MB代表1048576字节。 ps 附加参数，可选 每个分段下载任务的段大小，单位：字节，默认为配置文件中的defaultPartSize。 说明： 支持带容量单位配置，例如，配置1MB代表1048576字节。 支持配置为auto，此时obsutil会根据源对象大小自动设置每个分段任务的段大小。 cpd 附加参数，可选 生成断点记录文件的文件夹，默认为运行obsutil命令的用户目录的子文件夹.obsutil_checkpoint。 说明： 每个分段下载任务会产生唯一对应的断点记录文件并保存至该文件夹的down子文件夹下，分段任务执行成功后，对应的断点记录文件会被自动删除；分段任务执行失败或被中断后，下次执行该分段任务时会尝试通过对应的断点记录文件恢复任务。 f 附加参数，可选 强制操作，不进行询问提示。 j 附加参数，可选 批量下载任务的最大并发数，默认为配置文件中的defaultJobs。 说明： 工具会保证该值至少为1。 exclude 附加参数，可选 不包含源对象的匹配模式，如：*.txt。 说明： 支持“*”匹配多个任意字符和“?”匹配单个任意字符，例如abc*.txt代表匹配以abc开头以.txt结尾的任意文件。 您可以使用“\*”代表匹配“*”字符本身，使用“\?”代表匹配“?”字符本身。 如果待下载的对象名匹配该参数，则跳过该对象的复制。 须知： 建议使用引号传递该匹配模式（macOS/Linux操作系统使用单引号，Windows操作系统使用双引号）防止特殊符号被操作系统转义，导致不可预期的结果。 该匹配模式作用于对象全路径（含从根路径开始的对象前缀和对象名，例如，桶内对象路径为obs://bucket/src1/src2/test.txt，则对象的全路径为src1/src2/test.txt）。 该匹配模式仅适用于对象名非“/”结尾的对象。 支持指定多个exclude参数，如-exclude=*.xxx -exclude=*.xxx include 附加参数，可选 包含源对象的匹配模式，如：*.jpg。 说明： 支持“*”匹配多个任意字符和“?”匹配单个任意字符。 您可以使用“\*”代表匹配“*”字符本身，使用“\?”代表匹配“?”字符本身。 首先执行exclude的匹配规则，如果待下载的对象名不匹配exclude，则判断待下载的对象名是否匹配该参数，如果匹配则下载该对象，否则跳过该文件的下载。 须知： 建议使用引号传递该匹配模式（macOS/Linux操作系统使用单引号，Windows操作系统使用双引号）防止特殊符号被操作系统转义，导致不可预期的结果。 该匹配模式作用于对象全路径（含从根路径开始的对象前缀和对象名，例如，桶内对象路径为obs://bucket/src1/src2/test.txt，则对象的全路径为src1/src2/test.txt）。 该匹配模式仅适用于对象名非“/”结尾的对象。 支持指定多个include参数，如-include=*.xxx -include=*.xxx timeRange 附加参数，可选 下载对象时的时间段匹配模式，仅下载最后修改时间在该时间段内的对象。 该匹配模式优先级低于对象名匹配模式：exclude和include，优先执行对象名匹配模式后才会执行该匹配模式。 说明： 使用“time1-time2”，代表匹配的时间段，其中time1必须小于等于time2，格式为yyyyMMddHHmmss。 时间格式支持自动补全，例如yyyyMMdd等价于yyyyMMdd000000，yyyyMM等价于yyyyMM01000000。 使用“*-time2”，代表匹配最后修改时间在time2之前的所有文件，使用“time1-*”，代表匹配最后修改时间time1之后的所有文件。 须知： 该匹配模式表示的时间是UTC时间。 该匹配模式仅适用于对象名非“/”结尾的对象。 mf 附加参数，可选 设置名称匹配模式（include、exclude）和时间匹配模式（timeRange）对对象名以“/”结尾的对象也生效。 o 附加参数，可选 生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果、失败结果和警告结果三个文件），默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。 说明： 结果清单文件命名规则：cp_{succeed | failed | warning}_report_时间_TaskId.txt。 单个结果清单文件默认情况下最大为30MB且最大可保留的文件个数为1024，可在配置文件中通过recordMaxLogSize和recordBackups分别配置。 当涉及多文件/文件夹时，如需确认失败任务的具体错误信息，可参考结果清单文件夹下的失败结果清单文件"cp_failed_report_时间_TaskId.txt"及日志路径下的日志文件； clear 附加参数，可选 设置在恢复下载任务完成后删除已恢复任务对应的失败结果清单文件。 config 附加参数，可选 运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。 e 附加参数，可选 指定终端节点。 i 附加参数，可选 指定用户的AK。 k 附加参数，可选 指定用户的SK。 t 附加参数，可选 指定用户的securitytoken。

列举桶内对象返回的大小与控制台桶内对象大小不一致 通过obsutil列举桶内全量对象时最终输出结果中还会包含对象的总的大小，如果通过列举操作返回的对象大小与通过控制台、OBSBrowser+工具查询的桶使用情况不一致时可以从如下两点进行排查： OBSBrowser+和控制台均通过调用获取桶存量信息接口查询当前桶内对象个数及对象占用空间，对应obsutil中调用stat命令返回的结果；由于OBS桶存量是后台统计，因此存量会有一定的时延，不能实时更新，因此不建议对存量做实时校验。 由于桶存量包含了桶内对象及桶内碎片的整体大小，而obsutil列举对象命令仅列举桶内对象不包含桶碎片，因此最终大小不包含桶内碎片的大小；可以通过OBSBrowser+或者控制台及obsutil列举分段上传任务命令查看当前桶内是否存在碎片。 父主题： 常见问题

同步复制示例 本章节案例中的所有命令均以Linux操作系统为例，提供同步复制操作指导。 假设源桶bucket-src内包含如下对象： obs://bucket-src/src1/obs://bucket-src/src1/test3.txtobs://bucket-src/src1/src2/obs://bucket-src/src1/src2/test1.txtobs://bucket-src/src1/src2/test2.txtobs://bucket-src/src1/src3/ 假设目标桶bucket-dest内包含如下对象： obs://bucket-dest/src1/obs://bucket-dest/src1/test3.txt 基于以上对象格式，不同场景下同步复制的命令示例如下： 同步bucket-src桶中src1文件夹下的文件和文件夹至bucket-dest桶的src1文件夹中，同步复制命令如下： ./obsutil sync obs://bucket-src/src1 obs://bucket-dest/src1 同步复制完成后，目标桶bucket-dest内的对象列表如下： obs://bucket-dest/src1/obs://bucket-dest/src1/test3.txtobs://bucket-dest/src1/src2/obs://bucket-dest/src1/src2/test1.txtobs://bucket-dest/src1/src2/test2.txtobs://bucket-dest/src1/src3/ 父主题： 常见示例

命令结构 Windows操作系统 obsutil cp -recover=xxx [-dryRun] [-tempFileDir=xxx] [-f] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-clear] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] macOS/Linux操作系统 ./obsutil cp -recover=xxx [-dryRun] [-tempFileDir=xxx] [-f] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-clear] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

命令结构 Windows操作系统 在指定桶内创建文件夹 obsutil mkdir obs://bucket/folder[/subfolder1/subfolder2] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] 在本地文件系统路径中创建文件夹 obsutil mkdir folder_url [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] macOS/Linux操作系统 在指定桶内创建文件夹 ./obsutil mkdir obs://bucket/folder[/subfolder1/subfolder2] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] 在本地文件系统路径中创建文件夹 ./obsutil mkdir folder_url [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例 以Windows操作系统为例，运行obsutil mkdir obs://bucket-test/folder1/folder2，在桶内创建文件夹。 obsutil mkdir obs://bucket-test/folder1/folder2The bucket [bucket-test] does not support POSIX, create folder(s) step by stepCreate folder [obs://bucket-test/folder1/] successfully, request id [0000016979E1D23C860BB3D8E4577C5E]Create folder [obs://bucket-test/folder1/folder2] successfully, request id [0000016979E1D2B2860BB5181229C72C]

参数说明 参数 约束 描述 bucket 在指定的桶内创建文件夹时必选 桶名。 folder 在指定的桶内创建文件夹时必选 桶内的文件夹路径，支持多级文件夹，以“/”分隔。 folder_url 在本地文件系统路径中创建文件夹时必选 本地文件系统中的文件夹路径，支持绝对路径和相对路径。 config 附加参数，可选 运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。 e 附加参数，可选 指定终端节点。 i 附加参数，可选 指定用户的AK。 k 附加参数，可选 指定用户的SK。 t 附加参数，可选 指定用户的securitytoken。

命令结构 Windows操作系统 obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] macOS/Linux操作系统 ./obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例 以Windows操作系统为例，运行obsutil ls obs://bucket-test -m -limit=10，查询桶内分段上传任务。 obsutil ls obs://bucket-test -m -limit=10Listing multipart uploads.Upload list:Key InitiatedStorageClass UploadIdobs://bucket-test/aaa 2018-11-27T03:49:07Zstandard 000001675348ED21860C3F61EF955BD3obs://bucket-test/dir1/10GB.txt 2018-11-07T06:58:09Zstandard 00000166ECF6CF7C860D1DBAF3F76013obs://bucket-test/dir1/1GB.txt 2018-11-07T06:58:09Zstandard 00000166ECF6CF6F860B7FBE95D01B03obs://bucket-test/dir1/50GB.txt 2018-11-07T06:58:09Zstandard 00000166ECF6CF86860D1DC2C8E8F66Bobs://bucket-test/dir1/5GB.txt 2018-11-07T06:58:09Zstandard 00000166ECF6CF75860CDA7780CB52C3obs://bucket-test/test11/20GB.txt 2018-11-27T08:21:26Zstandard 0000016754423D24860CA8A4D06C2054Folder number: 0Upload number: 6 更多运行示例，请参见列举分段上传任务示例。

参数说明 参数 约束 描述 bucket 必选 桶名。 prefix 可选 列举分段上传任务时的对象名前缀。 说明： 如果为空，则表示列举桶内所有分段上传任务。 s 附加参数，可选 以精简格式显示查询结果。 说明： 在精简格式下，返回结果只包含分段上传任务对象名和UploadId。 d 附加参数，可选 仅列举当前目录下的分段上传任务和子目录，而非递归列举所有分段上传任务和子目录。 m 附加参数，必选 列举桶内分段上传任务。 a 附加参数，可选 同时列举桶内对象和桶内分段上传任务。 marker 附加参数，可选 列举桶内分段上传任务的起始位置，返回结果是分段上传任务对象名按照字典序排序后该参数以后的所有分段上传任务。 说明： 请参考列举分段上传任务示例理解该参数的使用方式。 uploadIdMarker 附加参数，可选 列举桶内分段上传任务的起始位置，必须与marker配合使用。返回结果是对象名和UploadId按照字典序排序后该参数以后的所有分段上传任务。 limit 附加参数，可选 列举结果的最大个数，小于等于0表示列举所有结果。 说明： 如果桶内分段上传任务较多，建议设置该值限制每次列举的分段上传任务个数，列举结束后，如果仍有分段上传任务，会在结果中返回下次请求的marker和uploadIdMarker，用于继续列举剩余的分段上传任务。 format 附加参数，可选 指定以自定义格式打印列举结果。当前仅支持值[default]，指定列举结果在一行显示。 config 附加参数，可选 运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。 e 附加参数，可选 指定终端节点。 i 附加参数，可选 指定用户的AK。 k 附加参数，可选 指定用户的SK。 t 附加参数，可选 指定用户的securitytoken。

命令结构 Windows操作系统 obsutil cp -recover=xxx [-arcDir=xxx] [-dryRun] [-f] [-u] [-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] [-clear] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] macOS/Linux操作系统 ./obsutil cp -recover=xxx [-arcDir=xxx] [-dryRun] [-f] [-u] [-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] [-clear] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例 以Windows操作系统为例，运行obsutil cp -recover 104786c8-27c2-48fc-bc6a-5886596fb0ed -f，恢复失败的上传任务。 obsutil cp -recover 104786c8-27c2-48fc-bc6a-5886596fb0ed -fStart at 2024-10-08 01:10:07.3809685 +0000 UTCParallel: 5 Jobs: 5Threshold: 50.00MB PartSize: autoVerifyLength: false VerifyMd5: falseCheckpointDir: xxxxTask id: a628d6da-c562-4a1f-b687-4fa125de0dc3OutputDir: xxxxTempFileDir: xxxx[========================================================] 100.00% tps:35.71 2.02 KB/s 7.20MB/7.20MB 0sSucceed count: 1 Failed count: 0Succeed bytes: xxxMetrics [max cost:90 ms, min cost:45 ms, average cost:63.80 ms, average tps:35.71, transferred size:70B]Task id: a628d6da-c562-4a1f-b687-4fa125de0dc3

参数说明 参数 约束 描述 recover 附加参数，必选 待恢复上传任务结果清单文件的任务号。 说明： 任务号（TaskId）可在每次上传任务运行完毕后获取，或者通过结果清单文件名查询（文件名除去后缀.txt后的后36位）。 待恢复的上传任务会从结果清单的文件夹中查找，结果清单文件夹的路径参考附加参数o。 arcDir 附加参数，可选 上传文件成功后的归档路径，上传成功后的文件会移动到该路径下。 dryRun 附加参数，可选 测试模式运行，不执行实际的上传操作。 u 附加参数，可选 增量上传操作，设置该参数后，上传每个文件时会对比桶中对应路径的对象，仅在对象不存在，或者对象大小与文件大小不一致，或者文件的最后修改时间晚于对象的最后修改时间时进行上传。 注意： 在比较每个本地文件与桶内对象差异时，会产生一次HEAD请求费用。 vlength 附加参数，可选 上传完成后，验证桶中对象的大小是否与本地文件大小一致。 vmd5 附加参数，可选 上传完成后，验证桶中对象的MD5值是否与本地文件的MD5值一致。 说明： 如果待上传的本地文件较大，使用该参数将会因为计算MD5而导致整体性能下降。 MD5值校验通过后，会将该值设置为对象元数据x-obs-meta-md5chksum，用于下载或复制时校验MD5。 注意： 如果您的业务涉及加密场景，请勿使用该参数。 p 附加参数，可选 每个分段上传任务的最大并发数，默认为配置文件中的defaultParallels。 threshold 附加参数，可选 开启分段上传任务的阈值，单位：字节，默认为配置文件中的defaultBigfileThreshold。 说明： 如果待上传的文件小于该阈值，则使用直接上传模式；否则使用分段上传模式。 直接上传模式不会产生断点记录文件，不支持断点续传。 支持带容量单位配置，例如，配置1MB代表1048576字节。 acl 附加参数，可选 上传文件时可指定的预定义访问策略。支持的值： private public-read public-read-write 说明： 以上三个值分别对应：私有读写、公共读、公共读写，三种预定义访问策略。 sc 附加参数，可选 上传文件时可指定的对象的存储类型。支持的值： standard：标准存储，访问时延低、吞吐量高，适用于有大量热点文件（平均一个月多次）或小文件（小于1MB）。 warm：低频访问存储，可用性略低于standard，适用于不频繁访问（平均一年少于12次）但在需要时也要求快速访问数据的业务场景。 cold：归档存储，安全、持久且成本极低，适用于很少访问（平均一年访问一次）数据的业务场景。 meta 附加参数，可选 上传文件时可指定的自定义元数据。格式为：key1:value1#key2:value2#key3:value3。 说明： 以上值表示上传文件完成后，桶内对象包含三组自定义元数据，分别为：key1:value1、key2:value2、key3:value3。 ps 附加参数，可选 每个分段上传任务的段大小，单位：字节，取值范围是100KB~5GB，默认为配置文件中的defaultPartSize。 说明： 支持带容量单位配置，例如，配置1MB代表1048576字节。 支持配置为auto，此时obsutil会根据源文件大小自动设置每个分段任务的段大小。 cpd 附加参数，可选 生成断点记录文件的文件夹，默认为运行obsutil命令的用户目录的子文件夹.obsutil_checkpoint。 说明： 每个分段上传任务会产生唯一对应的断点记录文件并保存至该文件夹的upload子文件夹下，分段任务执行成功后，对应的断点记录文件会被自动删除；分段任务执行失败或被中断后，下次执行该分段任务时会尝试通过对应的断点记录文件恢复任务。 f 附加参数，可选 强制操作，不进行询问提示。 j 附加参数，可选 上传文件夹时任务的最大并发数，默认为配置文件中的defaultJobs。 说明： 工具会保证该值至少为1。 exclude 附加参数，可选 不包含文件的匹配模式，如：*.txt。 说明： 支持“*”匹配多个任意字符和“?”匹配单个任意字符，例如abc*.txt代表匹配以abc开头以.txt结尾的任意文件。 您可以使用“\*”代表匹配“*”字符本身，使用“\?”代表匹配“?”字符本身。 如果待上传的文件名匹配该参数，则跳过该文件的上传。 须知： 建议使用引号传递该匹配模式（macOS/Linux操作系统使用单引号，Windows操作系统使用双引号）防止特殊符号被操作系统转义，导致不可预期的结果。 该匹配模式作用于文件全路径（含文件名和文件目录）。 该匹配模式不适用于文件夹。 支持指定多个exclude参数，如-exclude=*.xxx -exclude=*.xxx include 附加参数，可选 包含文件的匹配模式，如：*.jpg。 说明： 支持“*”匹配多个任意字符和“?”匹配单个任意字符。 您可以使用“**”代表匹配“*”字符本身，使用“\?”代表匹配“?”字符本身。 首先执行exclude的匹配规则，如果待上传的文件名不匹配exclude，则判断待上传的文件名是否匹配该参数，如果匹配则上传该文件，否则跳过该文件的上传。 须知： 建议使用引号传递该匹配模式（macOS/Linux操作系统使用单引号，Windows操作系统使用双引号）防止特殊符号被操作系统转义，导致不可预期的结果。 该匹配模式作用于文件全路径（含文件名和文件目录）。 该匹配模式不适用于文件夹。 支持指定多个include参数，如-include=*.xxx -include=*.xxx at 附加参数，可选 恢复上传文件时指定按照文件最后访问时间作为timeRange匹配模式，仅上传最后访问时间满足timeRange时间段的文件。 说明： 需配合timeRange使用 timeRange 附加参数，可选 上传文件时的时间段匹配模式，仅上传最后修改时间在该时间段内的文件。 该匹配模式优先级低于文件名匹配模式：exclude和include，优先执行文件名匹配模式后才会执行该匹配模式。 说明： 使用“time1-time2”，代表匹配的时间段，其中time1必须小于等于time2，格式为yyyyMMddHHmmss。 时间格式支持自动补全，例如yyyyMMdd等价于yyyyMMdd000000，yyyyMM等价于yyyyMM01000000。 使用“*-time2”，代表匹配最后修改时间在time2之前的所有文件，使用“time1-*”，代表匹配最后修改时间time1之后的所有文件。 须知： 该匹配模式表示的时间是UTC时间。 mf 附加参数，可选 设置名称匹配模式（include、exclude）和时间匹配模式（timeRange）对对象名以“/”结尾的对象也生效。 o 附加参数，可选 生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果、失败结果和警告结果三个文件），默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。 说明： 结果清单文件命名规则：cp_{succeed | failed | warning}_report_时间_TaskId.txt。 单个结果清单文件默认情况下最大为30MB且最大可保留的文件个数为1024，可在配置文件中通过recordMaxLogSize和recordBackups分别配置。 当涉及多文件/文件夹时，如需确认失败任务的具体错误信息，可参考结果清单文件夹下的失败结果清单文件"cp_failed_report_时间_TaskId.txt"及日志路径下的日志文件； clear 附加参数，可选 设置在恢复上传任务完成后删除已恢复任务对应的失败结果清单文件。 config 附加参数，可选 运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。 e 附加参数，可选 指定终端节点。 i 附加参数，可选 指定用户的AK。 k 附加参数，可选 指定用户的SK。 t 附加参数，可选 指定用户的securitytoken。

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

命令结构 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 -fStart at 2024-09-25 04:48:10.1147483 +0000 UTCDelete 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 -fStart at 2024-09-30 08:46:55.5335644 +0000 UTC[===============================================] 100.00% 21sSucceed count: 1313 Failed count: 0Task id: 95936984-f81a-441a-bba0-1fd8254d9241

删除桶内全部分段上传任务 本章节案例中的所有命令均以Linux操作系统为例，提供删除桶内全部分段上传操作指导。 假设bucket-test桶内包含如下分段上传任务： obs://bucket-test/task1.txt uploadid1obs://bucket-test/task1.txt uploadid2obs://bucket-test/task2.txt uploadid3obs://bucket-test/task3.txt uploadid4obs://bucket-test/src1/obs://bucket-test/src1/task4.txt uploadid5obs://bucket-test/src2/obs://bucket-test/src2/task5.txt uploadid6 可以使用如下命令一次性删除桶内全部分段上传任务的碎片： ./obsutil abort obs://bucket-test -r -f 父主题： 常见示例

命令结构 Windows操作系统 交互模式更新配置 obsutil config [-interactive] [-crr] [-config=xxx] 直接更新配置 obsutil config [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-crr] [-config=xxx] macOS/Linux操作系统 交互模式更新配置 ./obsutil config [-interactive] [-crr] [-config=xxx] 直接更新配置 ./obsutil config [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-crr] [-config=xxx]

运行示例 以Windows操作系统为例，运行obsutil config -interactive，更新默认配置文件的访问密钥和OBS服务地址。 obsutil config -interactivePlease input your ak:xxxxxxxxxxxxxxxxxxxxxxxxxPlease input your sk:xxxxxxxxxxxxxxxxxxxxxxxxxPlease input your endpoint:xxxxxxxxxxxxxxxxxxxxxxxxxPlease input your token:xxxxxxxxxxxxxxxxxxxxxxxxxConfig file url: C:\Users\tools\.obsutilconfigUpdate config file successfully! 以Linux操作系统为例，运行./obsutil config -interactive，更新默认配置文件的访问密钥和OBS服务地址。 ./obsutil config -interactivePlease input your ak:xxxxxxxxxxxxxxxxxxxxxxxxxPlease input your sk:xxxxxxxxxxxxxxxxxxxxxxxxxPlease input your endpoint:xxxxxxxxxxxxxxxxxxxxxxxxxPlease input your token:xxxxxxxxxxxxxxxxxxxxxxxxxConfig file url: /root/.obsutilconfigUpdate config file successfully!

参数说明 参数 约束 描述 interactive 附加参数，可选 使用交互模式更新配置。 须知： 为了安全性，建议您使用该模式来配置ak和sk。 e 附加参数，可选 将配置文件中的endpoint|endpointCrr取值更新为输入的值，endpoint|endpointCrr的详细描述请参见配置参数说明。 i 附加参数，可选 将配置文件中的ak|akCrr取值更新为输入的值，ak|akCrr的详细描述请参见配置参数说明。 k 附加参数，可选 将配置文件中的sk|skCrr取值更新为输入的值，sk|skCrr的详细描述请参见配置参数说明。 t 附加参数，可选 将配置文件中的token|tokenCrr取值更新为输入的值，token|tokenCrr的详细描述请参见配置参数说明。 crr 附加参数，可选 更新配置文件中客户端跨区域复制模式的相关配置信息。 说明： 不配置该参数，e、i、k、t更新的配置文件中的字段为endpoint、ak、sk、token。 配置该参数后，e、i、k、t更新的配置文件中的字段变为endpointCrr、akCrr、skCrr、tokenCrr。 config 附加参数，可选 运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。 通过携带此参数并指定路径，可更新自定义配置文件的参数；不携带此参数则表示更新默认配置文件参数。