华为云用户手册

日志级别 当系统出现问题需要定位且当前的日志无法满足要求时，可以通过修改日志的级别来获取更多的信息。其中TRACE日志信息最丰富，ERROR日志信息最少。可以通过LogConfigurator.setLogLevel设置日志级别。 具体说明见下表： 日志级别 说明 OBS Android SDK对应值 OFF 关闭级别，如果设置为这个级别，日志打印功能将被关闭。 LogConfigurator.OFF TRACE 跟踪级别，如果设置为这个级别，将打印所有日志信息。通常不建议使用。 LogConfigurator.TRACE DEBUG 调试级别，如果设置为这个级别，除了打印INFO级别以上的信息外，还将打印每次HTTP/HTTPS请求和响应的头信息，鉴权算法计算出的StringToSign信息等。 LogConfigurator.DEBUG INFO 信息级别，如果设置为这个级别，除了打印WARN级别以上的信息外，还将打印HTTP/HTTPS请求的耗时时间，ObsClient接口的耗时时间等。 LogConfigurator.INFO WARN 告警级别，如果设置为这个级别，除了打印ERROR级别以上的信息外，还将打印一些关键事件的信息，如重试请求超过最大次数等。 LogConfigurator.WARN ERROR 错误级别，如果设置为这个级别，仅打印发生异常时的错误信息。 LogConfigurator.ERROR

日志内容格式 SDK日志格式为：日志时间|线程号|日志级别|日志内容。示例如下： 2017-08-21 17:40:07 133|main|INFO |HttpClient cost 157 ms to apply http request2017-08-21 17:40:07 133|main|INFO |Received expected response code: true2017-08-21 17:40:07 133|main|INFO |expected code(s): [200, 204].2017-08-21 17:40:06 820|main|INFO |Storage|1|HTTP+XML|ObsClient||||2017-08-21 17:40:05|2017-08-21 17:40:06|||0|2017-08-21 17:40:07 136|main|INFO |Storage|1|HTTP+XML|setObjectAcl||||2017-08-21 17:40:06|2017-08-21 17:40:07|||0|2017-08-21 17:40:07 137|main|INFO |ObsClient [setObjectAcl] cost 312 ms

修订记录 发布日期 修订记录 2021-08-30 第十五次正式发布 发布3.21.8 版本 添加设置对象属性章节 2021-07-30 第十四次正式发布。 发布3.21.4 版本 2020-04-27 第十三次正式发布。 发布3.20.3版本 2020-02-20 第十二次正式发布。 发布3.20.1版本 2019-11-20 第十一次正式发布。 调整以下章节的位置： 示例程序 技术支持渠道 2019-08-10 第十次正式发布： 修改章节： 创建OBS客户端 2019-03-30 第九次正式发布。 增加章节： API参考。 2019-03-05 第八次正式发布。 修改章节： “事件通知”各子章节，新增 函数工作流 服务功能的说明及代码样例。 新增章节： SDK是否支持批量上传、下载或复制对象？ 2019-02-18 第七次正式发布。 修改章节： 日志分析 ，修改内容。 2018-10-31 第六次正式发布。 新增章节： 获取上传进度 获取下载进度 修改章节： 配置OBS客户端，新增部分配置参数。 安装SDK，修改安装步骤。 2018-08-31 第五次正式发布。 新增章节： 设置对象生命周期 追加上传 基于表单上传 2018-01-31 第四次正式发布。 调整章节： “快速入门”，新增OBS服务环境搭建、开发环境准备、安装SDK、获取服务地址。 “相关资源”，新增示例程序，移除OBS服务端环境搭建。 “初始化”，移除服务地址。 修改章节： “临时授权访问”章节，修改示例代码。 “设置生命周期规则”章节，修改示例代码。 “查看生命周期规则”章节，修改示例代码。 2017-12-31 第三次正式发布。 新增章节： 图片处理 修改章节： 安装方式，新增Maven安装方式。 生命周期管理，新增对象转换策略特性。 2017-11-30 第二次正式发布。 新增章节： 桶存储类型 断点续传上传 断点续传下载 修改章节： 设置对象属性，新增设置对象存储类型相关内容。 2017-10-31 第一次正式发布。

