检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
obsutil简介 obsutil是一款用于访问管理华为云对象存储服务(Object Storage Service,OBS)的命令行工具,您可以使用该工具对OBS进行常用的配置管理操作,如创建桶、上传文件/文件夹、下载文件/文件夹、删除文件/文件夹等。
obsfs简介 obsfs工具于2024年7月1日下线,下线后OBS不再对此工具提供维护和客户支持服务,请使用s3fs将OBS对象桶挂载至Linux系统,给您带来不便敬请谅解。如有问题请提交工单寻求技术支持。
日志简介 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。 OBS允许您对桶设置访问日志记录,设置之后对于桶的访问会被记录成日志,日志存储在OBS上您指定的目标桶中。
j 附加参数,批量删除对象时可选 批量删除对象时的最大并发数,默认为配置文件中的defaultJobs。 说明: 工具会保证该值至少为1。 v 附加参数,批量删除对象时可选 按指定的对象名前缀批量删除多版本对象和多版本删除标记。
/obsutil stat obs://bucket/key [-acl][-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] 运行示例 以Windows操作系统为例,运行obsutil stat obs://bucket-test
=xxx] [-i=xxx] [-k=xxx] [-t=xxx] 运行示例 以Windows操作系统为例,运行obsutil chattri obs://bucket-test/key -acl=public-read,设置对象的访问策略为公共读。
说明: OBS中约定以“/”作为目录分隔符。 v 附加参数,可选 列举桶内多版本对象,列举结果包含最新版本的对象和历史版本的对象(如果有)。 marker 附加参数,可选 列举桶内对象的起始位置,返回结果是对象名按照字典序排序后该参数以后的所有对象。
运行示例 以Windows操作系统为例,运行obsutil cp obs://bucket-test/key obs://bucket-test2 ,复制单个对象。
如果该值为空,则表示列举授权码中授权路径下的所有对象。 s 附加参数,可选 以精简格式显示查询结果。 说明: 在精简格式下,返回结果只包含对象名。 d 附加参数,可选 仅列举当前目录下的对象和子目录,而非递归列举所有对象和子目录。 说明: OBS中约定以“/”作为目录分隔符。
下载对象 功能说明 下载对象或按对象名前缀批量下载对象到本地。 下载对象或批量下载时,请确保OBS桶中的源对象不发生变化,否则可能产生下载失败或者数据不一致的问题。 如果待下载对象的存储类型为低频访问存储,必须首先恢复待下载对象,否则无法下载成功。
通过s3fs挂载OBS对象桶 应用场景 对于原本使用本地文件系统存储数据的用户,希望把数据存储在OBS上但不改变数据的访问方式,推荐使用s3fs。
父主题: 对象相关命令
授权码下载对象 功能说明 使用授权码下载对象或按对象名前缀批量下载对象到本地。 下载对象或批量下载时,请确保OBS桶中的源对象不发生变化,否则可能产生下载失败或者数据不一致的问题。
运行示例 以Windows操作系统为例,运行obsutil mv obs://bucket-test/key obs://bucket-test2 ,移动单个对象。
MD5值校验通过后,会将该值设置为对象元数据x-obs-meta-md5chksum,用于下载或复制时校验MD5。 注意: 如果您的业务涉及加密场景,请勿使用该参数。 p 附加参数,可选 每个分段上传任务的最大并发数,默认为配置文件中的defaultParallels。
key 可选 上传文件时的对象名/对象名前缀,或上传文件夹时的对象名前缀。 规则如下: 上传文件时,如果该值为空,则将对象上传到桶的根目录,对象名为文件名。
运行示例 以Windows操作系统为例,运行obsutil sync obs://bucket-test/temp/ obs://bucket-test2/temp/,同步复制对象。
增量同步下载对象 功能说明 将OBS源桶指定路径下的所有对象同步到本地目标路径,使两边内容保持一致。
增量同步上传对象 功能说明 将本地源路径下的所有内容同步到OBS指定目标桶,使两边内容保持一致。此处的增量同步有两层含义: 增量,依次比较源文件和目标对象,只上传存在变化的源文件。
响应结果 请参考上传对象的响应结果。 父主题: 对象相关命令