检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查看命令帮助 功能说明 查看工具支持的命令，或查看某个具体命令的帮助文档。 命令结构 Windows操作系统 obsutil help [command] macOS/Linux操作系统 ./obsutil help [command] 运行示例 以Windows操作系统为例，运行obsutil
辅助命令 更新配置文件 删除断点记录文件 查看命令帮助 查看版本号 归档日志文件 检查并更新版本 列举失败结果清单文件
将obsutil设为系统内置命令 操作场景 作为外部软件，obsutil命令需要进入obsutil工具所在目录后方可运行，易用性较差。 操作系统提供内置命令，在系统启动时就将依赖的目录调入内存，这样在任意目录下都可以运行命令，提高工具易用性。 本章根据不同操作系统，分别介绍如何将obsutil设置为系统内置命令。
桶相关命令 创建桶 列举桶 查询桶属性 设置桶属性 删除桶 设置桶策略 获取桶策略 删除桶策略
对象相关命令 创建文件夹 上传对象 查询对象属性 设置对象属性 列举对象 复制对象 移动对象 下载对象 生成对象的下载链接 删除对象 增量同步上传对象 增量同步复制对象 增量同步下载对象 恢复归档存储对象 恢复失败的上传任务 恢复失败的复制任务 恢复失败的下载任务 列举分段上传任务
删除桶，待删除的桶必须为空（不包含对象、历史版本对象或分段上传碎片）。 如果要删除非空桶，请先使用删除分段上传任务命令和删除对象命令，将桶清空后再执行删除桶命令。 命令结构 Windows操作系统 obsutil rm obs://bucket [-f] [-config=xxx]
通过obsutil命令行工具快速使用OBS obsutil是一款命令行工具，对于熟悉命令行的用户，obsutil能在执行批量处理、自动化任务的场景中为您带来更优体验。 本章节以Linux操作系统为例，以上传一个文件至“bucket-test”桶为例，帮助您快速通过obsutil使
过操作系统提供的重定向操作实现将列举结果从屏显的标准输出重定向到指定的本地结果文件中；以列举桶内对象为例： Windows操作系统（在命令行cmd下执行该重定向操作） obsutil ls obs://bucketName -format=default -limit=0 > D:/result
列举失败结果清单文件 功能说明 按最后修改时间列举指定文件夹中cp命令及sync命令生成的失败结果清单文件。 命令结构 Windows操作系统 obsutil ls -failed [-limit=1000] [-o=xxx] macOS/Linux操作系统 ./obsutil ls
如果该值不为空，如果该值以“/”结尾，则以该值作为对象名前缀归档日志，对象名为该值+obsutil_log.zip；否则，将该值作为对象名进行归档； config 附加参数，可选 运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。 e 附加参数，可选 指定终端节点。 i 附加参数，可选 指定用户的AK。
按指定的对象名前缀批量删除多版本对象和多版本删除标记。 o 附加参数，可选 生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果和失败结果两个文件），默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。 说明： 结果清单文件命名规则：rm_{succeed
在，或者目标对象大小与源对象大小不一致，或者目标对象的最后修改时间早于源对象的最后修改时间时进行移动。 说明： 如果目标对象与源对象大小以及修改时间都一致，此时会直接删除源对象，而不进行移动操作。 p 附加参数，可选 每个分段移动任务的最大并发数，默认为配置文件中的defaultParallels。
象名以“/”结尾的对象也生效。 o 附加参数，可选 生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果、失败结果和警告结果三个文件），默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。 说明： 结果清单文件命名规则：cp_{succeed
附加参数，可选 元数据操作指示符。 取值为REPLACE_NEW或REPLACE。 REPLACE_NEW表示：对于已经存在值的元数据进行替换，不存在值的元数据进行赋值，未指定的元数据保持不变。 REPLACE表示：使用当前请求中携带的头域完整替换，未指定的元数据会被删除。 说明： 该参数需要与meta搭配使用才会生效。
附加参数，可选 运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。 e 附加参数，可选 指定终端节点。 i 附加参数，可选 指定用户的AK。 k 附加参数，可选 指定用户的SK。 t 附加参数，可选 指定用户的securitytoken。 父主题： 桶相关命令
同步下载每个对象时会对比本地对应路径的文件，仅在文件不存在，或者文件大小与对象大小不一致，或者文件的最后修改时间早于对象的最后修改时间时进行下载。 在比较每个本地文件与桶内对象差异时，会产生一次HEAD请求费用。 命令结构 Windows操作系统 obsutil sync obs://bucket[/key] folder_url
同步上传每个文件时会对比桶中对应路径的对象，仅在对象不存在，或者对象大小与文件大小不一致，或者对象的最后修改时间早于文件的最后修改时间时进行上传。 在比较每个本地文件与桶内对象差异时，会产生一次HEAD请求费用。 命令结构 Windows操作系统 同步上传文件 obsutil sync file_url obs://bucket[/key]
仅当使用cp命令并且配置了-vmd5选项上传对象后，才能查询到该值。 ETag 服务端计算的对象ETag值。 ContentType 对象的Content-Type。 Type 对象的类型。 Metadata 对象的自定义元数据。 Acl 对象的访问策略。 父主题： 对象相关命令
eRange）对文件夹也生效。 o 附加参数，可选 生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果、失败结果、警告结果三个文件），默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。 说明： 结果清单文件命名规则：cp_{succeed
置信息为配置文件中的：ak/sk/token/endpoint。 须知： 开启跨区域复制后，因为会占用执行命令主机上传和下载的双向带宽、CPU和内存等资源，可能会影响执行命令主机的性能。 vlength 附加参数，可选 复制完成后，验证目标桶对象大小是否与源桶中对象的大小一致。 说明：
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