兼容性 版本修订记录信息：ChangeLog。 推荐使用的Android系统版本：Android 7.0，8.0，8.1, 9.0, 10.0版本（HTTP/HTTPS协议）。 命名空间：与旧版本（2.1.x）保持兼容，对外的接口都包含在com.obs.services，com.obs.services.model和com.obs.services.exception三个包中。 接口函数：与旧版本（2.1.x）保持兼容。 Android 4.4及以下版本只能使用配置HTTP协议访问OBS服务。

混淆配置 #okhttp-dontwarn okhttp3.**-keep class okhttp3.**{*;}#okio-dontwarn okio.**-keep class okio.**{*;}#sdk-keep class com.obs.services.** {*;}-keep class com.obs.log.** {*;}#java-xmlbuilder-keep class com.jamesmurty.utils.**{*;}

加密说明 开发过程中，您有任何问题可以在github上提交issue，或者在华为云 对象存储服务 论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。 OBS Android SDK支持服务端加密的接口见下表： OBS Android SDK接口方法 描述 支持加密类型 ObsClient.putObject 上传对象时设置加密算法、密钥，对对象启用服务端加密。 SSE-KMS SSE-C ObsClient.getObject 下载对象时设置解密算法、密钥，用于解密对象。 SSE-C ObsClient.copyObject 复制对象时设置源对象的解密算法、密钥，用于解密源对象。 复制对象时设置目标对象的加密算法、密钥，对目标对象启用加密算法。 SSE-KMS SSE-C ObsClient.getObjectMetadata 获取对象元数据时设置解密算法、密钥，用于解密对象。 SSE-C ObsClient.initiateMultipartUpload 初始化分段上传任务时设置加密算法、密钥，对分段上传任务最终生成的对象启用服务端加密。 SSE-KMS SSE-C ObsClient.uploadPart 上传段时设置加密算法、密钥，对分段数据启用服务端加密。 SSE-C ObsClient.copyPart 复制段时设置源对象的解密算法、密钥，用于解密源对象。 复制段时设置目标段的加密算法、密钥，对目标段启用加密算法。 SSE-C 父主题： 服务端加密

静态网站托管简介 开发过程中，您有任何问题可以在github上提交issue，或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。 您可以将静态网站文件上传至OBS的桶中作为对象，并对这些对象赋予公共读权限，然后将该桶配置成静态网站托管模式，以实现在OBS上托管静态网站的目的。第三方用户在访问您网站的时候，实际上是在访问OBS的桶中的对象。在使用静态网站托管功能时，OBS还支持配置请求重定向，通过重定向配置您可以将特定的请求或所有请求实施重定向。 更多关于静态网站托管的内容请参考静态网站托管。 父主题： 静态网站托管

操作步骤 登录OBS管理控制台。 在顶部导航栏单击用户名，并选择“我的凭证”。 在“我的凭证”页面，单击左侧导航栏的“访问密钥”。 在“访问密钥”页面，单击“新增访问密钥”。 每个用户最多可创建两个有效的访问密钥。 在弹出的“新增访问密钥”对话框中，输入登录密码和对应验证码。 用户如果未绑定邮箱和手机，则只需输入登录密码。 用户如果同时绑定了邮箱和手机，可以选择其中一种方式进行验证。 单击“确定”。 根据浏览器提示，保存密钥。密钥会直接保存到浏览器默认的下载文件夹中。 为防止访问密钥泄露，建议您将其保存到安全的位置。如果用户在此提示框中单击“取消”，则不会下载密钥，后续也将无法重新下载。如果需要使用访问密钥，可以重新创建新的访问密钥。 访问密钥（AK和SK）需定期更新。 打开下载下来的“credentials.csv”文件既可获取到访问密钥（AK和SK）。

背景知识 AK和SK支持 IAM 的认证机制，以下是对AK和SK的解释说明： AK：Access Key ID，接入键标识，用户在OBS系统中的接入键标识，一个接入键标识唯一对应一个用户，一个用户可以同时拥有多个接入键标识。OBS系统通过接入键标识识别访问系统的用户。 SK：Secret Access Key，安全接入键，用户在OBS系统中的安全接入键，是用户访问OBS系统的密钥，用户根据安全接入键和请求头域生成鉴权信息。安全接入键和接入键标识一一对应。

