检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
身份认证与访问控制 身份认证 用户访问OBS的方式有多种，包括OBS控制台、OBS客户端（OBS Browser+）、OBS命令行工具（obsutil）、API、SDK，无论访问方式封装成何种形式，其本质都是通过OBS提供的REST风格的API接口进行请求。 OBS的接口既支持认
查看命令帮助 功能说明 查看工具支持的命令，或查看某个具体命令的帮助文档。 命令结构 Windows操作系统 obsutil help [command] macOS/Linux操作系统 ./obsutil help [command] 运行示例 以Windows操作系统为例，运行obsutil
第一次运行obsutil后，工具会对AK进行加密以保护密钥安全。 N/A sk 可选 访问密钥中的SK。当配置了autoChooseSecurityProvider为true时可选。 说明： 您可以从这里进入访问密钥管理界面； 第一次运行obsutil后，工具会对SK进行加密以保护密钥安全。
同步上传示例 本章节案例中的所有命令均以Linux操作系统为例，提供同步上传操作指导。 假设本地文件夹的格式如下： └── src1 ├── src2 ├── test1.txt └── test2.txt ├── src3
同步下载示例 本章节案例中的所有命令均以Linux操作系统为例，提供同步下载操作指导。 假设bucket-test桶内包含如下对象： obs://bucket-test/src1/ obs://bucket-test/src1/test3.txt obs://bucket-test/src1/src2/
说明如表1所示。您通常需要结合多种方式以准确定位问题。 表1 问题定位方式 方式 说明 日志文件 obsutil的日志文件分为工具日志和SDK日志，工具日志可以记录obsutil在运行过程中的正常/异常信息，SDK日志可以记录在请求OBS服务过程中的正常/异常信息。 结果清单 批
返回码 通过进程等方式调用obsutil时，无法实时查看回显信息。obsutil支持在进程运行结束后，根据不同的运行结果生成不同的返回码，具体的返回码及其含义如表1所示。您可以通过以下方式获取最近一次运行结果的返回码，然后根据返回码分析并处理问题。 macOS/Linux操作系统
将obsutil设为系统内置命令 操作场景 作为外部软件，obsutil命令需要进入obsutil工具所在目录后方可运行，易用性较差。 操作系统提供内置命令，在系统启动时就将依赖的目录调入内存，这样在任意目录下都可以运行命令，提高工具易用性。 本章根据不同操作系统，分别介绍如何将obsutil设置为系统内置命令。
资源准备 使用obsfs之前，您需要完成如表1所示的资源准备。 表1 资源准备 资源项 说明 操作指导 华为账号 账号是您访问华为云的主体，可以管理IAM用户、访问密钥及OBS并行文件系统等obsfs需要的资源，使用obsfs之前，您需要拥有一个已成功开通OBS的账号。 注册华为账号并开通华为云
待下载的对象名，或批量下载的对象名前缀。 下载对象时，该值不能为空，最终保存在本地的位置及命名规则如下： 如果file_or_folder_url不存在，则工具会判断其是否以“/”或“\”结尾，如果是，则会以该路径创建文件夹，将对象下载到该新建的文件夹下； 如果file_or_folder_url
j 附加参数，多文件/文件夹上传或上传文件夹时可选 上传文件夹时批量任务的最大并发数，默认为配置文件中的defaultJobs。 说明： 工具会保证该值至少为1。 encoding-type 附加参数，可选 对象名有特殊字符时，取值为url。 说明： Util 5.5.12版本及以上支持该参数。
附加参数，批量复制时可选 强制操作，不进行询问提示。 j 附加参数，批量复制时可选 批量复制时的最大并发数，默认为配置文件中的defaultJobs。 说明： 工具会保证该值至少为1。 exclude 附加参数，批量复制时可选 不包含源对象的匹配模式，如：*.txt。 说明： 支持“*”匹配多个任意字符和“
设置桶策略 功能说明 设置桶策略。 命令结构 Windows操作系统 obsutil bucketpolicy obs://bucket -method=put -localfile=xxx [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
创建桶 功能说明 按照用户指定的桶名创建一个新桶。新创建桶的桶名在OBS中必须是唯一的。一个用户可以拥有的桶的数量不能超过100个。 如果是同一个用户在同一区域的重复创建同名桶不会报错，返回HTTP状态码200，创建的桶属性以第一次请求为准。除此以外的其他场景重复创建同名桶返回HTTP状态码409，表明桶已存在。
SDK概述 对象存储服务软件开发工具包（OBS SDK，Object Storage Service Software Development Kit）是对OBS服务提供的REST API进行的封装，以简化用户的开发工作。用户直接调用OBS SDK提供的接口函数即可实现使用OBS服务业务能力的目的。
查询桶属性 功能说明 查询单个桶的基本属性，包括桶的默认存储类型、桶的区域、桶的版本号、桶是否支持文件接口、桶的可用区、桶中对象数量、桶的存储用量以及桶的配额。 命令结构 Windows操作系统 obsutil stat obs://bucket [-acl] [-bf=xxx]
更新配置文件 功能说明 更新配置文件（.obsutilconfig）中的部分配置信息，可更新的配置包括：endpoint、ak、sk、token。 关于配置文件（.obsutilconfig）中参数的详细说明，请参见配置参数说明。 命令结构 Windows操作系统 交互模式更新配置
列举示例 本章节案例中的所有命令均以Linux操作系统为例，提供列举操作指导。 假设bucket-test桶内包含如下对象： obs://bucket-test/test1.txt obs://bucket-test/test2.txt obs://bucket-test/test3
设置桶属性 功能说明 设置桶的存储类型、访问策略等属性。 命令结构 Windows操作系统 obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx] [-e=xxx] [-i=xxx]
[-i=xxx] [-k=xxx] [-t=xxx] 运行示例 以Windows操作系统为例，运行obsutil archive，归档日志到工具运行的同级目录。 obsutil archive [----------------------------------------------------------]
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