操作步骤 登录OBS Browser。 在主页面右上角的搜索框中输入需要查找的桶名。 单击。 搜索到的桶会显示在桶列表中。若想重新搜索其他桶，可单击删除已输入的关键字后重新输入需要搜索的桶名。 若用户当前处于对象列表界面，需要快速切换到其他桶，则可单击页面左侧图标展开隐藏的桶列表，并在桶列表上方搜索框中搜索需要切换到的桶。 例如：您需要查找桶名中包含“test”字符的所有桶，您只需在主页面右上角的搜索框中输入“test”并单击，所有包含“test”字符的桶都会展示到桶列表中。

操作步骤 登录OBS Browser。 单击待操作的桶，选中需要下载的文件或文件夹后，单击右键选择“下载”。 客户端支持批量下载，选择多个文件或文件夹，单击对象列表上方的“下载”即可批量下载对象。 对于存储类别为归档存储的桶中的文件，需要确认对象的状态为“已恢复”才能对其进行下载。 在对话框中选择存放文件或文件夹的路径后，单击“确定”。 如果目标路径下存在同名文件，系统会弹出“目标路径存在同名文件，请选择保存方式”，您可以选择“均保留”或者“覆盖”。

功能概述 目前，OBS Browser提供的功能如表1所示： 表1 功能概述 功能 说明 桶基本操作 指定region（不同服务区域）创建不同存储类别的桶、删除桶、修改桶的存储类别等。 对象基本操作 管理对象，包括上传（含多段上传功能）、下载、重命名、移动、复制、删除、通过对象URL共享数据、修改对象的存储类别、恢复归档存储对象等。 支持批量上传和下载对象，支持分段上传功能。 碎片管理 碎片管理功能可以清除由于对象上传失败而产生的数据。 权限控制 OBS Browser支持通过桶策略、对象策略、桶ACL和对象ACL进行权限控制。 服务端加密 用户可根据需要对对象进行服务端加密，使对象更安全的存储在OBS中。 跨域资源共享 跨域资源共享（CORS）是由W3C标准化组织提出的一种网络浏览器的规范机制，定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中，由于同源安全策略（Same Origin Policy，SOP）的存在，不同域之间的网站脚本和内容是无法进行交互的。 日志记录 支持对桶的访问请求创建并保存访问日志记录，可用于进行请求分析或日志审计。 生命周期管理 支持设置桶的生命周期管理策略，实现自动删除超期的对象。 挂载外部桶 方便用户管理其他OBS用户共享的数据。 CDN下载 可以为本桶绑定的自定义域名配置启用CDN下载，以实现在OBS Browser上下载对象时，从 CDN加速 节点获取，提高下载速度。 任务管理 方便用户管理上传、下载、重命名、移动、复制、删除、恢复任务。 父主题： OBS Browser介绍

桶管理方法介绍 OBS Browser支持以下三种方式管理桶。 通过OBS Browser桶列表上方的操作按钮管理桶。 单击待操作桶所在行，选择桶列表上方的操作按钮管理桶，如图1所示。 图1 桶管理第一种方法 通过桶所在行右侧的操作按钮管理桶。 单击待操作桶所在行右侧的操作按钮管理桶，如图2所示。 图2 桶管理第二种方法 通过右键选项管理桶。 右键单击待操作桶所在行，通过选择弹出框里的操作管理桶，如图3所示。 图3 桶管理第三种方法 父主题： 桶管理

操作步骤 登录OBS Browser。 单击待配置的桶，进入桶界面。 选择待操作的对象，在对象列表上方，单击“配置对象策略”。 若您是第一次配置，在系统弹出的“配置对象策略”对话框中，输入“帐号ID”，并单击“确定”。若您不是第一次配置，则不会有该信息弹出，系统直接弹出“配置对象策略”窗口信息。 “帐号ID”可通过管理控制台的“我的凭证”页面查看。 单击“创建对象策略”。 在“创建对象策略”对话框中，设置权限，选择被授权的IAM用户。 图1 创建对象策略 单击“确定”。 在“配置对象策略”对话框中，单击“保存”。 在弹出的消息窗口中，单击“确定”关闭消息窗口。

背景知识 OBS采用分块上传的模式上传数据，在下列情况下（但不仅限于此）通常会导致数据上传失败而产生碎片。 网络条件较差，与OBS的服务器之间的连接经常断开。 上传过程中，人为中断上传任务。 设备故障。 突然断电等特殊情况。 文件上传失败或上传任务暂停后，都会有碎片存储在OBS中，可以通过任务管理重新启动上传，实现断点续传。上传成功后，碎片将自动消失。 您也可以通过碎片管理功能清理碎片。清理碎片后，重新启动上传任务，上传进度会丢失，任务重新请求上传。 OBS中存储的碎片需要收费。

操作步骤 登录OBS Browser。 单击待恢复文件所在的桶，进入对象列表页面。 单击待恢复对象后的“恢复”图标或者选中待恢复的对象，并单击对象列表上方的“恢复”。 也可以选中多个文件或文件夹，单击列表上方的“恢复”恢复多个文件。 恢复中的对象不能加入批量恢复文件中。 表1 恢复对象 参数 说明 有效期 对象恢复后，保持为“已恢复”状态的时长，从对象恢复完成开始计时。有效期时长可设置1-30天的整数。系统默认有效期为30天。 例如：恢复对象时，有效期设置为20天，则从对象恢复成功后开始算起，20天后，该对象则会从“已恢复”状态变成“未恢复”状态。 速率 对象的恢复速度。 加急：可在1-5分钟内恢复归档存储数据，3-5小时内恢复深度归档存储数据。 标准：可在3-5小时内恢复归档存储数据，5-12小时内恢复深度归档存储数据。 单击“确定”。 文件恢复状态可单击对象右侧的图标，在“对象属性”页面查看，如图1所示。 图1 恢复状态 文件恢复成功后才能对该文件进行下载操作。可单击页面右上角的“刷新”按钮手动刷新恢复任务查看恢复进度，系统也会每5分钟自动刷新恢复任务。 系统每天会在UTC 00:00点检查一次文件恢复情况，过期时间是根据最近一次系统检查时间开始计算的。

操作步骤 系统默认勾选“自动检测软件新版本”，每次登录OBS Browser时，都会自动检查软件当前版本是否为最新版本。用户仅需根据界面提示更新软件即可。 若用户登录OBS Browser后，单击页面右上角的，选择“系统配置”并单击“其他”，取消勾选“自动检测软件新版本”，则可根据如下步骤手动更新OBS Browser。 登录OBS Browser。 在右上方区域单击，选择“检查更新”。 根据界面提示进行版本更新。 更新后的OBS Browser，单击右上角的，选择“检查更新”，出现“已经是最新版本”的提示，说明更新成功。

前提条件 本帐号已获取了挂载桶的相应的读写权限。 例如：帐号A要挂载帐号B的“testbucket”桶，帐号B需授权给帐号A“testbucket”桶的读取权限。帐号A还需要上传对象到挂载桶中时，帐号B还需授权给帐号A“testbucket”桶的写入权限，上传到挂载桶中的对象的拥有者是帐号A，同时授权帐号B该对象的读写权限。 桶版本号为3.0及以上的桶才支持通过标准桶策略授权桶的公共读写权限后挂载外部桶。 若是在创建桶时授权公共读写权限的，需在桶创建完成后，手动更改标准桶策略为私有，然后再更改为公共读写权限，挂载外部桶才能成功。

操作步骤 登录OBS Browser。 在页面右上角单击。 在右上角的选择框中选择任务类型，可以查询正在运行的任务。 可选：选择正在运行的任务，单击，暂停任务。已暂停的任务，可单击，继续运行任务。 可选：选择正在运行的任务，单击，删除任务。 可选：若任务失败，选中失败的任务，将鼠标移动到图标上可查看失败原因，单击可重新运行任务。 可选：您可以选中多个任务，单击列表上方的“运行”、“暂停”和“取消”管理任务。 “取消”任务会删除正在运行任务。 “取消”任务对正在恢复的任务不生效，恢复失败的任务会删除。 可选：单击页面上方“已完成”，可查看已完成的任务。单击已完成任务后的按钮删除改任务记录。

配置区域信息 OBS Browser支持“区域”信息可配置，具体配置方法如下： 进入OBS Browser解压路径下的“OBS Browser”文件夹，打开“region”文件。 修改“region”文件中的“options”参数值。 将需要新增的区域信息根据如下格式填写到“options”参数后。 {"key":"区域别名","value":"区域"} 新增信息需遵守JSON格式。其字段含义如下： “key”表示区域别名，用户自定义。其值会展示在“创建桶”窗口中的区域框的下拉列表中。为了方便在界面查阅，建议输入值不超过25个字符。 “value”表示“区域”，根据OBS支持的“区域”填写。 每新增一个“区域”，“options”的值便增加一组{"key":"区域别名","value":"区域"}值，每组区域信息之间用英文逗号隔开即可。如下示例为新增“region01”和“region02”两个“区域”的配置。“region”文件中其余参数值保持不变。 "options":[{"key":"test_region01","value":"region01"},{"key":"test_region02","value":"region02"}] “region”文件修改成功后，重启OBS Browser，使配置生效。

相关操作 您可以在创建桶时指定桶的存储类别，也可以在创建后修改桶的存储类别。修改步骤如下： 登录OBS客户端。 在桶列表中选择待操作的桶，并单击右侧的，系统弹出“修改存储类别”对话框。 选择目标存储类别，并单击“确定”。 修改桶的存储类别后，不会影响已存储在桶内的对象的存储类别。 上传对象时，默认的对象存储类别与桶的存储类别一致。当桶存储类别修改后，新上传对象时的默认对象存储类别随之修改。 在弹出的消息窗口中，单击“确定”关闭消息窗口。

生命周期管理简介 生命周期管理是指通过配置指定的规则，实现定时删除桶中的对象或者定时转换对象的存储类别。 图1 生命周期管理示意图 生命周期管理可适用于以下典型场景： 周期性上传的日志文件，可能只需要保留一个星期或一个月。到期后要删除它们。 某些文档在一段时间内经常访问，但是超过一定时间后便可能不再访问了。这些文档需要在一定时间后转化为低频访问存储，归档存储或者删除。 对于上述场景中的对象，您可以定义用于识别这些对象的生命周期管理规则，通过这些规则实现对象的生命周期管理。 自动将某些不再频繁访问的对象转换为低频访问存储或者归档存储，可以减少您的租赁费用。此处的“转换”表示在不复制原对象的情况下修改对象的存储类别。您可以在对象页面手动修改对象的存储类别，详情请参见上传文件或文件夹的相关操作，也可以通过配置生命周期规则转换对象的存储类别。 生命周期管理规则通常包含两个关键要素： 策略：即您可以指定对象名前缀来匹配受约束的对象，则匹配该前缀的对象将受规则影响；也可以指定将生命周期管理规则配置到整个桶，则桶内所有对象都将受规则影响。 时间：即您可以指定在对象最后一次更新后多少天，受规则影响的对象将转换为低频访问存储、归档存储或者过期并自动被OBS删除。 转换为低频访问存储：即您可以指定在对象最后一次更新后多少天，受规则影响的对象将转换为低频访问存储。 转换为归档存储：即您可以指定在对象最后一次更新后多少天，受规则影响的对象将转换为归档存储。 过期删除：即您可以指定在对象最后一次更新后多少天，受规则影响的对象将过期并自动被OBS删除。 转换为低频访问存储的时间最少设置为30天，若同时设置转换为低频访问存储和转换为归档存储，则转换为归档存储的时间要比转换为低频访问存储的时间至少长30天，例如转换为低频访问存储设置为33天，则转换为归档存储至少需要设置为63天。若单独设置转换为归档存储，则没有时间限制。过期时间必须大于前两个转换时间的最大值。 父主题： 生命周期管理

服务端加密简介 当启用服务端加密功能后，用户上传对象时，数据会在服务端加密成密文后存储。用户下载加密对象时，存储的密文会先在服务端解密为明文，再提供给用户。 KMS通过使用硬件安全模块 (HSM) 保护密钥安全的托管，帮助用户轻松创建和控制加密密钥。用户密钥不会明文出现在HSM之外，避免密钥泄露。对密钥的所有操作都会进行访问控制及日志跟踪，提供所有密钥的使用记录，满足监督和合规性要求。 OBS Broswer目前支持KMS托管密钥的服务端加密(SSE-KMS)方式，SSE-KMS方式是指OBS使用KMS提供的密钥进行服务端加密。 OBS Broswer目前支持通过接口提供KMS托管密钥的服务端加密(SSE-KMS)。 父主题： 服务端加密

操作步骤 登录OBS Browser。 在页面左上方单击“添加桶”，系统弹出“添加桶”对话框。 设置桶的相关参数，参数描述如表1所示。 图1 添加桶 表1 创建桶 参数 说明 方式 选择“创建新桶”。 区域 选择新建桶所在的区域。 存储类别 桶的存储类别有三种，分别为：标准存储、低频访问存储、归档存储。 标准存储：适用于有大量热点文件或小文件，且需要频繁访问（平均一个月多次）并快速获取数据的业务场景。 低频访问存储：适用于不频繁访问（平均一年少于12次），但需要快速获取数据的业务场景。 归档存储：适用于很少访问（平均一年一次），且对数据获取速率要求不高的业务场景。 桶策略 您可以为桶配置私有、公共读、或公共读写策略。 多AZ 开启多AZ后，数据冗余存储至多个AZ中。归档存储的桶不支持多AZ功能。 桶名称 OBS中桶按照DNS规范进行命名，DNS规范为全球通用规则，其具体命名规则如下： 需全局唯一，不能与已有的任何桶名称重复。 长度范围为3到63个字符，支持小写字母、数字、中划线（-）、英文句号（.）。 禁止两个英文句号（.）或英文句号（.）和中划线（-）相邻，禁止以英文句号（.）和中划线（-）开头或结尾。 禁止使用IP地址。 如果名称中包含英文句号（.），使用 虚拟主机 方式HTTPS访问OBS，会导致证书校验失败。 由于通过URL访问桶时，桶名会作为URL的一部分，根据DNS标准，URL不支持大写字母，无法区分带大写字母的桶。因此，“桶名称”仅支持小写字母、数字、“-”、“.”作为桶的命名规则。例如：若想通过URL访问名为“MyBucket”的桶，该URL将解析成名为“mybucket”的桶，导致访问出错。 DNS命名规范方便全局统一，方便在访问桶时对桶进行解析，可以使客户受益于新功能和优化性能，并支持对桶进行静态网站托管。 桶创建成功后，不能修改名称，创建时，请设置合适的桶名。 单击“确定”。 在弹出的消息窗口中，单击“确定”关闭消息窗口。

操作步骤 登录OBS Browser。 单击待操作的桶，进入桶界面。 选中待配置的对象，单击需要共享的对象右侧的“对象属性”图标，如图1所示。在URL行查看该对象链接地址。 登录OBS Browser时，选择“OBS存储”，则生成的对象链接地址格式为：https://桶名.域名/文件夹目录层级/对象名。如果该对象存在于桶的根目录下，其链接地址不会有文件夹目录层级。 图1 对象属性 登录OBS Browser时，选择“其他对象存储”，则生成的对象链接地址格式为：https://存储服务器IP地址或域名/桶名/文件夹目录层级/对象名。如果该对象存在于桶的根目录下，其链接地址不会有文件夹目录层级。 登录OBS Browser时，选择“OBS存储”，则生成的对象链接地址格式为：https://桶名.域名/文件夹目录层级/对象名。如果该对象存在于桶的根目录下，其链接地址不会有文件夹目录层级。 对于存储类别为归档存储的桶中的对象，如果要让匿名用户通过URL访问，则需要先确认对象的状态是否为“已恢复”。 对象类型不同，通过浏览器访问该对象的方式不同。例如：.txt、.html等文件可直接通过浏览器打开浏览，而.exe、.dat等文件则会在浏览器打开时，自动下载到本地。 单击，复制该对象链接地址。 在弹出的消息窗口中，单击“确定”关闭消息窗口。 将对象链接地址复制到浏览器中打开，即可访问该对象。

存储类型对比 对比项目 标准存储 低频访问存储 归档存储 深度归档存储（受限公测） 特点 高性能、高可靠、高可用的对象存储服务 高可靠、较低成本的实时访问存储服务 归档数据的长期存储，存储单价更优惠 深度归档数据的长期存储，存储单价相比归档存储更优惠 应用场景 云应用、数据分享、内容分享、热点对象 网盘应用、企业备份、活跃归档、监控数据 档案数据、医疗影像、视频素材、带库替代 长期不访问的数据存档场景 设计持久性 99.999999999% 99.999999999% 99.999999999% 99.999999999% 设计持久性（多AZ） 99.9999999999% 99.9999999999% - - 设计可用性 99.99% 99% 99% 99% 设计可用性（多AZ） 99.995% 99.5% - - 最低存储时间 无 30天 90天 360天 数据恢复 不涉及 按实际恢复数据量收费，单位GB 分加急和标准两种恢复方式， 按实际恢复数据量收费，单位GB 分加急和标准两种恢复方式 按实际恢复数据量收费，单位GB 图片处理 支持 支持 不支持 不支持

操作步骤 登录OBS Browser。 在OBS Browser右上角，单击，并选择“系统配置”，系统弹出“系统配置”对话框，如图1所示。 图1 系统配置 单击“基本配置”，根据需要修改基本配置参数。 各参数含义如表1所示。 表1 基本配置参数 参数 说明 启用HTTPS安全传输协议 勾选后所有通信信息都将被加密，通过HTTPS协议传输到OBS中。 启用证书检验 勾选后，客户端会校验服务端的证书。 启用KMS加密 勾选“启用HTTPS安全传输协议”和“启用KMS加密”后，上传到OBS中的所有对象都会进行KMS加密。 启用MD5校验 勾选后，客户端上传、下载文件会进行MD5校验。 多段上传，段大小(MB) 系统默认使用多段上传功能，大于设置的段大小（默认为5MB）的对象在OBS后台将分为多个数据段进行上传，每个数据段的大小通过此界面进行配置。“段大小(MB)”的设置区间在5MB到5GB之间。 说明： 系统默认使用多段上传功能，“段大小(MB)”推荐设置指导如下： 为最大限度提升客户端性能，设置分段上传的“段大小(MB)”时可根据实际的上传速度而定，推荐“段大小(MB)”值高于最大上传速度值。例如：当前网络的最大上传速度为10MBps，则“段大小(MB)”值需为大于10MB的一个整数值，一般设置为最大上传速度值的两到三倍。 多段下载，段大小(MB) 系统默认使用多段下载功能，大于设置的段大小（默认为5MB）的对象在OBS后台将分为多个数据段进行上传，每个数据段的大小通过此界面进行配置。“段大小(MB)”的设置区间在5MB到5GB之间。 最大任务数 设置最大上传和下载任务个数，请输入2到20的整数。 语言 根据需求设置语言类型。语言切换后，重启软件生效。 单击“网络配置”，根据需求设置代理服务器信息，如图2所示。 图2 网络配置 表2 网络配置参数说明 参数 说明 启用代理 勾选后，会展示“使用身份验证”的可选项。设置以下参数就可以通过代理服务器访问OBS。 地址：代理服务器地址。 端口：代理服务器端口（默认为“8080”）。 单击“其他”，根据需要设置其他配置参数，如图3所示。 图3 其他配置 表3 其他参数 参数 说明 自动检测软件新版本 勾选后，每次登录OBS Browser时，都会自动检查软件当前版本是否为最新版本。 每页显示的对象个数 设置每页显示的对象个数。系统默认设置为100个。设置范围为50到300个。设置成功后可单击页面右上角的按钮使配置生效。 数据库路径 OBS Browser数据保存的路径。可以通过单击后面的，修改路径。 注意： 数据库路径不能包含中文字符。 单击“保存”，保存系统配置。

错误码列表 如果请求因错误导致未被处理，则会返回一条错误响应。错误响应中包括错误码和具体错误描述。表1列出了错误响应中的常见错误码。 表1 错误码列表 错误码 描述 Obs.0000 网关或代理服务器验证失败，请输入正确的验证信息。 Obs.0001 服务端内部出错，请联系客服处理。 Obs.0002 网关或代理服务器出现错误，请联系客服处理。 Obs.0003 服务器繁忙，请稍后重试。 Obs.0004 请求的桶名已经存在。桶的命名空间是系统中所有用户公用的，选择一个不同的桶名再重试一次。 Obs.0005 删除失败，请检查桶中是否存在对象或者登录OBS Console检查是否存在历史版本的对象。 Obs.0006 访问本地文件时出错，请重试。 Obs.0007 目标文件被系统占用，无法上传该文件，请检查文件是否可以访问。 Obs.0008 读取文件失败，请重试。 Obs.0009 本地磁盘空间不足，请删除不需要的文件保证磁盘空间充足。 Obs.0010 没有本地文件读写权限，请增加相应文件权限。 Obs.0011 欠费或者余额不足，请充值后重试。 Obs.0012 AK或者SK错误。 Obs.0013 分段上传该文件失败，请取消该任务后重试。 Obs.0014 所有对这个对象的访问已经无效了。 Obs.0015 目标桶不存在或者不属于您，或者如果是因为您没有权限，则需要目标桶开放日志投递用户的“写入权限”和“查看ACL”权限才能执行此操作，请在权限设置中设置。 Obs.0016 与其他用户正在执行的操作冲突，请稍后重试。 Obs.0017 您所访问的桶不属于当前区域，请重新选择。 Obs.0018 区域信息错误，请确认正确的区域信息。 Obs.0019 客户端与服务器的时间相差大于15分钟。 Obs.0020 服务器负载过高，请稍后重试。 Obs.0021 部分对象删除失败，请稍后重试。 Obs.0022 部分对象下载失败，请稍后重试。 Obs.0023 用户拥有的桶的数量已经达到了系统的上限。 Obs.0024 处理失败，请重试。 Obs.0025 无效的IP地址或域名地址，请重新输入。 Obs.0026 文件的绝对路径总长度不能超过1023字符，请重试。 Obs.0027 连接代理服务器失败，请检查网络或者代理服务器身份认证信息。 Obs.0028 目标桶不存在或目标桶与当前桶不属于同一区域，请确认后重新操作。 Obs.0029 签名信息错误，请联系客服处理。 Obs.0030 无法创建或查找到对应路径，请检查路径是否过长或者路径不存在。 Obs.0031 你的帐号还没有在系统中注册，必须先在系统中注册了才能使用该帐号。 Obs.0032 桶策略规则无效，请重新配置。 Obs.0033 请求的桶名已经存在。桶的命名空间是系统中所有用户共用的，选择一个不同的桶名再重试一次。 Obs.0034 新的有效期对应的过期时间必须晚于当前该对象的过期时间。 Obs.0035 无法判断桶中是否有对象或碎片，请检查您是否有桶的读权限。

添加帐号 登录OBS Browser。 在OBS Browser右上角，单击帐号名，并选择“帐号管理”。 在弹出的“帐号管理”对话框中，单击“添加新帐号”。 在“添加新帐号”对话框中根据实际需要填写帐号信息。 需填写的帐号信息包括如下几项： 帐号名：您在OBS Browser上使用的帐号名，仅用于在OBS Browser上区别不同的帐号，无需与云服务上注册的帐号一致。帐号名长度不超过50个字符。 存储服务：OBS Browser支持连接到“OBS存储”或“其他对象存储”上。 当连接对象存储服务时，选择“OBS存储”，如图1所示。 图1 添加新帐号-OBS存储 当连接其他对象存储服务时，选择“其他对象存储”，如图2所示。 您还需同时指定该存储的“服务器地址”，支持填写IP地址或域名，格式为：服务器IP地址或域名:服务器端口号（HTTPS协议端口号为“443”，HTTP协议端口号为“80”）。系统默认服务器为HTTPS服务器，如需使用HTTP服务器，请单击页面右上角的图标并单击“系统配置”，在弹出的“系统配置”窗口，取消对“启用HTTPS安全传输协议”的勾选。 图2 添加新帐号-“其他对象存储” Access Key ID/Secret Access Key：您在注册云服务帐号后，在“我的凭证”创建的AK/SK。获取AK/SK方法详情请参见创建访问密钥（AK和SK）。 访问路径 您可以输入桶名称或对象路径，登录成功后，将访问特定的桶或对象。 桶访问路径格式：桶名 对象访问路径格式：桶名/对象名 其中对象名可以是文件夹或者文件 系统默认会勾选“记住我的访问密钥”，若用户不勾选，则在每次登录OBS Browser时，需要重新填写“Secret Access Key”值。 单击“确定”。 帐号信息保存成功后，添加的新帐号会在页面右上角帐号名下拉列表中显示。单击选中的帐号即可切换当前登录帐号。

操作步骤 双击“obs.exe”程序，打开OBS Browser。 如果是首次启用OBS Browser，打开OBS Browser时将自动弹出“添加新帐号”界面，请执行步骤4。 在OBS Browser右上角，单击帐号名，并选择“帐号管理”。 在弹出的“帐号管理”对话框中，单击“添加新帐号”。 在“添加新帐号”对话框中填写帐号信息，单击“确定”。详细的帐号管理，请参见帐号管理。 连接存储服务成功后，添加的帐号信息会在“帐号管理”对话框中显示。 单击“确定” 在OBS Browser右上角，单击选择帐号即可登录。