工具指南

Transcription

1 对象存储服务 工具指南 文档版本 01 发布日期 华为技术有限公司

2 版权所有 华为技术有限公司 2018 保留一切权利 非经本公司书面许可, 任何单位和个人不得擅自摘抄 复制本文档内容的部分或全部, 并不得以任何形式传播 商标声明 和其他华为商标均为华为技术有限公司的商标 本文档提及的其他所有商标或注册商标, 由各自的所有人拥有 注意 您购买的产品 服务或特性等应受华为公司商业合同和条款的约束, 本文档中描述的全部或部分产品 服务或特性可能不在您的购买或使用范围之内 除非合同另有约定, 华为公司对本文档内容不做任何明示或默示的声明或保证 由于产品版本升级或其他原因, 本文档内容会不定期进行更新 除非另有约定, 本文档仅作为使用指导, 本文档中的所有陈述 信息和建议不构成任何明示或暗示的担保 文档版本 01 ( ) 版权所有 华为技术有限公司 i

3 目录 目录 1 OBS 工具汇总 OBS Browser 介绍 产品概述 功能概述 入门 流程简介 登录 OBS 管理控制台 设置用户权限 下载 OBS Browser 创建访问密钥 (AK 和 SK) 登录客户端 添加桶 上传文件或文件夹 下载文件或文件夹 删除文件或文件夹 删除桶 存储类别 存储类别简介 不同存储类别的应用场景 桶管理 桶管理方法介绍 添加桶 搜索桶 查看桶的基本信息 碎片管理 删除桶 对象管理 对象管理方法介绍 新建文件夹 通过对象 URL 访问对象 搜索文件或文件夹 上传文件或文件夹 文档版本 01 ( ) 版权所有 华为技术有限公司 ii

4 目录 下载文件或文件夹 重命名文件 复制文件或文件夹 移动文件或文件夹 删除文件或文件夹 恢复归档存储文件 MD5 检验 桶 ACL 权限 桶 ACL 权限简介 配置桶 ACL 权限 生命周期管理 生命周期管理简介 配置生命周期管理策略 桶策略 桶策略简介 配置桶策略 跨域资源共享 跨域资源共享简介 配置跨域资源共享 日志记录 访问日志记录简介 配置日志记录 挂载外部桶 挂载外部桶简介 配置挂载外部桶 对象 ACL 权限 对象 ACL 简介 配置对象 ACL 对象策略 对象策略简介 配置对象策略 服务端加密 服务端加密简介 使用服务端加密方式上传文件 任务管理 管理上传任务 管理下载任务 管理重命名任务 管理复制任务 管理移动任务 管理删除任务 管理恢复任务 文档版本 01 ( ) 版权所有 华为技术有限公司 iii

5 目录 2.16 应用举例 存储视频数据 备份或归档数据 相关操作 系统配置 账号管理 更新客户端版本 问题处理 无法全局搜索桶中对象 无法在浏览器中打开对象 URL 通过客户端同时选中大量文件上传时, 上传任务没有创建, 界面无任何提示 使用客户端上传文件时, 出现蓝屏或黑屏现象 使用客户端管理对象时, 在任务列表中无相关任务显示 出现 客户端与服务器的时间相差大于 15 分钟 的报错 错误码列表 修订记录 obscmd obscmd 简介 下载并安装 obscmd 注册账号并开通 OBS 创建 IAM 用户 创建访问密钥 (AK 和 SK) 对接 OBS 公共参数配置项 上传本地文件 编辑配置文件方式 命令行方式 下载桶内对象 编辑配置文件方式 命令行方式 Python 工具安装参考 检查 Python 版本 安装或升级 Python 检查 gcc 是否已安装 安装或升级 openssl 安装 python 问题处理 在分布式存储系统上运行 obscmd 工具报错 修订记录 OBSFTP OBSFTP 工具介绍 概述 工具下载 文档版本 01 ( ) 版权所有 华为技术有限公司 iv

6 目录 特性说明 功能说明 约束与限制 OBSFTP 工具安装和使用 Windows 系统 Linux/Unix 系统 高级参数设置使用 修订记录 A 修订记录 文档版本 01 ( ) 版权所有 华为技术有限公司 v

7 1 OBS 工具汇总 1 OBS 工具汇总 对象存储服务 (OBS,Object Storage Service) 提供如表 1-1 所示工具, 供用户使用 表 1-1 OBS 工具一览表 工具 OBS Browser 适用的操作系统 Windows Mac 说明 OBS Browser 提供类似于 Windows 资源管理器的功能, 以及桶和对象的基本属性管理功能, 可以非常方便地让用户在本地进行对象存储管理, 例如 : 浏览文件 上传下载文件 配置生命周期规则等 obscmd Linux obscmd 是适用于 Linux 操作系统的 OBS 客户端工具, 支持通过命令行上传和下载对象 主要特点是可以并发处理上传下载任务, 实现快速传输数据能力 OBSFTP Windows Linux Mac OBSFTP 工具利用 pyftpdlib 库的 FTP server 能力和对象存储云端存储能力, 提供出具有 FTP 接入的云上存储使用能力 在企业实际业务中, 无需单独搭建 FTP 服务器和存储池, 实现业务和运维的轻量化, 极大降低了原有的 FTP 访问方式的技术成本 文档版本 01 ( ) 版权所有 华为技术有限公司 1

8 2.1 OBS Browser 介绍 产品概述 OBS Browser 是一款运行在 Windows 和 Mac 系统上的对象存储服务客户端, 方便您在个人电脑上完成对象存储管理 OBS Browser 对 PC 机的规格要求如表 2-1 所示 : 表 2-1 OBS Browser 对 PC 机的规格要求 规格项规格要求备注 操作系统 CPU 内存 安装盘可用空间 Windows 7 Pro SP1 32-bit Windows 7 Pro SP1 64-bit Windows 8 Pro 32-bit Windows 10 Pro 64-bit Windows Server 2008 R2 standard SP1 64-bit Windows Server 2012 standard SP1 64-bit Mac OS X 及以上版本 最低配置 : 双核 1.6GHz CPU 标准配置 : 双核 2.4GHz CPU 最低配置 :4GB 内存 标准配置 :8GB 内存 可用内存 : 512MB 512MB 安装 OBS Browser 所需的硬盘空间 文档版本 01 ( ) 版权所有 华为技术有限公司 2

9 规格项规格要求备注 数据盘可用空间 3GB 存放 OBS Browser 数据库的数据文件所需的硬盘空间 ( 当前版本是存放在系统盘 ) 该 OBS Browser 提供扁平化风格的 GUI 界面, 符合 Windows 系统用户的操作习惯 要想拥有更好的体验, 建议使用 1280*1024 或更高分辨率的显示设备 功能概述 您可以通过单击页面右上角的图标, 单击 关于 查看客户端的当前版本信息, 也可以单击 在线帮助 查看帮助文档 目前,OBS Browser 提供的功能如表 2-2 所示 : 表 2-2 功能概述 功能桶基本操作对象基本操作碎片管理桶权限跨域资源共享日志记录生命周期管理上传大对象批量上传分段上传批量下载 说明 指定 region( 不同服务区域 ) 创建不同存储类别的桶 删除桶 修改桶的存储类别等 管理对象, 包括上传 ( 含多段上传功能 ) 下载 重命名 移动 复制 删除 通过对象 URL 共享数据 修改对象的存储类别 恢复归档存储对象等 碎片管理功能可以清除由于对象上传失败而产生的数据 管理桶权限, 包括桶策略和访问控制列表 (Access Control List,ACL) 跨域资源共享 (CORS) 是由 W3C 标准化组织提出的一种网络浏览器的规范机制, 定义了一个域中加载的客户端 Web 应用程序与另一个域中的资源交互的方式 而在通常的网页请求中, 由于同源安全策略 (Same Origin Policy,SOP) 的存在, 不同域之间的网站脚本和内容是无法进行交互的 支持对桶的访问请求创建并保存访问日志记录, 可用于进行请求分析或日志审计 支持设置桶的生命周期管理策略, 实现自动删除超期的对象 上传超过 50MB 小于 48.8TB 的单个文件或文件夹 批量上传对象 分段上传对象 批量下载对象 文档版本 01 ( ) 版权所有 华为技术有限公司 3

10 功能对象 ACL 对象策略挂载外部桶服务端加密任务管理 说明 为对象设置 ACL 访问权限 通过配置对象策略, 可以控制本账号下其他 IAM 用户对被授权对象的访问权限 方便用户管理其他 OBS 用户共享的数据 用户可根据需要对对象进行服务端加密, 使对象更安全的存储在 OBS 中 方便用户管理上传 下载 重命名 移动 复制 删除 恢复任务 2.2 入门 流程简介 以下章节介绍如何使用 OBS Browser 来完成图 2-1 中所示的任务 文档版本 01 ( ) 版权所有 华为技术有限公司 4

11 图 2-1 OBS Browser 快速入门 登录 OBS 管理控制台 您可以通过网页登录 OBS 管理控制台 操作步骤 步骤 1 登录华为云网站 文档版本 01 ( ) 版权所有 华为技术有限公司 5

12 步骤 2 注册账号 使用 OBS 前需注册一个华为云账号 若您已有账号, 请从步骤 3 开始 1. 在顶部导航栏右侧, 单击 注册 2. 在注册页面, 根据提示信息完成注册 注册成功后, 系统会自动跳转至您的个人信息界面 步骤 3 步骤 4 步骤 5 步骤 6 在顶部导航栏右侧, 单击 登录, 输账号名和密码 在顶部导航栏右侧, 单击 控制台, 进入华为云控制台 在顶部导航栏, 选择 服务列表 > 存储 > 对象存储服务 OBS, 进入 OBS 管理控制台 为保证您正常使用 OBS 服务, 建议您先充值购买 OBS 服务 购买方式, 请参见购买指南 设置用户权限 通过 IAM 可以创建用户, 并设置用户的权限 系统提供用户管理权限和云资源权限 用户管理权限实现用户的创建 删除 修改和为用户授予相应的权限 云资源权限包括云资源的创建 删除 修改 设置等操作的权限 为用户组添加云资源权限, 再将用户加入用户组, 用户继承用户组的权限 更多详情参见权限说明 与其他云资源是分开部署的,OBS 的资源权限如表 2-3 所示 表 2-3 OBS 资源权限 权限名称 Tenant Administrator Tenant Guest OBS Buckets Viewer 描述 拥有该权限的用户可以对 OBS 资源执行任意操作 拥有该权限的用户可以查询 OBS 资源的利用情况 具备该权限的用户, 可以执行获取桶列表 查询桶元数据和位置信息的操作 操作步骤 步骤 1 步骤 2 步骤 3 登录 OBS 管理控制台 在顶部导航栏选择 服务列表 > 管理和部署 > 统一身份认证服务 IAM, 进入 统一身份认证服务 管理控制台 创建用户组, 配置步骤请参见 IAM 服务的创建用户组 在 用户组权限 中选择 全局服务 > 对象存储服务, 设置 OBS 权限 文档版本 01 ( ) 版权所有 华为技术有限公司 6

13 步骤 4 创建用户, 配置步骤请参见 IAM 服务的创建用户 下载 OBS Browser 操作步骤 步骤 1 下载 OBS Browser 软件包 OBS Browser 软件包集成在 OBS 管理控制台中, 登录 OBS 管理控制台, 在 OBS 管理控制台主界面单击 OBS Browser 的下载链接 鼠标移动到 OBS Browser 的下载链接上时, 可查看 OBS Browser 的版本号, 发布日期, 软件包大小信息 目前 OBS Browser 支持在 Windows 和 Mac 系统运行 Windows 系统版本, 您也可以单击这里获取 Mac 系统版本, 你可以单击这里获取 步骤 2 将下载好的软件包解压到一个绝对路径长度不超过 130 字符的目录中 相关操作 以下介绍通过内网下载 OBS Browser 软件包方法 当 ECS 无弹性 IP 时, 可通过内网下载 OBS Browser 工具, 下载地址如表 2-4 所示 表 2-4 OBS Browser 工具下载地址 区域 存放工具的桶名 下载链接 华北 obstool-north OBSBrowser.zip 华东 obstool-east OBSBrowser.zip 华南 obstool-south OBSBrowser.zip 创建访问密钥 (AK 和 SK) 背景信息 本节介绍如何通过 OBS 管理控制台创建访问密钥 (AK 和 SK), 访问密钥 (AK 和 SK) 用于对请求加密签名, 确保请求的机密性 完整性和请求双方身份的正确性 AK 和 SK 支持 IAM 的认证机制, 以下是对 AK 和 SK 的解释说明 : 文档版本 01 ( ) 版权所有 华为技术有限公司 7

14 AK:Access Key ID, 接入键标识, 用户在 OBS 系统中的接入键标识, 一个接入键标识唯一对应一个用户, 一个用户可以同时拥有多个接入键标识 OBS 系统通过接入键标识识别访问系统的用户 SK:Secret Access Key, 安全接入键, 用户在 OBS 系统中的安全接入键, 是用户访问 OBS 系统的密钥, 用户根据安全接入键和请求头域生成鉴权信息 安全接入键和接入键标识一一对应 约束和限制 每个用户最多可以创建两个有效的访问密钥 前提条件 已注册并开通云服务账号 操作步骤 步骤 1 步骤 2 登录 OBS 管理控制台 单击页面右上角的用户名, 并选择 我的凭证, 如图 2-2 所示 图 2-2 选择我的凭证 步骤 3 进入 我的凭证 页面, 单击 管理访问密钥 页签下方的 新增访问密钥, 如图 2-3 所示 图 2-3 新增访问密钥 说明 每个用户最多可创建两个有效的访问密钥 文档版本 01 ( ) 版权所有 华为技术有限公司 8

15 步骤 4 在弹出的 新增访问密钥 对话框中, 输入登录密码和对应验证码 说明 用户如果未绑定邮箱和手机, 则只需输入登录密码 用户如果同时绑定了邮箱和手机, 可以选择其中一种方式进行验证 步骤 5 单击 确定 步骤 6 根据浏览器提示, 保存密钥 密钥会直接保存到浏览器默认的下载文件夹中 说明 为防止访问密钥泄露, 建议您将其保存到安全的位置 如果用户在此提示框中单击 取消, 则不会下载密钥, 后续也将无法重新下载 如果需要使用访问密钥, 可以重新创建新的访问密钥 访问密钥 (AK 和 SK) 需定期更新 步骤 7 打开下载下来的 credentials.csv 文件既可获取到访问密钥 (AK 和 SK) 登录客户端 操作步骤 本节介绍如何登录 OBS Browser 步骤 1 双击 obs.exe 程序, 打开 OBS Browser 如果是首次启用 OBS Browser, 打开 OBS Browser 时将自动弹出 添加新账号 界面, 请执行步骤 4 步骤 2 在 OBS Browser 右上角, 单击账号名, 并选择 账号管理 步骤 3 在弹出的 账号管理 对话框中, 单击 添加新账号 步骤 4 在 添加新账号 对话框中填写账号信息, 单击 确定 详细的账号管理, 请参见 账号管理 连接存储服务成功后, 添加的账号信息会在 账号管理 对话框中显示 步骤 5 单击 确定 步骤 6 在 OBS Browser 右上角, 单击选择账号即可登录 后续处理 添加桶 OBS Browser 的 系统配置, 请参见 系统配置 如果希望通过 OBS Browser 管理多个账号拥有的对象, 可单击账号名, 并选择 账号管理 添加多个账号信息 单击想要登录的账号即可切换当前登录的账号 详细的账号管理, 请参见 账号管理 OBS Browser 的版本更新, 请参见 更新客户端版本 桶是 OBS 中存储对象的容器 您需要先创建一个桶, 然后才能在 OBS 中存储数据 文档版本 01 ( ) 版权所有 华为技术有限公司 9

16 说明 一个账号可创建 100 个桶 操作步骤 步骤 1 登录 OBS Browser 步骤 2 在页面左上方单击 添加桶, 系统弹出如图 2-4 所示对话框 图 2-4 添加桶 步骤 3 单击 创建新桶 步骤 4 设置 区域, 详细的 区域 信息, 请参见配置区域信息 步骤 5 选择 存储类别 步骤 6 输入 桶名 可以单击桶名输入框后的 了解桶的命名规则详情 步骤 7 单击 确定 步骤 8 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 上传文件或文件夹 上传文件操作可将本地文件或文件夹存储至 OBS 背景信息 OBS Browser 使用分段上传功能上传文件 通过分段上传功能,OBS Browser 支持上传最大为 48.8TB 的单个文件 文档版本 01 ( ) 版权所有 华为技术有限公司 10

17 OBS Browser 支持断点续传 当上传任务暂停或者失败, 重新启动上传任务, 根据任务记录的分片信息, 已上传成功的分片不会再次上传, 会请求上传其他的分片 若您需要将文件归类处理, 可以先新建文件夹, 然后将相关的文件上传到文件夹中 新建文件夹步骤如下 : a. 登录 OBS Browser b. 单击目标桶名称进入对象管理界面, 单击 新建文件夹 c. 在对话框中输入文件夹的名称后, 单击 确定 d. 单击消息提示框中的 确定 操作步骤 步骤 1 登录 OBS Browser 步骤 2 单击想要上传文件或文件夹的桶 步骤 3 单击 上传, 并选择 上传文件 使用 上传文件 功能上传对象时, 为了更好的体验, 建议您最多同时选择 500 个文件进行上传, 如果超过此限制, 建议将多个文件放在文件夹中, 然后使用 上传文件夹 功能进行上传, 详见相关操作 步骤 4 单击 选择文件, 在弹出的对话框中, 选中需要上传的文件, 单击 打开 客户端支持一次上传一个文件夹, 或一次同时上传多个文件 上传多个文件时, 按住 Ctrl 或 Shift 同时选择多个文件即可, 同时支持 Ctrl+A 全选操作 操作习惯与 Windows 操作系统上的操作习惯保持一致 步骤 5 可选 : 指定对象的存储类别 若不指定, 默认与桶的存储类别一致 步骤 6 单击 确定 下载文件或文件夹 操作步骤 用户可根据需要将存储在 OBS 上的文件或文件夹下载到本地 步骤 1 登录 OBS Browser 步骤 2 单击待操作的桶, 选中需要下载的文件或文件夹后, 单击右键选择 下载 OBS 支持批量下载多个文件和文件夹, 按住 Ctrl 或 Shift 同时选中待下载的文件或文件夹, 然后单击右键, 选择 下载 同时支持 Ctrl+A 全选操作 操作习惯与 Windows 操作系统上的操作习惯保持一致 说明 对于存储类别为归档存储的桶中的文件, 需要确认对象的状态为 已恢复 才能对其进行下载 请参见 恢复归档存储文件查看如何恢复文件 步骤 3 在对话框中选择存放文件或文件夹的路径后, 单击 上传 如果目标路径下存在同名文件, 系统会弹出 目标路径存在同名文件, 请选择保存方式, 您可以选择 均保留 或者 覆盖 文档版本 01 ( ) 版权所有 华为技术有限公司 11

18 任务管理界面将显示文件或文件夹下载进度, 您可以根据需要对下载任务进行暂停 删除或取消 详细操作可参见 管理下载任务 删除文件或文件夹 操作步骤 删除桶 删除文件夹时, 文件夹内的文件也将同时被删除, 请务必确认这些文件可以被删除 步骤 1 登录 OBS Browser 步骤 2 选中待配置的桶, 选中待删除的文件或文件夹后, 单击右侧 更多 > 删除 OBS 客户端支持同时删除多个文件或文件夹, 按住 Ctrl 或 Shift 同时选中待删除的文件或文件夹 ( 同时支持 Ctrl+A 全选操作 ), 单击右键, 选择 删除 操作习惯与 Windows 操作系统上的操作习惯保持一致 步骤 3 在消息确认框中单击 确定 任务管理界面将显示文件或文件夹删除进度, 您可以根据需要对删除任务进行暂停或消 详细操作可参见 管理删除任务 如果您不再需要一个桶, 可以在 OBS 管理控制台上将其删除, 以免占用桶数量配额 前提条件 删除桶之前必须确保桶内的对象已全部删除 只有桶的拥有者才能删除桶 操作步骤 步骤 1 登录 OBS Browser 步骤 2 选中待删除的桶, 单击 更多 > 删除 说明用户删除桶后, 需要等待 30 分钟才能在其他区域创建同名桶 同区域可立即创建 步骤 3 单击确认框中的 确定 步骤 4 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 2.3 存储类别 存储类别简介 OBS 支持桶级和对象级存储类别 文档版本 01 ( ) 版权所有 华为技术有限公司 12

19 存储类别可以分为 : 标准存储 低频访问存储 归档存储, 从而满足客户业务对存储性能 成本的不同诉求 不同的存储类别可以满足客户业务对存储性能 成本的不同诉求 标准存储拥有低访问时延和较高的吞吐量, 因而适用于有大量热点文件 ( 平均一个月多次 ) 或小文件 ( 小于 1MB), 且需要频繁访问数据的业务场景, 例如 : 大数据 移动应用 热点视频 社交图片等场景 低频访问存储适用于不频繁访问 ( 平均一年少于 12 次 ) 但在需要时也要求快速访问数据的业务场景, 例如 : 文件同步 / 共享 企业备份等场景 与标准存储相比, 低频访问存储有相同的数据持久性 吞吐量以及访问时延, 且成本较低, 但是可用性略低于标准存储 归档存储适用于很少访问 ( 平均一年访问一次 ) 数据的业务场景, 例如 : 数据归档 长期备份等场景 归档存储安全 持久且成本极低, 可以用来替代磁带库 为了保持成本低廉, 数据取回时间可能长达数分钟到数小时不等 不同存储类别的应用场景 表 2-5 适用场景 存储类别适用场景场景描述 标准存储 大数据分析 大数据应用 ( 例如基因 财务 气象 广告等 ) 直接通 过 Internet 将文件 图片 视频直接存入 OBS 低频访问存储 原生云应用程序数据 静态网站托管 备份 / 活跃归档 其他服务场景 OBS 提供高性能 高可用性存储服务, 移动和互联网应用程序从而能够使用高扩展和低成本和高效的存储服务 利用 OBS 使用任意量的数据, 并在任何位置访问内容 网站经营者或个人网站发布者, 将 OBS 作为静态网站托管资源池, 在将静态网页上传到 OBS 后, 通过设置网站功能, 托管整个静态网站, 并且通过 CDN 进行数据快速分发 OBS 提供了高持久性 高扩展性以及安全的解决方案来备份和归档用户的关键数据 用户可以使用 OBS 的版本控制功能为存储的数据提供进一步的保护 高持久性 安全的基础设施旨在提供高级数据保护的稳固灾难恢复解决方案, 支持第三方备份和归档软件, 如 : CommVault NBU 等 如镜像服务 IMS 云硬盘备份 VBS RDS 数据库等服务, 使用 OBS 作为各自服务的存储资源池或备份存储等 归档存储 深度 / 冷归档 用户的数据需要长期备份, 如存储几个月, 乃至几年, 并对延时不敏感的数据, 如果用户提取数据时能够容忍 小于 12 小时的时间延迟就可以考虑使用归档产品 2.4 桶管理 文档版本 01 ( ) 版权所有 华为技术有限公司 13

20 2.4.1 桶管理方法介绍 OBS Browser 支持以下三种方式管理桶 1. 通过 OBS Browser 桶列表上方的操作按钮管理桶 单击待操作桶所在行, 选择桶列表上方的操作按钮管理桶, 如图 2-5 所示 图 2-5 桶管理第一种方法 2. 通过桶所在行右侧的操作按钮管理桶 单击待操作桶所在行右侧的操作按钮管理桶, 如图 2-6 所示 图 2-6 桶管理第二种方法 3. 通过右键选项管理桶 右键单击待操作桶所在行, 通过选择弹出框里的操作管理桶, 如图 2-7 所示 文档版本 01 ( ) 版权所有 华为技术有限公司 14

21 图 2-7 桶管理第三种方法 添加桶 桶是 OBS 中存储对象的容器 您需要先创建一个桶, 然后才能在 OBS 中存储数据 说明 一个账号可创建 100 个桶 操作步骤 步骤 1 登录 OBS Browser 步骤 2 在页面左上方单击 添加桶, 系统弹出如图 2-8 所示对话框 文档版本 01 ( ) 版权所有 华为技术有限公司 15

22 图 2-8 添加桶 步骤 3 设置桶的相关参数, 参数描述如表 2-6 所示 表 2-6 创建桶 参数 说明 方式选择 创建新桶 区域 存储类别 选择新建桶所在的区域 桶的存储类别有三种, 分别为 : 标准存储 低频访问存储 归档存储 标准存储 : 拥有低访问时延和较高的吞吐量 低频访问存储 : 适用于不频繁访问 ( 平均一年少于 12 次 ) 但在需要时也要求快速访问数据的业务场景 温存储 : 适用于不频繁访问 ( 平均一年少于 12 次 ) 但在需要时也要求快速访问数据的业务场景 归档存储 : 适用于很少访问 ( 平均一年访问一次 ) 数据的业务场景 文档版本 01 ( ) 版权所有 华为技术有限公司 16

23 参数 说明 桶名称 OBS 中桶按照 DNS 规范进行命名,DNS 规范为全球通用规则, 其具体命名规则如下 : 需全局唯一, 不能与已有的任何桶名称重复 长度范围为 3 到 63 个字符, 支持小写字母 数字 中划线 (-) 英文句号 (.) 禁止两个英文句号 (.) 或英文句号 (.) 和中划线 (-) 相邻, 禁止以英文句号 (.) 和中划线 (-) 开头或结尾 禁止使用 IP 地址 如果名称中包含英文句号 (.), 访问桶或对象时可能会进行安全证书校验 说明 由于通过 URL 访问桶时, 桶名会作为 URL 的一部分, 根据 DNS 标准,URL 不支持大写字母, 无法区分带大写字母的桶 因此, 桶名称 仅支持小写字母 数字 -. 作为桶的命名规则 例如 : 若想通过 URL 访问名为 MyBucket 的桶, 该 URL 将解析成名为 mybucket 的桶, 导致访问出错 DNS 命名规范方便全局统一, 方便在访问桶时对桶进行解析, 可以使客户受益于新功能和优化性能, 并支持对桶进行静态网站托管 桶创建成功后, 不能修改名称, 创建时, 请设置合适的桶名 步骤 4 单击 确定 步骤 5 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 配置区域信息 OBS Browser 支持 区域 信息可配置, 具体配置方法如下 : 1. 进入 OBS Browser 解压路径下的 OBS Browser 文件夹, 打开 region 文件 2. 修改 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"}] 3. region 文件修改成功后, 重启 OBS Browser, 使配置生效 文档版本 01 ( ) 版权所有 华为技术有限公司 17

24 相关操作 您可以在创建桶时指定桶的存储类别, 也可以在创建后修改桶的存储类别 修改步骤如下 : 步骤 1 登录 OBS 客户端 步骤 2 在桶列表中选择待操作的桶, 并单击右侧的, 系统弹出 修改存储类别 对象框 步骤 3 选择目标存储类别, 并单击 确定 说明 修改桶的存储类别后, 不会影响已存储在桶内的对象的存储类别 上传对象时, 默认的对象存储类别与桶的存储类别一致 当桶存储类别修改后, 新上传对象时的默认对象存储类别随之修改 步骤 4 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 搜索桶 OBS Browser 支持按桶名所包含的字符串搜索桶 操作步骤 步骤 1 登录 OBS Browser 步骤 2 在主页面右上角的搜索框中输入需要查找的桶名 步骤 3 单击 搜索到的桶会显示在桶列表中 若想重新搜索其他桶, 可单击后重新输入需要搜索的桶名 删除已输入的关键字 若用户当前处于对象列表界面, 需要快速切换到其他桶, 则可单击页面左侧展开隐藏的桶列表, 并在桶列表上方搜索框中搜索需要切换到的桶 图标 例如 : 您需要查找桶名中包含 test 字符的所有桶, 您只需在主页面右上角的搜索框 中输入 test 并单击, 所有包含 test 字符的桶都会展示到桶列表中 查看桶的基本信息 操作步骤 您可以通过 OBS Browser 查看桶的基本信息, 如拥有者 位置 容量 对象数等 步骤 1 登录 OBS Browser 步骤 2 选中待查看的桶, 单击 基本信息 文档版本 01 ( ) 版权所有 华为技术有限公司 18

25 步骤 3 在弹出的 基本信息 界面中查看桶的基本信息, 如图 2-9 所示 图 2-9 基本信息 文档版本 01 ( ) 版权所有 华为技术有限公司 19

26 表 2-7 参数说明 参数桶名区域存储类别已用容量对象数量访问域名 Endpoint 拥有者账号 ID 说明 桶的名称 桶所在的区域 桶的存储类别, 有标准存储 低频访问存储 归档存储三种类别 桶中存储的对象占用的存储空间 桶中文件夹 当前版本文件和历史版本文件总和 桶的访问域名, 格式为 : 桶名. 域名 桶所在区域的域名 OBS 为每个区域提供 Endpoint, 用于处理各自区域的访问请求 桶的拥有者是指桶创建者的账号 桶的拥有者全局唯一标识, 与 我的凭证 页面的 账号 ID 相同 文档版本 01 ( ) 版权所有 华为技术有限公司 20

27 参数 创建时间 说明 桶的创建时间 碎片管理 背景信息 说明 已用容量 和 对象数量 非实时数据, 系统更新存在至少 15 分钟的延迟 OBS 采用分块上传的模式上传数据, 在下列情况下 ( 但不仅限于此 ) 通常会导致数据上传失败而产生碎片 网络条件较差, 与 OBS 的服务器之间的连接经常断开 上传过程中, 人为中断上传任务 设备故障 突然断电等特殊情况 文件上传失败或上传任务暂停后, 都会有碎片存储在 OBS 中, 可以通过任务管理重新启动上传, 实现断点续传 上传成功后, 碎片将自动消失 您也可以清理通过碎片管理功能清理碎片 清理碎片后, 重新启动上传任务, 上传进度会丢失, 任务重新请求上传 OBS 中存储的碎片需要收费 操作步骤 步骤 1 登录 OBS Browser 步骤 2 选中待配置的桶, 单击 更多 > 碎片管理 步骤 3 在 碎片管理 对话框中, 单击 检测 刷新碎片列表 选择需要删除的碎片, 单击 右侧的, 删除碎片 也可单击列表上方 删除, 清除所有碎片 步骤 4 在弹出的 警告 对话框中确认信息, 单击 确定 步骤 5 在弹出的 提示 对话框, 单击 确定 步骤 6 在 碎片管理 窗口, 单击 关闭 可关闭此窗口返回到 OBS Browser 首页 文档版本 01 ( ) 版权所有 华为技术有限公司 21

28 2.4.6 删除桶 如果您不再需要一个桶, 可以在 OBS 管理控制台上将其删除, 以免占用桶数量配额 前提条件 删除桶之前必须确保桶内的对象已全部删除 只有桶的拥有者才能删除桶 操作步骤 步骤 1 登录 OBS Browser 步骤 2 选中待删除的桶, 单击 更多 > 删除 说明用户删除桶后, 需要等待 30 分钟才能在其他区域创建同名桶 同区域可立即创建 步骤 3 单击确认框中的 确定 步骤 4 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 2.5 对象管理 对象管理方法介绍 OBS Browser 支持以下三种方式管理对象 1. 通过对象列表上方的操作按钮管理对象 单击待操作对象所在行, 选择对象列表上方的操作按钮管理对象, 如图 2-10 所示 图 2-10 对象管理第一种方法 2. 通过对象所在行右侧的操作按钮管理对象 单击待操作对象所在行右侧的操作按钮管理对象, 如图 2-11 所示 图 2-11 对象管理第二种方法 文档版本 01 ( ) 版权所有 华为技术有限公司 22

29 3. 通过右键选项管理对象 右键单击待操作对象所在行, 通过选择弹出框里的操作管理对象, 如图 2-12 所示 图 2-12 对象管理第三种方法 新建文件夹 背景信息 操作步骤 用户可通过 OBS Browser 软件新建文件夹 由于 OBS 没有文件系统中的文件和文件夹概念 为了使用户更方便进行管理数据, OBS 提供了一种方式模拟文件夹 通过在对象的名称中增加 /, 将该对象在管理控制台上模拟成一个文件夹的形式展现 步骤 1 登录 OBS Browser 步骤 2 单击目标桶名称进入对象管理界面, 单击 新建文件夹 步骤 3 在对话框中输入文件夹的名称后, 单击 确定 文件夹名称不能包含以下特殊字符 :\ / : *? " < > 文件夹名称不能以 "." 开头和结尾 文件夹的绝对路径长度不能超过 1023 字节 文档版本 01 ( ) 版权所有 华为技术有限公司 23

30 步骤 4 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 说明 若创建文件夹时弹出拒绝访问的错误提示, 则有可能是如下几种情况导致的 : 通过桶的 ACL 设置功能, 限制了该桶的访问权限 ( 如 : 该用户无桶的写入权限 ) 通过桶的桶策略功能, 限制了该桶的访问权限 ( 如 : 当前时间段不允许对桶进行写入 该用户无桶的写入权限 OBS Browser 未打开服务端加密功能但桶策略配置要求是必须使用服务端加密等 ) 请检查桶的 ACL 设置和桶策略配置, 排查错误 通过对象 URL 访问对象 对象 URL( 对象共享 ) 功能, 可实现匿名用户通过对象共享链接地址, 直接访问对象数据 前提条件 已通过 OBS 管理控制台设置匿名用户读取该指定对象的权限 操作步骤 步骤 1 登录 OBS Browser 步骤 2 选中待配置的对象, 单击需要共享的对象右侧的 对象属性 图标, 如图 2-13 所 示 在 URL 行查看该对象链接地址 登录 OBS Browser 时, 选择 OBS 存储, 则生成的对象链接地址格式为 : 桶名. 域名 / 文件夹目录层级 / 对象名 如果该对象存在于桶的根目录下, 其链接地址不会有文件夹目录层级 图 2-13 对象属性 登录 OBS Browser 时, 选择 其他对象存储, 则生成的对象链接地址格式为 : 存储服务器 IP 地址或域名 / 桶名 / 文件夹目录层级 / 对象名 如果该对象存在于桶的根目录下, 其链接地址不会有文件夹目录层级 登录 OBS Browser 时, 选择 OBS 存储, 则生成的对象链接地址格式为 : 桶名. 域名 / 文件夹目录层级 / 对象名 如果该对象存在于桶的根目录下, 其链接地址不会有文件夹目录层级 文档版本 01 ( ) 版权所有 华为技术有限公司 24

31 说明 对于存储类别为归档存储的桶中的对象, 如果要让匿名用户通过 URL 访问, 则需要先确认对象的状态是否为 已恢复 据对象类型的不同, 通过浏览器访问该对象的方式不同 例如 :.txt.html 等文件可直接通过浏览器打开浏览, 而.exe.dat 等文件则会在浏览器打开时, 自动下载到本地 步骤 3 单击, 复制该对象链接地址 步骤 4 步骤 5 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 将对象链接地址复制到浏览器中打开, 即可访问该对象 搜索文件或文件夹 操作步骤 OBS Browser 支持按前缀搜索文件或文件夹 步骤 1 登录 OBS Browser 步骤 2 步骤 3 单击目标文件或文件夹所在的桶 在对象管理页面右上角的搜索框中输入需要查找的文件或文件夹的前缀 步骤 4 单击 搜索到的文件或文件夹会显示到对象列表中 若想重新搜索其他文件或文件夹, 可单 击输入框中的 删除已输入的关键字后重新输入需要搜索的文件或文件夹名 例如, 您需要查找桶 mybucket 中前缀为 testobject 的文件或文件夹, 则需先进入桶 mybucket 的对象管理页面, 在对象管理页面右上角的搜索框中输入 testobject 并单击 前缀为 testobject 的文件或文件夹都会展示在对象列表中 上传文件或文件夹 背景信息 操作步骤 上传文件操作可将本地文件或文件夹存储至 OBS OBS Browser 使用分段上传功能上传文件 通过分段上传功能,OBS Browser 支持上传最大为 48.8TB 的单个文件 OBS Browser 支持断点续传 当上传任务暂停或者失败, 重新启动上传任务, 根据任务记录的分片信息, 已上传成功的分片不会再次上传, 会请求上传其他的分片 步骤 1 登录 OBS Browser 文档版本 01 ( ) 版权所有 华为技术有限公司 25

32 步骤 2 单击想要上传文件或文件夹的桶 步骤 3 单击 上传, 并选择 上传文件 使用 上传文件 功能上传对象时, 为了更好的体验, 建议您最多同时选择 500 个文件进行上传 如果超过此限制, 建议将多个文件放在文件夹中, 然后使用 上传文件夹 功能进行上传, 详见相关操作 步骤 4 单击 选择文件, 在弹出的对话框中, 选中需要上传的文件, 单击 打开 客户端支持一次上传一个文件夹, 或一次同时上传多个文件 上传多个文件时, 按住 Ctrl 或 Shift 同时选择多个文件即可, 同时支持 Ctrl+A 全选操作 操作习惯与 Windows 操作系统上的操作习惯保持一致 任务管理界面将显示文件或文件夹上传进度, 您可以根据需要对上传任务进行暂停 运行或取消 详细操作可参见 管理上传任务 步骤 5 可选 : 指定对象的存储类别 若不指定, 默认与桶的存储类别一致 步骤 6 单击 确定 相关操作 说明 1. 若上传文件时弹出 Service Unavailable 的错误提示, 则可能是因为当前服务器繁忙, 请稍后重试 2. 若上传文件或文件夹时弹出拒绝访问的错误提示, 则有可能是如下几种情况导致的 : 通过桶的 ACL 设置功能, 限制了该桶的访问权限 ( 如 : 该用户无桶的写入权限 ) 通过桶的桶策略功能, 限制了该桶的访问权限 ( 如 : 当前时间段不允许对桶进行写入 该用户无桶的写入权限 OBS Browser 未打开服务端加密功能但桶策略配置要求是必须使用服务端加密等 ) 请检查桶的 ACL 设置和桶策略配置, 排查错误 若您想同时选择 500 个文件进行上传, 建议将多个文件放在文件夹中, 然后使用 上传文件夹 功能进行上传 步骤 1 登录 OBS Browser 步骤 2 单击想要上传文件或文件夹的桶 步骤 3 单击 上传, 并选择 上传文件夹 步骤 4 单击按钮打开本地文件浏览器对话框 步骤 5 选择待上传的文件夹后, 单击 打开 步骤 6 可选 : 指定对象的存储类别 若不指定, 默认与桶的存储类别一致 后续操作 步骤 7 单击 确定 您可以在上传后修改对象的存储类别, 修改步骤如下 : 文档版本 01 ( ) 版权所有 华为技术有限公司 26

33 步骤 1 登录 OBS Browser 步骤 2 在桶列表中单击待操作的桶 步骤 3 选中目标对象, 并单击右侧的 更多 > 修改存储类别 步骤 4 选择目标存储类别, 并单击 确定 步骤 5 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 对象的存储类别的修改存在如下约束条件 : 标准存储的对象可以修改为低频访问存储和归档存储 低频访问存储的对象可以修改为标准存储和归档存储 归档存储的对象要先取回, 才可以修改为标准存储或者低频访问存储 后两种修改会涉及惩罚费用和取回费用, 请根据对象的使用频率和场景择优选择 您也可以通过配置生命周期规则来转换对象的存储类别, 详情请参见 生命周期管理简介, 两种方法的差异请参见存储类别简介 下载文件或文件夹 操作步骤 用户可根据需要将存储在 OBS 上的文件或文件夹下载到本地 步骤 1 登录 OBS Browser 步骤 2 单击待操作的桶, 选中需要下载的文件或文件夹后, 单击右键选择 下载 OBS 支持批量下载多个文件和文件夹, 按住 Ctrl 或 Shift 同时选中待下载的文件或文件夹, 然后单击右键, 选择 下载 同时支持 Ctrl+A 全选操作 操作习惯与 Windows 操作系统上的操作习惯保持一致 说明 对于存储类别为归档存储的桶中的文件, 需要确认对象的状态为 已恢复 才能对其进行下载 请参见 恢复归档存储文件查看如何恢复文件 步骤 3 在对话框中选择存放文件或文件夹的路径后, 单击 上传 如果目标路径下存在同名文件, 系统会弹出 目标路径存在同名文件, 请选择保存方式, 您可以选择 均保留 或者 覆盖 任务管理界面将显示文件或文件夹下载进度, 您可以根据需要对下载任务进行暂停 删除或取消 详细操作可参见 管理下载任务 重命名文件 前提条件 用户可以根据需要对文件重命名 用户需要有待操作文件的 ACL 读权限 对象 ACL 权限配置, 请参见 配置对象 ACL 文档版本 01 ( ) 版权所有 华为技术有限公司 27

34 操作步骤 步骤 1 登录 OBS Browser 步骤 2 选中待配置的桶, 进入桶界面 步骤 3 右键单击需要重命名的文件, 并选择 重命名 步骤 4 在弹出的 重命名 对话框中输入对象名称, 单击 保存 在任务管理界面将显示重命名任务状态 说明 复制文件或文件夹 前提条件 操作步骤 重命名已恢复的冷存储对象, 该对象会变为未恢复状态 若标准存储对象在冷存储桶中, 重命名该标准存储对象, 该对象会变为冷存储对象 用户可根据需要将存储在 OBS 上的文件或文件夹复制到其他路径下 用户需要有待操作文件的 ACL 读权限 对象 ACL 权限配置, 请参见 配置对象 ACL 步骤 1 登录 OBS Browser 步骤 2 选中待配置的桶, 进入桶界面 步骤 3 右键单击需要复制的文件或文件夹, 并选择 复制 步骤 4 选择存放文件或文件夹的路径后, 单击右键并选择 粘贴 说明 仅支持在当前区域进行复制操作 仅支持将文件或文件夹复制到不同路径下 任务管理界面将显示文件或文件夹复制任务, 您可以根据需要对复制任务进行暂停 删除或取消 详细操作可参见 管理复制任务 移动文件或文件夹 前提条件 用户可根据需要将存储在 OBS 上的文件或文件夹移动到其他路径下 用户需要有待操作文件的 ACL 读权限 对象 ACL 权限配置, 请参见 配置对象 ACL 文档版本 01 ( ) 版权所有 华为技术有限公司 28

35 操作步骤 步骤 1 登录 OBS Browser 步骤 2 选中待配置的桶, 进入桶界面 步骤 3 右键单击需要移动的文件或文件夹, 并选择 移动 步骤 4 选择存放文件或文件夹的路径后, 单击右键并选择 粘贴 说明 仅支持在当前区域进行移动操作 仅支持将文件或文件夹移动到不同路径下 任务管理界面将显示文件或文件夹移动任务, 您可以根据需要对移动任务进行暂停 删除或取消 详细操作可参见 管理移动任务 删除文件或文件夹 用户可根据需要删除已有文件或文件夹 背景信息 删除文件夹时, 文件夹内的文件也将同时被删除, 请务必确认这些文件可以被删除 删除无用的文件或文件夹可节省空间和成本 用户上传到 OBS 的某些文件, 可能需要定期删除, 对于这类删除文件的场景, 可通过 OBS 的生命周期管理功能实现, 也可通过 OBS 的生命周期管理功能一次性清空桶里面所有文件或文件夹 详情请参见 生命周期管理简介 操作步骤 步骤 1 登录 OBS Browser 步骤 2 选中待配置的桶, 选中待删除的文件或文件夹后, 单击右侧 更多 > 删除 OBS 客户端支持同时删除多个文件或文件夹, 按住 Ctrl 或 Shift 同时选中待删除的文件或文件夹 ( 同时支持 Ctrl+A 全选操作 ), 单击右键, 选择 删除 操作习惯与 Windows 操作系统上的操作习惯保持一致 步骤 3 在消息确认框中单击 确定 任务管理界面将显示文件或文件夹删除进度, 您可以根据需要对删除任务进行暂停或消 详细操作可参见 管理删除任务 恢复归档存储文件 针对存储类别为归档存储的对象, 用户需要先恢复才能下载 文档版本 01 ( ) 版权所有 华为技术有限公司 29

36 背景信息 归档存储是一种很少访问 ( 平均一年访问一次 ) 但安全 持久且成本极低的存储服务, 适用于数据归档和长期备份 客户能够以极低的价格安全地存储数据, 帮助客户显著降低了成本 为了保持成本低廉, 数据恢复时间可能长达数分钟到数小时不等 归档存储的对象正在恢复的过程中, 不允许暂停或删除恢复任务 对象状态为恢复中的对象不能再次恢复 数据恢复时间和收费详情请参见产品价格详情 操作步骤 步骤 1 登录 OBS Browser 步骤 2 步骤 3 单击待恢复文件所在的桶, 进入对象列表页面 单击待恢复文件后的 恢复 图标或者选中待恢复的对象, 并单击对象列表上方的 恢复 恢复对象需要设置对象的有效期和恢复速率, 参数解释如表 2-8 所示 : 表 2-8 恢复对象 参数 有效期 速率 说明 对象恢复后, 保持为 已恢复 状态的时长, 从对象恢复完成开始计时 有效期时长可设置 1-30 天的整数 系统默认有效期为 30 天 例如 : 恢复对象时, 有效期设置为 20 天, 则从对象恢复成功后开始算起,20 天后, 该对象则会从 已恢复 状态变成 未恢复 状态 对象的恢复速度 加急 : 可在 1-5 分钟内恢复归档存储数据 标准 : 可在 3-5 小时内恢复归档存储数据 步骤 4 单击 确定 文件恢复状态可单击对象右侧的示 图标, 在 对象属性 页面查看, 如图 2-14 所 文档版本 01 ( ) 版权所有 华为技术有限公司 30

37 图 2-14 恢复状态 文件恢复成功后才能对该文件进行下载操作 可单击页面右上角的 刷新 按钮手动刷新恢复任务查看恢复进度, 系统也会每 5 分钟自动刷新恢复任务 说明 系统每天会在 UTC 00:00 点检查一次文件恢复情况, 过期时间是根据最近一次系统检查时间开始计算的 相关操作 在对象有效期内, 用户可以重复做对象恢复操作 对象的有效期会根据最新一次的恢复完成时间开始算起, 以此可以达到延长对象有效期的目的 说明 MD5 检验 背景信息 重复恢复对象时, 其过期时间应该在上一次恢复对象的过期时间之后 文件在上传和下载的过程中, 受网络影响可能出现损坏 通过 MD5 校验, 可以验证上传或下载文档的正确性 OBS Browser 开启 MD5 校验会影响上传下载速度 本章节以上传文件为例介绍 MD5 校验功能 说明 桶中文件具有 MD5 信息, 下载文件时才会做 MD5 校验 操作步骤 步骤 1 登录 OBS Browser 步骤 2 单击页面右上角的图标并选择 系统配置 文档版本 01 ( ) 版权所有 华为技术有限公司 31

38 步骤 3 在 系统配置 > 基本配置 窗口, 勾选 启用 MD5 校验, 如图 2-15 所示 图 2-15 配置 MD5 校验 步骤 4 单击 保存 步骤 5 单击想要上传文件或文件夹的桶 步骤 6 单击 上传, 并选择 上传文件 步骤 7 单击 选择文件, 在弹出的对话框中, 选中需要上传的文件, 单击 打开 步骤 8 单击 确定 步骤 9 在页面右上角单击, 在 正在运行 任务管理列表中可以查看到文件上传状态和 MD5 校验状态, 如图 2-16 所示 文档版本 01 ( ) 版权所有 华为技术有限公司 32

39 图 2-16 MD5 校验状态 步骤 10 文件上传完成, 可以在 已完成 任务管理列表中查看到 MD5 校验结果, 如图 2-17 所示 图 2-17 MD5 校验结果 2.6 桶 ACL 权限 桶 ACL 权限简介 OBS 支持通过 ACL 对如下授权用户授予访问桶的指定权限, 如表 2-9 所示 文档版本 01 ( ) 版权所有 华为技术有限公司 33

40 表 2-9 OBS 支持的被授权用户 被授权用户桶的拥有者匿名用户注册用户组日志投递用户组 描述 拥有者是指创建桶的账户 桶拥有者默认拥有所有的桶访问权限, 其中桶 ACL 的读取和写入这两种权限永远拥有, 且不支持修改 说明去掉桶读取权限和桶写入权限将导致用户无法执行获取桶内对象列表 在桶中上传对象等基本操作, 为正常使用 OBS, 不建议修改桶拥有者的权限 未注册华为云云服务的普通访客 如果匿名用户被授予了访问桶的权限, 则表示所有人都可以访问对应的桶, 并且不需要经过任何身份认证 注意开启匿名用户的桶访问权限后, 所有人都可以在不经过身份认证的情况下, 对桶进行访问 为安全起见, 不建议通过桶 ACL 为匿名用户设置桶的访问权限 注册用户组代表所有注册了华为云云服务的账号 ( 仅指账号, 不包括通过 IAM 创建的用户组或用户 ) 注册用户必须要经过身份认证 ( 目前主要通过 AK/SK 进行身份认证 ), 才可以获取对应的访问权限 例如, 当注册用户组被授予桶写入权限后, 世界上任何已通过身份验证的华为云云服务账号, 都可以向您的桶上传 覆盖和删除对象 日志投递用户组用于投递 OBS 桶及对象的访问日志 由于 OBS 本身不能在账户的桶中创建或上传任何文件, 因此在需要为桶记录访问日志时, 只能由账户授予日志投递用户组一定权限后,OBS 才能将访问日志写入指定的日志存储桶中 该用户组仅用于 OBS 内部的日志记录 注意当日志记录开启后, 目标存储桶的日志投递用户组会同步开启桶的写入权限和 ACL 读取权限 若手动将日志投递用户组的桶写入权限和 ACL 读取权限关闭, 桶的日志记录会失败 针对桶,OBS 当前支持五种访问权限, 如表 2-10 所示 表 2-10 OBS 支持的访问权限 权限选项描述 桶访问权限读取权限此权限可以获取该桶内对象列表和桶的元数据 写入权限 此权限可以上传 覆盖和删除该桶内任何对象 ACL 访问权限读取权限此权限可以获取对应的桶的权限控制列表 桶的拥有者默认永远具有 ACL 的读取权限 写入权限 此权限可以更新对应桶的权限控制列表 桶的拥有者默认永远具有 ACL 的写入权限 文档版本 01 ( ) 版权所有 华为技术有限公司 34

41 说明 配置桶 ACL 权限 操作步骤 每一次对桶的授权操作都将覆盖桶或对象已有的权限列表, 而不会对其新增权限 OBS 固定有对拥有者 匿名用户 注册用户组以及日志投递用户组设置 ACL 权限的功能 步骤 1 登录 OBS Browser 步骤 2 选中待配置的桶, 单击 配置桶 ACL 步骤 3 根据需求设置目标桶的 ACL 权限, 单击 保存, 如图 2-18 所示 图 2-18 配置桶 ACL 步骤 4 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 2.7 生命周期管理 生命周期管理简介 生命周期管理是指通过配置指定的规则, 实现定时删除桶中的对象或者定时转换对象的存储类别 文档版本 01 ( ) 版权所有 华为技术有限公司 35

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

43 操作步骤 步骤 1 登录 OBS Browser 步骤 2 选中待配置的桶, 单击 更多 > 生命周期管理 步骤 3 在 生命周期管理 对话框中单击 创建, 系统弹出如图 2-20 所示对话框 图 2-20 创建生命周期规则 步骤 4 配置生命周期管理规则 基本信息 : 状态 : 选中 启用, 启用本条生命周期规则 规则名称 : 用于识别不同的生命周期配置, 其长度需不超过 255 字符 策略 : 可以按前缀配置, 也可以配置到整个桶 按前缀配置 : 满足该前缀的对象将受生命周期规则管理, 输入的对象前缀不能包括 \\:*?\"<> 特殊字符, 不能以 / 开头或结尾, 不能两个 / 相邻 配置到整个桶 : 桶内所有对象都将受生命周期规则管理 说明 当按前缀配置时, 如果指定的前缀名与某条已配置的生命周期规则指定的前缀名存在包含关系, OBS 会将两条规则视为同一条, 而禁止您配置本条规则 例如, 系统中已存在指定前缀名为 abc 的规则, 则不允许再配置指定前缀以 abc 字段开头的规则 如果已存在按前缀配置的生命周期规则, 则不允许再新增配置到整个桶的规则 如果已存在配置到整个桶的生命周期规则, 则不允许再新增按前缀配置的规则, 此时界面的 添加规则 按钮会变成灰色, 表示不可操作 当前版本或历史版本 : 转换为低频访问存储 : 指定在对象最后一次更新后多少天, 受规则影响的对象将转换为低频访问存储 至少设置为 30 天 文档版本 01 ( ) 版权所有 华为技术有限公司 37

44 转换为归档存储 : 指定在对象最后一次更新后多少天, 受规则影响的对象将转换为归档存储 若同时设置转换为低频访问存储和转换为归档存储, 则转换为归档存储的时间要比转换为低频访问存储的时间至少长 30 天 若单独设置转换为归档存储, 则没有时间限制 过期删除 : 指定在对象最后一次更新后多少天, 受规则影响的对象将过期并自动被 OBS 删除 过期时间必须大于前两个转换时间的最大值 说明 当前版本 与 历史版本 是针对 多版本控制 而言的 若开启了 多版本控制 功能, 同名的对象上传到同一路径下时, 则会产生不同的版本号 最新版本的对象称之为 当前版本, 历史时间上传的对象称之为 历史版本 可以同时配置这两个版本, 也可以只配置一个版本, 也可以都不配置 例如, 您于 2015 年 1 月 7 日在 OBS 中存储了以下几个文件 : log/test1.log log/test2.log doc/example.doc doc/good.txt 您于 2015 年 1 月 10 日在 OBS 中存储了以下几个文件 : log/clientlog.log log/serverlog.log doc/work.doc doc/travel.txt 在 2015 年 1 月 10 日设置前缀为 log 的对象, 过期删除的时间设置为一天,OBS 将会在 2015 年 1 月 12 日自动删除 log/clientlog.log log/serverlog.log log/ test1.log 和 log/test2.log 这四个对象 在今天设置前缀为 log 的对象, 转换为低频访问存储的时间设置为 30 天, 转换为归档存储的时间设置为 60 天, 过期删除的时间设置为 100 天,OBS 将会第 31 天将 log/clientlog.log log/serverlog.log log/test1.log 和 log/test2.log 这四个对象转换为低频访问存储, 第 61 天后转换为归档存储, 第 101 天后自动删除这些对象 说明 对象存储类别的转换以及过期后被删除的时间可能会延迟, 一般不超过 48 小时 步骤 5 单击 保存 步骤 6 在 生命周期规则 对话框中单击 保存 步骤 7 步骤 8 在 生命周期管理 对话框中单击 确定, 保存当前的生命周期规则 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 2.8 桶策略 桶策略简介 桶的拥有者可以通过编写桶策略 (Bucket Policy) 设置桶的访问权限 文档版本 01 ( ) 版权所有 华为技术有限公司 38

45 2.8.2 配置桶策略 桶策略可基于各种参数, 如 OBS 效果 被授权用户等, 提供对桶和对象的集中访问控制 附加到某个桶上的权限适用于该桶内所有对象 桶的拥有者可通过同一策略对某桶内任意数量的对象进行权限设置 设置桶策略后, 后续对该桶的访问请求都将受到桶策略的限制, 这种限制表现为接受或拒绝请求 桶策略定义了 OBS 中的资源 ( 桶和对象 ) 的访问控制策略 操作步骤 步骤 1 登录 OBS Browser 步骤 2 选择待配置的桶, 单击 更多 > 配置桶策略 步骤 3 根据需求在 配置桶策略 输入框中按照如下格式输入桶策略 : 桶策略各字段含义如表 2-11 所示 除 Effect 字段为必选外, 其他字段均为可选字段 表 2-11 桶策略各字段含义 字段 描述 是否可选 Version 当前支持的取值为 或 可 选 Id 桶策略 ID, 桶策略的唯一标识 可 选 Statement Effect 桶策略描述, 定义完整的权限控制 每条桶策略的 Statement 可由多条描述 (statement) 组成, 每条描述可包含以下字段 : Sid Effect Principal NotPrincipal Action NotAction Resource NotResource Condition 桶策略的效果, 即指定本条桶策略描述的权限是接受请求还是拒绝请求, 取值必须为 Allow 或 Deny 必选 必选 Sid 本条桶策略描述的 ID 可 选 文档版本 01 ( ) 版权所有 华为技术有限公司 39

46 字段 描述 是否可选 Principal/ NotPrincipal Action/ NotAction Resource/ NotResourc e 被授权人, 即指定本条桶策略描述所作用的用户 Principal 和 NotPrincipal 必须二选其一, 指定所作用于或不作用于某用户 操作, 即指定本条桶策略描述所作用的 OBS 操作 Action 和 NotAction 必须二选其一, 指定该 OBS 操作是否生效 资源, 即指定本条桶策略描述所作用的对象 Resource 和 NotResource 必须二选其一, 指定是否针对该 OBS 资源生效 必选 必选 必选 Condition 本条 Statement 生效的条件 可 选 步骤 4 单击 保存 2.9 跨域资源共享 跨域资源共享简介 跨域资源共享 (CORS) 是由 W3C 标准化组织提出的一种网络浏览器的规范机制, 定义了一个域中加载的客户端 Web 应用程序与另一个域中的资源交互的方式 而在通常的网页请求中, 由于同源安全策略 (Same Origin Policy,SOP) 的存在, 不同域之间的网站脚本和内容是无法进行交互的 OBS 支持 CORS 规范, 允许跨域请求访问 OBS 中的资源 使用 OBSCORS 配置的典型应用场景包括 : 通过 CORS 支持, 使用 JavaScript 和 HTML5 来构建 Web 应用, 直接访问 OBS 中的资源, 而不再需要代理服务器做中转 使用 HTML5 中的拖拽功能, 直接向 OBS 上传文件, 展示上传进度, 或是直接从 Web 应用中更新内容 托管在不同域中的外部网页 样式表和 HTML5 应用, 现在可以引用存储在 OBS 中的 Web 字体或图片, 让这些资源能被多个网站共享 CORS 配置会在两分钟内生效 配置跨域资源共享 OBS Browser 提供 HTML5 协议中的跨域资源共享 CORS 设置, 帮助用户实现跨域访问 文档版本 01 ( ) 版权所有 华为技术有限公司 40

47 操作步骤 步骤 1 登录 OBS Browser 步骤 2 选中待配置的桶, 单击 更多 > 配置 CORS 步骤 3 单击 添加 说明 OBS 最多可设置 100 条 CORS 规则 步骤 4 在弹出的 添加 CORS 规则 对话框中, 填写跨域资源共享的规则 图 2-21 添加 CORS 规则 CORS 规则各参数解释如表 2-12 所示 表 2-12 CORS 规则 参数 允许的来源 允许的方法 解释 必选参数, 指定允许的跨域请求的来源, 即允许来自该域名下的请求访问该桶 允许多条匹配规则, 以回车换行为间隔 每个匹配规则允许使用最多一个 * 通配符 例如 : 必选参数, 指定允许的跨域请求方法, 即桶和对象的几种操作类型 包括 :GET POST PUT DELETE HEAD 文档版本 01 ( ) 版权所有 华为技术有限公司 41

48 参数允许的头域补充头域缓存时间 解释 可选参数, 指定允许的跨域请求的头域 只有匹配上允许的头域中的配置, 才被视为是合法的 CORS 请求 允许的头域可设置多个, 多个头域之间换行隔开, 每行最多可填写一个 * 符号, 不支持 & : < 空格以及中文字符 可选参数, 指 CORS 响应中带的补充头域, 给客户端提供额外的信息 补充头域可设置多个, 多个头域之间换行隔开, 不支持 * & : < 空格以及中文字符 必选参数, 请求来源的客户端可以缓存的 CORS 响应时间, 以秒为单位, 默认为 100 秒 步骤 5 单击 确定 步骤 6 单击 确定, 保存该规则 CORS 配置成功后, 便仅允许跨域请求来源的地址通过允许的方法访问 OBS 的桶 例如 : 为桶 testbucket 允许的来源配置为 允许的方法配置为 GET, 允许的头域和补充的头域置空, 缓存时间设置为 100, 则 OBS 仅允许来源为 的 GET 请求访问桶 testbucket, 且不限制该请求的头域, 请求来源的客户端可缓存的该 CORS 请求的响应时间为 100 秒 步骤 7 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 2.10 日志记录 访问日志记录简介 出于分析或审计等目的, 用户可以开启日志记录功能 通过访问日志记录, 桶的拥有者可以深入分析访问该桶的用户请求性质 类型或趋势 当用户开启一个桶的日志记录功能后,OBS 会自动对这个桶的访问请求记录日志, 并生成日志文件写入用户指定的桶 ( 即目标桶 ) 中 当日志记录开启后, 目标存储桶的日志投递用户组会同步开启桶的写入权限和 ACL 读取权限 若手动将日志投递用户组的桶写入权限和 ACL 读取权限关闭, 桶的日志记录会失败 OBS 支持对桶的访问请求创建并保存访问日志记录, 可用于进行请求分析或日志审计 由于日志存储在 OBS 中也会占用用户租用的 OBS 存储空间, 也即意味着将产生额外的存储费用, 默认情况下,OBS 不会为用户的桶收集访问日志 文档版本 01 ( ) 版权所有 华为技术有限公司 42

49 日志记录设置成功后, 大约 15 分钟后可在日志存储目标桶中查看到桶的操作日志 以下所示为在目标桶生成的桶访问日志文件记录 : 787f2f92b a4fe2ab75eb09b8 bucket [13/Aug/2015:01:43: ] xx.xx.xx.xx 787f2f92b a4fe2ab75eb09b BACAD9376ECE141B842B94535B REST.GET.BUCKET.LOCATION - "GET /bucket?location HTTP/1.1" "-" "HttpClient" - - 每个桶访问日志都包含以下信息 : 表 2-13 Bucket Logging 格式 名称示例含义 BucketOwner 787f2f92b a4fe2ab75eb09b8 桶的 ownerid Bucket bucket 桶名 Time [13/Aug/2015:01:43: ] 请求时间戳 (UTC) Remote IP xx.xx.xx.xx 请求 IP Requester 787f2f92b a4fe2ab75eb09b8 请求者 ID RequestID BACAD9376ECE141B842B9 4535B 请求 ID Operation REST.GET.BUCKET.LOCATION 操作名称 Key - 对象名 Request-URI GET /bucket?location HTTP/1.1 请求 URI HTTPStatus 200 返回码 ErrorCode - 错误码 BytesSent 211 HTTP 响应的字节大 小 ObjectSize - 对象大小 (bytes) TotalTime 6 服务端处理时间 (ms) Turn-AroundTime 6 总请求时间 (ms) Referer - 请求的 referrer 头域 User-Agent HttpClient 请求的 user-agent 头 域 VersionID - 请求中带的 versionid STSLogUrn - 联邦认证及委托授 权信息 文档版本 01 ( ) 版权所有 华为技术有限公司 43

50 配置日志记录 前提条件 操作步骤 当一个桶启用了日志记录功能后,OBS 自动将该桶的日志按照固定的命名规则, 生成一个对象写入用户指定的桶 日志投递用户组对目的桶具有 写入权限 和 查看 ACL 权限 权限设置方法请参见 配置桶 ACL 权限 步骤 1 登录 OBS Browser 步骤 2 选中待配置的桶, 单击 更多 > 日志记录 步骤 3 勾选 启用, 选择 目标桶, 并填写 目标前缀 后, 单击 保存, 如图 2-22 所示 图 2-22 日志记录 目标存储桶 指日志文件存储的桶 目标前缀 指日志名的前缀 启用日志记录功能后, 生成的日志文件根据如下规则命名 : <TargetPrefix>YYYY-mm-DD-HH-MM-SS-<UniqueString> 其中,<TargetPrefix> 为用户指定的目标前缀 YYYY-mm-DD-HH-MM-SS 为日志生成的日期与时间, 各字段依次表示年 月 日 时 分 秒 <UniqueString> 为 OBS 自动生成的字符串 在 OBS 客户端中, 如果配置的目标前缀 <TargetPrefix> 以斜杠 / 结尾, 则该桶生成的日志文件在目标桶中将统一存放在以 <TargetPrefix> 命名的文件夹中, 方便您进行管理 例如 : 如果配置目标桶为 bucket, 目标前缀为 bucket-log/, 则所有日志都将保存在目标桶 bucket 内的文件夹 bucket-log/ 中 日志命名举例 : N7MXLAF1BDG7MPDV 如果配置目标桶为 bucket, 目标前缀为 bucket-log, 则所有日志都将直接保存在目标桶 bucket 中 日志命名举例 :bucket-log N7MXLAF1BDG7MPDV 文档版本 01 ( ) 版权所有 华为技术有限公司 44

51 日志记录设置成功后, 大约 15 分钟后可在日志存储目标桶中查看到桶的操作日志 步骤 4 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 2.11 挂载外部桶 挂载外部桶简介 配置挂载外部桶 前提条件 操作步骤 当您拥有其他用户的桶的相应 ACL 权限时, 通过挂载外部桶功能, 可以通过您的个人账号在本地对该桶进行访问 对于挂载桶中的归档存储对象, 挂载者不能恢复不属于自己的归档存储对象, 只有当对象的拥有者授权给挂载者对象读取权限, 才能显示出归档存储对象的恢复状态 挂载者若要下载挂载桶中的对象, 需被授权予对象的读取权限, 且不能下载加密对象 OBS Browser 支持挂载外部桶功能 本账号已获取了挂载桶的相应的读写权限 桶的读写权限通过桶 ACL 配置 对于特定用户的桶 ACL 权限, 通过 OBS 管理控制台设置 ; 注册用户的桶 ACL 权限则可通过 OBS 管理控制台和 OBS Browser 设置 当授权给注册账号权限时, 所有在 OBS 上注册的账号都将获得该权限 例如 : 账号 A 要挂载账号 B 的 testbucket 桶, 账号 B 需授权给账号 A testbucket 桶的读取权限 账号 A 还需要上传对象到挂载桶中时, 账号 B 还需授权给账号 A testbucket 桶的写入权限, 上传到挂载桶中的对象的拥有者是账号 A, 同时授权账号 B 该对象的读写权限 步骤 1 登录 OBS Browser 步骤 2 单击页面左上方 添加桶 步骤 3 在弹出的对话框中, 选择 方式 后的 添加外部桶, 并在 桶名 输入框中, 输入需要挂载的外部桶名称, 并单击 确定, 如图 2-23 所示 文档版本 01 ( ) 版权所有 华为技术有限公司 45

52 图 2-23 添加外部桶 当挂载外部桶成功后, 用户可以在桶列表中查看到挂载的外部桶, 并且对该桶有相应的 ACL 访问权限 步骤 4 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 2.12 对象 ACL 权限 对象 ACL 简介 OBS 提供基于账号的 ACL, 桶的拥有者可以通过 ACL 授予其他账号的访问权限, 例如对象的读取权限,ACL 的读取权限 写入权限 所有的桶和对象在默认情况下, 仅允许桶的拥有者访问桶内的对象 一个账号下的所有用户默认拥有相同的权限, 也可以通过桶策略为同一账号下不同用户设置不同的权限 桶 ACL 只能对账号授权, 桶策略可以对账号或者账号下的用户授权 如果同时配置桶 ACL 和对象 ACL 且两者的授权判定产生冲突时, 以对象 ACL> 桶 ACL 的优先级顺序决定授权结果 OBS 支持通过 ACL 对如下授权用户授予访问对象的指定权限, 如表 2-14 所示 : 表 2-14 OBS 支持的被授权用户 被授权用户拥有者匿名用户注册用户组 描述 拥有者是指对象创建者的账号用户, 默认永远具有 ACL 的读取和写入这两种权限 未注册 OBS 的普通访客 如果匿名用户被授予了访问桶和对象的权限, 则表示所有人都可以访问对应的桶和对象 注册 OBS 的用户 例如, 注册用户可以通过 AK/SK 访问 OBS 客户端 文档版本 01 ( ) 版权所有 华为技术有限公司 46

53 针对对象,OBS 当前支持如下访问权限, 如表 2-15 所示 : 表 2-15 OBS 支持的访问权限 权限 选项 描述 对象访问权限 读取权限 此权限可以获取该对象内容和元数据 ACL 访问权限 读取权限 此权限可以获取对应的对象的权限控制列表 对象的拥有者默认永远具有 ACL 的读取权限 写入权限 此权限可以更新对象的权限控制列表 对象的拥有者默认永远具有 ACL 的写入权限 对象 ACL 使用场景 配置对象 ACL 操作步骤 在以下场景, 我们建议您使用对象 ACL 需要对象级的访问权限控制时 桶策略可以授予对象或对象集访问权限, 当授予一个对象集权限后, 想对对象集中某一个对象再进行单独授权, 通过配置桶策略的方法显然不太实际 此时建议使用对象 ACL, 使得单个对象的权限控制更加方便 使用对象链接访问对象时 一般使用对象 ACL, 将某一个对象通过对象链接开放给匿名用户进行读取操作 步骤 1 登录 OBS Browser 步骤 2 单击待配置的桶, 进入桶界面 步骤 3 在待操作对象右侧, 单击, 选择 配置对象 ACL 步骤 4 根据需求设置目标桶的 ACL 权限, 单击 保存, 如图 2-24 所示 图 2-24 配置对象 ACL 文档版本 01 ( ) 版权所有 华为技术有限公司 47

54 步骤 5 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 2.13 对象策略 对象策略简介 对象策略是指主账号将对象的读写权限授权给该账号下的 IAM 用户 图 2-25 对象策略 配置对象策略 操作步骤 步骤 1 登录 OBS Browser 步骤 2 单击待配置的桶, 进入桶界面 步骤 3 选择待操作的对象, 在对象列表上方, 单击 配置对象策略 步骤 4 若您是第一次配置, 在系统弹出的 配置对象策略 对话框中, 输入 账号 ID, 并单击 确定 若您不是第一次配置, 则不会有改信息弹出, 系统直接弹出 配置对象策略 窗口信息 账号 ID 可通过管理控制台的 我的凭证 页面查看 步骤 5 单击 创建对象策略 步骤 6 在 创建对象策略 对话框中, 设置权限, 选择被授权的 IAM 用户 文档版本 01 ( ) 版权所有 华为技术有限公司 48

55 图 2-26 创建对象策略 步骤 7 单击 确定 步骤 8 在 配置对象策略 对话框中, 单击 保存 步骤 9 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 2.14 服务端加密 服务端加密简介 当启用服务端加密功能后, 用户上传对象时, 数据会在服务端加密成密文后存储 用户下载加密对象时, 存储的密文会先在服务端解密为明文, 再提供给用户 KMS 通过使用硬件安全模块 (HSM) 保护密钥安全的托管, 帮助用户轻松创建和控制加密密钥 用户密钥不会明文出现在 HSM 之外, 避免密钥泄露 对密钥的所有操作都会进行访问控制及日志跟踪, 提供所有密钥的使用记录, 满足监督和合规性要求 需要上传的对象可以通过数据加密服务器提供密钥的方式进行服务端加密 用户首先需要在 KMS 中创建密钥 ( 或者使用 KMS 提供的默认密钥 ), 当用户在 OBS 中上传对象时使用该密钥进行服务端加密 OBS 支持通过接口提供 KMS 托管密钥的服务端加密 (DEW-KMS) 和客户提供加密密钥的服务端加密 (SSE-C) 两种方式,SSE-C 方式是指 OBS 使用用户提供的密钥和密钥的 MD5 值进行服务端加密 使用服务端加密方式上传文件 用户可根据需要对对象进行服务端加密, 使对象更安全的存储在 OBS 中 前提条件 已通过 IAM 服务添加 OBS 所在区域的 KMS Administrator 权限 权限添加方法请参见 统一身份认证服务用户指南 的 如何管理用户组并授权? 章节 文档版本 01 ( ) 版权所有 华为技术有限公司 49

56 操作步骤 步骤 1 登录 OBS Browser 步骤 2 在页面右上角单击 步骤 3 单击 系统配置 > 基本配置, 如图 2-27 所示 图 2-27 配置 KMS 加密 步骤 4 勾选 启用 HTTPS 安全传输协议 以及 启用 KMS 加密 勾选 启用 HTTPS 安全传输协议 和 启用 KMS 加密 后, 上传到 OBS 中的所有对象 都会进行 KMS 加密 对象上传成功后, 单击对象列表右侧的图标进入 属性 界面, 可查看对象的加密状态, 如所示 已加密 表示该对象已进行服务的加密, 未加密 表示该对象未进行服务的加密 对象的加密状态不可修改 说明 由于启用 KMS 加密上传对象, 必须启用 HTTPS 安全传输协议, 所以, 若取消勾选 启用 HTTPS 安全传输协议, 则 启用 KMS 加密 复选框也会取消选择状态 文档版本 01 ( ) 版权所有 华为技术有限公司 50

57 图 2-28 加密状态 说明 由于服务端加密功能不支持 HTTP 协议, 所以想要使用服务端加密功能, 需开启 HTTPS 协议 使用中的密钥不可以删除, 如果删除将导致加密对象不能下载 2.15 任务管理 管理上传任务 用户可通过 OBS Browser 软件管理上传任务 背景信息 前提条件 用户在往 OBS 中上传数据个过程中, 因为各种原因可能会需要暂停或取消任务, 也可能会出现上传失败的任务 通过此功能您可以方便管理这些上传任务 可在 已完成 的任务列表的左下角设置每页显示的已完成任务数量 如果已完成任务数量大于 20 万条, 则系统会按照任务创建时间先后顺序查询 10 万条较早创建的数据, 迁移到 OBS Browser 解压路径下 history 目录中, 以 historydbdata[ 时间戳 ].csv 格式保存, 如 :historydbdata t csv 您执行过上传任务 操作步骤 步骤 1 登录 OBS Browser 步骤 2 在页面右上角单击 步骤 3 在右上角的选择框中选择 上传, 如图 2-29 所示 图 2-29 上传任务列表 文档版本 01 ( ) 版权所有 华为技术有限公司 51

58 可能存在多种原因导致任务上传失败, 单击 全部状态 > 失败, 查看上传失败的任 务, 可选中上传失败的任务, 单击 对其进行重新上传操作 也可将鼠标移动到失败 任务后的 图标上查看失败原因 步骤 4 可选 : 选择正在运行的任务, 单击, 暂停任务 也可单击 暂停所有, 暂停所 有任务 已暂停的任务, 可单击, 继续运行任务 也可单击 运行所有, 运行所有任务 步骤 5 可选 : 选择正在运行的任务, 单击, 删除任务 也可单击 取消所有 删除任务列表中所有正在上传 下载 删除 移动 复制的任务 步骤 6 可选 : 单击页面上方 已完成, 可查看已完成的任务 单击已完成任务后的 按 钮删除已完成的任务 也可单击页面上方的 全部删除 删除全部已完成的任务 管理下载任务 前提条件 操作步骤 用户可通过 OBS Browser 软件管理下载任务 您执行过下载任务 步骤 1 登录 OBS Browser 步骤 2 在页面右上角单击 步骤 3 在右上角的选择框中选择 下载, 如图 2-30 所示 图 2-30 下载任务列表 可能存在多种原因导致任务下载失败, 单击 全部状态 > 失败, 查看下载失败的任 务, 可选中下载失败的任务, 单击 对其进行重新下载操作 也可将鼠标移动到失败 任务后的 图标上查看失败原因 步骤 4 可选 : 选择正在运行的任务, 单击, 暂停任务 也可单击 暂停所有, 暂停所 有任务 文档版本 01 ( ) 版权所有 华为技术有限公司 52

59 已暂停的任务, 可单击, 继续运行任务 也可单击 运行所有, 运行所有任务 步骤 5 可选 : 选择正在运行的任务, 单击, 删除任务 也可单击 取消所有 删除任务列表中所有正在上传 下载 删除 移动 复制的任务 步骤 6 可选 : 单击页面上方 已完成, 可查看已完成的任务 单击已完成任务后的 按 钮删除已完成的任务 也可单击页面上方的 全部删除 删除全部已完成的任务 管理重命名任务 前提条件 操作步骤 用户可通过 OBS Browser 软件管理重命名任务 您执行过重命名任务 步骤 1 登录 OBS Browser 步骤 2 在页面右上角单击 步骤 3 在右上角的选择框中选择 重命名, 如图 2-31 所示 图 2-31 重命名任务列表 可能存在多种原因导致任务重命名失败, 单击 全部状态 > 失败, 查看重命名失败 的任务, 可选中失败的任务, 单击 对其进行重新操作 也可将鼠标移动到失败任务 后的 图标上查看失败原因 步骤 4 可选 : 选择正在运行的任务, 单击, 暂停任务 也可单击 暂停所有, 暂停所 有任务 已暂停的任务, 可单击, 继续运行任务 也可单击 运行所有, 运行所有任务 步骤 5 可选 : 选择正在运行的任务, 单击, 删除任务 也可单击 取消所有 删除任务列表中所有正在上传 下载 删除 移动 复制的任务 文档版本 01 ( ) 版权所有 华为技术有限公司 53

60 管理复制任务 前提条件操作步骤 用户可通过 OBS Browser 软件管理复制任务 您执行过复制任务 步骤 1 登录 OBS Browser 步骤 2 在页面右上角单击 步骤 3 在右上角的选择框中选择 复制, 如图 2-32 所示 图 2-32 复制任务列表 可能存在多种原因导致任务复制失败, 单击 全部状态 > 失败, 查看复制失败的任 务, 可选中复制失败的任务, 单击 对其进行重新复制操作 也可将鼠标移动到失败 任务后的 图标上查看失败原因 步骤 4 可选 : 选择正在运行的任务, 单击, 暂停任务 也可单击 暂停所有, 暂停所 有任务 已暂停的任务, 可单击, 继续运行任务 也可单击 运行所有, 运行所有任务 步骤 5 可选 : 选择正在运行的任务, 单击, 删除任务 也可单击 取消所有 删除任务列表中所有正在上传 下载 删除 移动 复制的任务 步骤 6 可选 : 单击页面上方 已完成, 可查看已完成的任务 单击已完成任务后的 按 钮删除已完成的任务 也可单击页面上方的 全部删除 删除全部已完成的任务 管理移动任务 前提条件 用户可通过 OBS Browser 软件管理移动任务 您执行过移动任务 文档版本 01 ( ) 版权所有 华为技术有限公司 54

61 操作步骤 步骤 1 登录 OBS Browser 步骤 2 在页面右上角单击 步骤 3 在右上角的选择框中选择 移动, 如图 2-33 所示 图 2-33 移动任务列表 可能存在多种原因导致任务移动失败, 单击 全部状态 > 失败, 查看移动失败的任 务, 可选中移动失败的任务, 单击 对其进行重新移动操作 也可将鼠标移动到失败 任务后的 图标上查看失败原因 步骤 4 可选 : 选择正在运行的任务, 单击, 暂停任务 也可单击 暂停所有, 暂停所 有任务 已暂停的任务, 可单击, 继续运行任务 也可单击 运行所有, 运行所有任务 步骤 5 可选 : 选择正在运行的任务, 单击, 删除任务 也可单击 取消所有 删除任务列表中所有正在上传 下载 删除 移动 复制的任务 步骤 6 可选 : 单击页面上方 已完成, 可查看已完成的任务 单击已完成任务后的 按 钮删除已完成的任务 也可单击页面上方的 全部删除 删除全部已完成的任务 管理删除任务 用户可通过 OBS Browser 管理删除任务 前提条件 您执行过删除任务 文档版本 01 ( ) 版权所有 华为技术有限公司 55

62 操作步骤 步骤 1 登录 OBS Browser 步骤 2 在页面右上角单击 步骤 3 在右上角的选择框中选择 删除, 如图 2-34 所示 图 2-34 删除任务列表 可能存在多种原因导致任务删除失败, 单击 全部状态 > 失败, 查看删除失败的任 务, 可选中删除失败的任务, 单击 对其进行重新删除操作 也可将鼠标移动到失败 任务后的 图标上查看失败原因 步骤 4 可选 : 选择正在运行的任务, 单击, 暂停任务 也可单击 暂停所有, 暂停所 有任务 已暂停的任务, 可单击, 继续运行任务 也可单击 运行所有, 运行所有任务 步骤 5 可选 : 选择正在运行的任务, 单击, 删除任务 也可单击 取消所有 删除任务列表中所有正在上传 下载 删除 移动 复制的任务 步骤 6 可选 : 单击页面上方 已完成, 可查看已完成的任务 单击已完成任务后的 按 钮删除已完成的任务 也可单击页面上方的 全部删除 删除全部已完成的任务 管理恢复任务 前提条件 操作步骤 用户可通过 OBS Browser 管理恢复任务 您执行过恢复任务 步骤 1 登录 OBS Browser 步骤 2 在页面右上角单击 步骤 3 在右上角的选择框中选择 恢复, 如图 2-35 所示 文档版本 01 ( ) 版权所有 华为技术有限公司 56

63 图 2-35 恢复任务列表 可能存在多种原因导致任务恢复失败, 可将鼠标移动到失败任务后的败原因 图标上查看失 无法查看恢复任务的速度和剩余时间, 文件恢复状态可单击对象右侧的更多 > 对象属性, 在 对象属性 页面查看, 如图 2-36 所示 图 2-36 恢复状态 文件恢复成功后才能对该文件进行下载操作 可单击页面右上角的 刷新 按钮手动刷新恢复任务查看恢复进度, 系统也会每 5 分钟自动刷新恢复任务 说明 运行所有 和 暂停所有 按钮操作对恢复任务不生效 取消所有 按钮操作, 对正在恢复的任务不生效, 恢复失败的任务会删除 步骤 4 可选 : 单击页面上方 已完成, 可查看已完成的任务 单击已完成任务后的 按 钮删除已完成的任务 也可单击页面上方的 全部删除 删除全部已完成的恢复任 务 2.16 应用举例 文档版本 01 ( ) 版权所有 华为技术有限公司 57

64 存储视频数据 背景信息 操作步骤 某用户是影视爱好者, 有大量的影视资源需要存储, 但个人硬盘无法满足该用户实时扩展的需求 因此该用户开通了 OBS, 用于存储影视资源 该用户希望个人数据能够私有不被其他用户读取, 且可以在上传大文件时具有断点续传功能 步骤 1 启动 OBS Browser 步骤 2 步骤 3 步骤 4 步骤 5 步骤 6 初次运行 OBS Browser 时, 在弹出的 添加新账号 中按要求填写, 新建账号 在界面左上角单击 添加桶, 新建个人用于存储数据的桶 单击新建的桶 单击界面上方的 新建文件夹 创建新文件夹 单击界面上方的 上传 上传文件或文件夹 步骤 7 单击界面左下角的 任务管理 步骤 8 单击 暂停 运行 取消 等可管理正在上传的文件 备份或归档数据 背景信息 配置步骤 OBS 是按存储容量和时间计费的, 某公司有大量视频或音频数据需要备份或归档在 OBS 中, 在一段时间内, 可能这些视频或音频文件的访问频率较高, 但在一定时间过后, 可能就不会再访问这些文件了 用户可选择在一段时间后删除这些文件, 以此来达到节约成本, 更高效利用 OBS 的目的 用户可通过 OBS 管理控制台和 OBS Browser 两种工具存储数据 在使用 OBS 做备份或归档的情况下, 用户一般会存储大量数据, 此时, 建议选择使用 OBS Browser 批量上传待备份或归档的数据 通过 OBS Browser 的批量上传功能上传数据, 可大大缩短数据上传时间 步骤 1 登录 OBS 管理控制台 步骤 2 创建登录 OBS Browser 需要用到的访问密钥, 即 AK 和 SK 1. 登录 OBS 管理控制台 2. 单击 OBS 对象存储管理控制台页面右上角的用户名, 并选择 我的凭证 3. 在 我的凭证 页面, 单击 管理访问秘钥 > 新增访问秘钥, 如图 2-37 所示 每个用户最多可创建两个有效的访问密钥 文档版本 01 ( ) 版权所有 华为技术有限公司 58

65 图 2-37 新增访问密钥 4. 在弹出的 新增访问密钥 对话框中, 输入登录密码和对应验证码 说明 用户如果未绑定邮箱和手机, 则只需输入登录密码 用户如果同时绑定了邮箱和手机, 可以选择其中一种方式进行验证 5. 单击 确定 6. 根据浏览器提示, 保存密钥 密钥会直接保存到浏览器默认的下载文件夹中 说明 为防止访问密钥泄露, 建议您将其保存到安全的位置 如果用户在此提示框中单击 取消, 则不会下载密钥, 后续也将无法重新下载 如果需要使用访问密钥, 可以重新创建新的访问密钥 7. 打开下载下来的 credentials.csv 文件既可获取到访问密钥 (AK 和 SK) 步骤 3 使用步骤 2 中创建的访问密钥登录 OBS Browser, 如图 2-38 所示 图 2-38 添加新账号 -OBS 存储 步骤 4 根据不同的应用场景, 创建不同存储类别的桶 备份场景 : 单击 添加桶, 在弹出框的 存储类别 后选择 低频访问存储, 输入桶名和选择区域后单击 确定 创建一个低频访问存储桶, 用于存放待备份的数据 文档版本 01 ( ) 版权所有 华为技术有限公司 59

66 归档场景 : 单击 添加桶, 在弹出框 存储类别 后选择 归档存储, 输入桶名和选择区域后单击 确定 创建一个归档存储桶, 用于存放待归档的数据 步骤 5 将需要备份或归档的数据上传到新创建的桶中 步骤 6 单击页面左上角的图标返回桶列表 步骤 7 步骤 8 右键单击备份或归档数据存储的目标桶, 并选择 生命周期管理, 进入生命周期设置界面 在 生命周期管理 对话框中单击 创建, 系统弹出如图 2-39 所示对话框 图 2-39 创建生命周期规则 步骤 9 配置生命周期管理规则 基本信息 : 状态 : 选中 启用, 启用本条生命周期规则 规则名称 : 用于识别不同的生命周期配置, 其长度需不超过 255 字符 策略 : 可以按前缀配置, 也可以配置到整个桶 按前缀配置 : 满足该前缀的对象将受生命周期规则管理, 输入的对象前缀不能包括 \\:*?\"<> 特殊字符, 不能以 / 开头或结尾, 不能两个 / 相邻 配置到整个桶 : 桶内所有对象都将受生命周期规则管理 说明 当按前缀配置时, 如果指定的前缀名与某条已配置的生命周期规则指定的前缀名存在包含关系, OBS 会将两条规则视为同一条, 而禁止您配置本条规则 例如, 系统中已存在指定前缀名为 abc 的规则, 则不允许再配置指定前缀以 abc 字段开头的规则 如果已存在按前缀配置的生命周期规则, 则不允许再新增配置到整个桶的规则 如果已存在配置到整个桶的生命周期规则, 则不允许再新增按前缀配置的规则, 此时界面的 添加规则 按钮会变成灰色, 表示不可操作 文档版本 01 ( ) 版权所有 华为技术有限公司 60

67 当前版本或历史版本 : 转换为低频访问存储 : 指定在对象最后一次更新后多少天, 受规则影响的对象将转换为低频访问存储 至少设置为 30 天 转换为归档存储 : 指定在对象最后一次更新后多少天, 受规则影响的对象将转换为归档存储 若同时设置转换为低频访问存储和转换为归档存储, 则转换为归档存储的时间要比转换为低频访问存储的时间至少长 30 天 若单独设置转换为归档存储, 则没有时间限制 过期删除 : 指定在对象最后一次更新后多少天, 受规则影响的对象将过期并自动被 OBS 删除 过期时间必须大于前两个转换时间的最大值 说明 当前版本 与 历史版本 是针对 多版本控制 而言的 若开启了 多版本控制 功能, 同名的对象上传到同一路径下时, 则会产生不同的版本号 最新版本的对象称之为 当前版本, 历史时间上传的对象称之为 历史版本 可以同时配置这两个版本, 也可以只配置一个版本, 也可以都不配置 例如, 您于 2015 年 1 月 7 日在 OBS 中存储了以下几个文件 : log/test1.log log/test2.log doc/example.doc doc/good.txt 您于 2015 年 1 月 10 日在 OBS 中存储了以下几个文件 : log/clientlog.log log/serverlog.log doc/work.doc doc/travel.txt 在 2015 年 1 月 10 日设置前缀为 log 的对象, 过期删除的时间设置为一天,OBS 将会在 2015 年 1 月 12 日自动删除 log/clientlog.log log/serverlog.log log/ test1.log 和 log/test2.log 这四个对象 在今天设置前缀为 log 的对象, 转换为低频访问存储的时间设置为 30 天, 转换为归档存储的时间设置为 60 天, 过期删除的时间设置为 100 天,OBS 将会第 31 天将 log/clientlog.log log/serverlog.log log/test1.log 和 log/test2.log 这四个对象转换为低频访问存储, 第 61 天后转换为归档存储, 第 101 天后自动删除这些对象 说明 对象存储类别的转换以及过期后被删除的时间可能会延迟, 一般不超过 48 小时 步骤 10 单击 保存 步骤 11 步骤 12 在 生命周期规则 对话框中单击 保存, 保存当前的生命周期规则 在弹出的消息窗口中, 单击 确定 关闭创建结果消息窗口 2.17 相关操作 文档版本 01 ( ) 版权所有 华为技术有限公司 61

68 系统配置 本节介绍如何修改 OBS Browser 的各项配置 操作步骤 步骤 1 登录 OBS Browser 步骤 2 在 OBS Browser 右上角, 单击, 并选择 系统配置, 如图 2-40 所示 图 2-40 系统配置 步骤 3 在弹出的 系统配置 对话框中, 更改需要修改的基本配置参数 各参数含义如表 2-16 所示 表 2-16 OBS Browser 配置 参数 启用 HTTPS 安全传输协议 启用证书检验 说明 勾选后所有通信信息都将被加密, 通过 HTTPS 协议传输到 OBS 中 勾选后, 客户端会校验服务端的证书 文档版本 01 ( ) 版权所有 华为技术有限公司 62

69 参数 说明 启用 KMS 加密勾选 启用 HTTPS 安全传输协议 和 启用 KMS 加密 后, 上传到 OBS 中的所有对象都会进行 KMS 加密 启用 MD5 校验 多段上传, 段大小 (MB) 多段下载, 段大小 (MB) 最大任务数 语言 勾选后, 客户端上传 下载文件会进行 MD5 校验 系统默认使用多段上传功能, 大于设置的段大小 ( 默认为 5MB) 的对象在 OBS 后台将分为多个数据段进行上传, 每个数据段的大小通过此界面进行配置 段大小 (MB) 的设置区间在 5MB 到 5GB 之间 说明系统默认使用多段上传功能, 段大小 (MB) 推荐设置指导如下 : 为最大限度提升客户端性能, 设置分段上传的 段大小 (MB) 时可根据实际的上传速度而定, 段大小 (MB) 值高于最大上传速度值最佳 例如 : 当前网络的最大上传速度为 10MBps, 则 段大小 (MB) 值需为大于 10MB 的一个整数值, 一般设置为最大上传速度值的两到三倍 系统默认使用多段下载功能, 大于设置的段大小 ( 默认为 5MB) 的对象在 OBS 后台将分为多个数据段进行上传, 每个数据段的大小通过此界面进行配置 段大小 (MB) 的设置区间在 5MB 到 5GB 之间 设置最大上传和下载任务个数, 请输入 2 到 20 的整数 根据需求设置语言类型 语言切换后, 重启软件生效 步骤 4 可选 : 单击 网络配置, 根据需求设置代理服务器信息, 如图 2-41 所示 图 2-41 网络配置 文档版本 01 ( ) 版权所有 华为技术有限公司 63

70 表 2-17 参数说明 参数 启用代理 说明 勾选后, 会展示 使用身份验证 的可选项 设置以下参数就可以通过代理服务器访问 OBS 地址 : 代理服务器地址 端口 : 代理服务器端口 ( 默认为 8080 ) 步骤 5 可选 : 单击 其它, 根据需要设置其他配置信息, 如图 2-42 所示 图 2-42 其他配置 表 2-18 OBS Browser 其它参数配置 参数 自动检测软件新版本 每页显示的对象个数 说明 勾选后, 每次登录 OBS Browser 时, 都会自动检查软件当前版本是否为最新版本 设置每页显示的对象个数 系统默认设置为 100 个 设置范围为 50 到 300 个 设置成功后可单击页面右上角的 按钮使配置生效 数据库路径 OBS Browser 数据保存的路径 可以通过单击后面的, 修改路径 文档版本 01 ( ) 版权所有 华为技术有限公司 64

71 步骤 6 单击 保存, 保存系统配置 账号管理 添加账号 OBS Browser 支持多个账号的管理 OBS Browser 最多支持添加 10 个账号信息 步骤 1 登录 OBS Browser 步骤 2 在 OBS Browser 右上角, 单击账号名, 并选择 账号管理 步骤 3 在弹出的 账号管理 对话框中, 单击 添加新账号 步骤 4 在 添加新账号 对话框中根据实际需要填写账号信息 需填写的账号信息包括如下几项 : 账号名 : 您在 OBS Browser 上使用的账号名, 仅用于在 OBS Browser 上区别不同的账号, 无需与云服务上注册的 OBS 帐号一致 账号名长度不超过 50 个字符 存储类型 :OBS Browser 支持连接到 OBS 存储 或 其他对象存储 上 当连接对象存储服务时, 选择 OBS 存储,, 如图 2-43 所示 图 2-43 添加新账号 -OBS 存储 当连接其他对象存储服务时, 选择 其他对象存储,, 如图 2-44 所示 文档版本 01 ( ) 版权所有 华为技术有限公司 65

72 您还需同时指定该存储的 服务器地址, 支持填写 IP 地址或域名, 格式为 : 服务器 IP 地址或域名 : 服务器端口号 (HTTPS 协议端口号为 443, HTTP 协议端口号为 80 ) 系统默认服务器为 HTTPS 服务器, 如需使用 HTTP 服务器, 请单击页面右上角的图标并单击 系统配置, 在弹出的 系统配置 窗口, 取消对 启用 HTTPS 安全传输协议 的勾选 图 2-44 添加新账号 - 其他对象存储 Access Key ID/Secret Access Key: 您在存储服务 ( 如 OBS) 上注册帐号后, 在 我的凭证 创建的 AK/SK 获取 AK/SK 方法详情请参见 创建访问密钥 (AK 和 SK) 访问路径 您可以输入桶名称或对象路径, 登录成功后, 将访问特定的桶或对象 系统默认会勾选 记住我的访问密钥, 若用户不勾选, 则在每次登录 OBS Browser 时, 需要重新填写 Secret Access Key 值 步骤 5 单击 确定 账号信息保存成功后, 添加的新账号会在页面右上角账号名下拉列表中显示 单击选中的账号即可切换当前登录账号 文档版本 01 ( ) 版权所有 华为技术有限公司 66

73 编辑账号 步骤 1 登录 OBS Browser 步骤 2 在 OBS Browser 右上角, 单击账号名, 并选择 账号管理 步骤 3 单击需要修改的账号后的 编辑 步骤 4 步骤 5 根据需要修改账号信息 单击 确定, 保存修改的账号信息 删除账号 步骤 1 登录 OBS Browser 步骤 2 在 OBS Browser 右上角, 单击账号名, 并选择 账号管理 步骤 3 单击需要删除的账号后的 删除 步骤 4 单击 确定, 完成帐号删除 更新客户端版本 本节介绍 OBS Browser 更新的方法 操作步骤 系统默认勾选 自动检测软件新版本, 每次登录 OBS Browser 时, 都会自动检查软件当前版本是否为最新版本 用户仅需根据界面提示更新软件即可 若用户登录 OBS Browser 后, 单击页面右上角的, 选择 系统配置 并单击 其它, 取消勾选 自动检测软件新版本, 则可根据如下步骤手动更新 OBS Browser 步骤 1 登录 OBS Browser 步骤 2 在右上方区域单击, 选择 检查更新 步骤 3 根据界面提示进行版本更新 更新后的 OBS Browser, 单击右上角的版本 的提示, 说明更新成功, 选择 检查更新, 出现 已经是最新 2.18 问题处理 文档版本 01 ( ) 版权所有 华为技术有限公司 67

74 无法全局搜索桶中对象 问题 回答 为什么无法全局搜索桶中对象? 目前 OBS Browser 不支持迭代查询整个桶中的对象 ; 只支持查询桶当前目录下的对象 若需要搜索桶中某对象, 需要先进入到该对象所在的文件夹目录下, 再进行对应的搜索操作 例如 : 桶 abc 的根目录下包含文件夹 A 和对象 B, 而文件夹 A 中又包含对象 C, 则在桶 abc 的根目录下, 无法搜索到对象 C, 只有进入文件夹 A 目录下才能搜索到对象 C 无法在浏览器中打开对象 URL 问题 为什么无法在浏览器中打开对象 URL? 回答 若通过对象 URL 访问对象时, 出现类似于如下的错误提示, 则需先在 OBS 管理控制台为该对象开启 匿名用户 的 读取权限 权限开启后, 请按照 通过对象 URL 访问对象中步骤 3 重试 <Error> <Code>AccessDenied</Code> <Message>Access Denied</Message> <RequestId> E B18BC86A3FBD65I</RequestId> <HostId> bcmaseve9j9ty/mg646e5xkf5d2jtbhcmxxt6teficxllgbauvuxjj3hl8zfh+b2 </HostId> </Error> 若通过对象 URL 访问对象时, 出现类似于如下的错误提示, 则表示该对象为已加密对象, 已加密的对象不支持通过对象 URL 访问 <Error> <Code>InvalidRequest</Code> <Message> The object was stored using a form of Server Side Encryption. The correct parameters must be provided to retrieve the object. </Message> <RequestId> E B282B2D4D98C59P</RequestId> <HostId> heawau3vymy64ms9bipt6mt37agwb3sifx6wjuxzyuw9+vraclou4gprquzop+st </HostId> </Error> 通过客户端同时选中大量文件上传时, 上传任务没有创建, 界面无任何提示 问题 为什么通过 OBS Browser 同时选中大量文件上传时, 上传任务没有创建, 界面也无任何提示? 例如 : 用户通过 OBS Browser, 单击 上传 > 上传文件 同时选中 C 盘中大量文件进行上传, 上传任务没有创建, 界面也无任何提示 文档版本 01 ( ) 版权所有 华为技术有限公司 68

75 回答 上传所选文件的文件名字符长度之和不能超过 字符 ( 大概数字 ), 如果超过这个限制则点击上传后没有任何反应 OBS Browser 上传文件 功能, 最多可同时选择 500 个文件进行上传, 如果超过此限制, 建议将多个文件放在文件夹中, 然后使用 上传文件夹 功能进行上传 使用客户端上传文件时, 出现蓝屏或黑屏现象 问题 为什么使用 OBS Browser 上传文件时, 出现蓝屏或黑屏现象? 回答 使用 OBS Browser 上传大量文件或少量大文件时, 会占用较大的内存空间 请检查您 PC 机的内存剩余空间是否大于等于 512MB, 若不足, 请关闭其他应用程序释放内存, 或者增加 PC 机的内存或虚拟内存后重试 若扩大内存后, 仍不能归避此问题, 请根据如下步骤收集 dump 文件, 并联系客服定位并处理问题 步骤 1 右键单击 计算机, 如图 2-45 所示, 单击 属性 > 高级系统设置 > 设置 查看小转储目录路径 此处截图以 Windows 7 Pro SP1 64-bit 操作系统为例 图 2-45 查看小转储目录路径 文档版本 01 ( ) 版权所有 华为技术有限公司 69

76 步骤 2 进入上图所示的小转储目录下, 将所有后缀名为.dump 的文件拷贝并打包发送给联系客服定位并处理问题 使用客户端管理对象时, 在任务列表中无相关任务显示 问题 为什么使用 OBS Browser 对对象进行上传 下载 删除等管理操作时, 在任务列表中无相关任务显示 回答 使用 OBS Browser 对对象进行上传 下载 删除等管理操作时, 需要调用 OBS Browser 内置数据库, 数据库在运行时产生的二进制数据默认保存在 Windows 操作系统用户的个人文件夹下 当 Windows 操作系统用户名包含非英文字符时,OBS Browser 内置数据库无法识别数据保存路径, 进而导致上传 下载 删除等任务无法添加至任务列表 此时请按照以下步骤为数据库运行时产生的二进制数据指定保存路径, 以确保数据库正常运行 步骤 1 在 OBS Browser 右上角, 单击, 并选择 系统配置 步骤 2 单击 其他 步骤 3 单击 数据库路径 参数后面的按钮打开本地文件浏览器对话框 步骤 4 选择路径后, 单击 确定 步骤 5 在 系统配置 > 其他 界面单击 保存, 保存修改后的路径 出现 客户端与服务器的时间相差大于 15 分钟 的报错 问题 当出现 客户端与服务器的时间相差大于 15 分钟 的报错时, 无法正常使用 OBS 回答 出于安全目的,OBS 会校验 Browser 和服务器的时间差, 当该时间差大于 15 分钟时, 会出现此报错, 请调整本地时间以避免此问题 2.19 错误码列表 如果请求因错误导致未被处理, 则会返回一条错误响应 错误响应中包括错误码和具体错误描述 表 2-19 列出了错误响应中的常见错误码 文档版本 01 ( ) 版权所有 华为技术有限公司 70

77 表 2-19 错误码列表 错误码 Obs.0000 Obs.0001 Obs.0002 Obs.0003 Obs.0004 Obs.0005 Obs.0006 Obs.0007 Obs.0008 Obs.0009 Obs.0010 Obs.0011 Obs.0012 Obs.0013 Obs.0014 Obs.0015 Obs.0016 Obs.0017 Obs.0018 Obs.0019 Obs.0020 Obs.0021 Obs.0022 Obs.0023 Obs.0024 描述 网关或代理服务器验证失败, 请输入正确的验证信息 服务端内部出错, 请联系客服处理 网关或代理服务器出现错误, 请联系客服处理 服务器繁忙, 请稍后重试 请求的桶名已经存在 桶的命名空间是系统中所有用户公用的, 选择一个不同的桶名再重试一次 删除失败, 请检查桶中是否存在对象或者登录 OBS Console 检查是否存在历史版本的对象 访问本地文件时出错, 请重试 目标文件被系统占用, 无法上传该文件, 请检查文件是否可以访问 读取文件失败, 请重试 本地磁盘空间不足, 请删除不需要的文件保证磁盘空间充足 没有本地文件读写权限, 请增加相应文件权限 欠费或者余额不足, 请充值后重试 AK 或者 SK 错误 分段上传该文件失败, 请取消该任务后重试 所有对这个对象的访问已经无效了 目标桶不存在或者不属于您, 或者如果是因为您没有权限, 则需要目标桶开放日志投递用户的 写入权限 和 查看 ACL 权限才能执行此操作, 请在权限设置中设置 与其他用户正在执行的操作冲突, 请稍后重试 您所访问的桶不属于当前区域, 请重新选择 区域信息错误, 请确认正确的区域信息 客户端与服务器的时间相差大于 15 分钟 服务器负载过高, 请稍后重试 部分对象删除失败, 请稍后重试 部分对象下载失败, 请稍后重试 用户拥有的桶的数量已经达到了系统的上限 处理失败, 请重试 文档版本 01 ( ) 版权所有 华为技术有限公司 71

78 错误码 Obs.0025 Obs.0026 Obs.0027 Obs.0028 Obs.0029 Obs.0030 Obs.0031 Obs.0032 Obs.0033 Obs.0034 Obs.0035 描述 无效的 IP 地址或域名地址, 请重新输入 文件的绝对路径总长度不能超过 1023 字节, 请重试 连接代理服务器失败, 请检查网络或者代理服务器身份认证信息 目标桶不存在或目标桶与当前桶不属于同一区域, 请确认后重新操作 签名信息错误, 请联系客服处理 无法创建或查找到对应路径, 请检查是否路径过长或者路径不存在 你的账号还没有在系统中注册, 必须先在系统中注册了才能使用该账号 桶策略规则无效, 请重新配置 请求的桶名已经存在 桶的命名空间是系统中所有用户共用的, 选择一个不同的桶名再重试一次 新的有效期对应的过期时间必须晚于当前该对象的过期时间 无法判断桶中是否有对象或碎片, 请检查您是否有桶的读权限 2.20 修订记录 发布日期 修订记录 第十八次正式发布 本次更新说明如下 : 更新了 对象策略 描述 第十七次正式发布 本次更新说明如下 : 系统配置 > 其他 新增了 数据库路径 管理 第十六次正式发布 本次更新说明如下 : 新增了 管理重命名任务 章节 文档版本 01 ( ) 版权所有 华为技术有限公司 72

79 发布日期 修订记录 第十五次正式发布 本次更新说明如下 : browser 支持在 Mac 系统运行 登录入口增加了访问特定桶或对象的入口 更新了界面截图 第十四次正式发布 本次更新说明如下 : 增加了文件重命名功能 增加了对象复制功能 增加了对象移动功能 更新了界面截图 第十三次正式发布 本次更新说明如下 : 增加了对象策略功能 第十二次正式发布 本次更新说明如下 : 增加了对象 ACL 功能 更新了界面截图 第十一次正式发布 本次更新说明如下 : 更新了挂载外部桶的描述 更新了界面截图 第十次正式发布 本次更新说明如下 : 更新了界面截图 第九次正式发布 本次更新说明如下 : 增加了用户权限配置步骤 更新了界面截图 第八次正式发布 本次更新说明如下 : 修改了挂载外部桶的限制 更新了界面截图 文档版本 01 ( ) 版权所有 华为技术有限公司 73

80 发布日期 修订记录 第七次正式发布 本次更新说明如下 : 增加了 入门 章节 增加了 存储类别 描述章节 增加了 MD5 校验功能 增加了证书校验功能 更新了界面截图 第六次正式发布 本次更新说明如下 : 增加跨区域复制 更新了界面截图 第五次正式发布 本次更新说明如下 : 增加流量监控功能 增加了对象级存储类别 增加了修改桶和对象的存储类别的功能 购买指南中删除计费介绍和计费案例, 详细的服务资费费率标准请参见价格说明 更新了界面截图 第四次正式发布 本次更新说明如下 : 在 控制台指南 中增加如下内容 : 配置事件通知 中增加多项目 出现 客户端与服务器的时间相差 15 分钟 的报错 章节 创建桶时增加了一键式设置桶策略功能 第三次正式发布 本次更新说明如下 : 在 控制台指南 的 查看桶的基本信息 中增加 Endpoint 和 访问域名 在 控制台指南 的 通过对象 (URL) 访问对象 中修改 URL 的格式 在 控制台指南 的 配置桶策略 中增加了一键式配置通用策略 在 控制台指南 的 异常处理 中增加 配置事件通知失败 章节 在 购买指南 中删除余额小于 100 的限制 在 快速入门 的 注册云服务账号 中删除 隐私保护 文档版本 01 ( ) 版权所有 华为技术有限公司 74

81 发布日期 修订记录 第二次正式发布 本次更新说明如下 : 在 产品简介 中增加 文档导读 在 快速入门 中增加 相关操作 在 控制台指南 中修改 配置桶策略 章节 新增 动作和条件的详细解释 章节 第一次正式发布 文档版本 01 ( ) 版权所有 华为技术有限公司 75

82 3 obscmd 3 obscmd 3.1 obscmd 简介 华为云对象存储服务 (Object Storage Service,OBS) 是一个基于对象的海量存储服务, 可以存放任意类型和大小的文件, 适用于文件归档 / 备份 静态网站托管以及其他数据存储场景使用 OBS 与自建存储服务器相比, 具有稳定 安全 高效等优势, 详情请参见对象存储服务产品介绍 obscmd 是 OBS 提供的一款运行在 Linux 操作系统的客户端工具, 支持简单的上传及下载功能 对于熟悉 Linux 命令行的用户, 在上传或下载数据时,obscmd 是执行批量处理 自动化任务的理想选择 obscmd 基于 Python 开发, 具有安装简单 传输高效等优势, 并且在数据传输过程中, 支持分段传输, 适用各种网络 支持单个大文件切分成多段, 并发上传 支持按范围并发下载单个大文件 支持多个文件并发上传 文档版本 01 ( ) 版权所有 华为技术有限公司 76

83 3 obscmd 支持多个文件并发下载 3.2 下载并安装 obscmd obscmd 兼容 Linux 各个版本, 且待安装 obscmd 的 Linux 主机可以位于公网, 也可以位于华为云内网 针对两种不同的网络环境, 本章节分别提供下载和安装 obscmd 的链接及方法 在公网下载并安装 obscmd obscmd 的运行环境需要依赖 Python, 具体依赖的版本及说明如表 3-1 所示 表 3-1 Python 具体依赖的版本及说明 组件 / 模块 要求不满足说明处理方法 Python Python 版本要求 Python2, 且不小于 2.7.9, 例如 : Python 执行以下命令, 查看 Python 版本 python V 如果 Python 版本低于 无法使用 https TLS1.1/1.2 功能 安装或升级 Python Python 加密模块 已安装 ssl 模块 执行以下命令, 如果无内容显示, 则 ssl 模块安装正常 python -c "import ssl" 如果 Python 不支持 ssl 模块, 则无法使用 ssl 即 https 加密传输功能 安装或升级 openssl 当待安装 obscmd 的 Linux 主机位于外网, 可以根据表 3-2 提供的链接或页面, 直接从公网下载 obscmd 表 3-2 外网软件下载地址 软件名称说明下载链接或下载页面 obscmd 作为静态资源存储在华为云上的, 可以在 Linux 主机上通过 wget 命令直接下载 在 Windows 主机上可以将下载链接粘贴至浏览器, 通过浏览器直接下载 files/obs/cmd.zip 文档版本 01 ( ) 版权所有 华为技术有限公司 77

84 3 obscmd 软件名称说明下载链接或下载页面 WinSCP ( 可选 ) obscmd 在 GitHub 已经开源, 可以通过 GitHub 提供的下载页面获取下载链接 跨平台文件传输工具 用于在 Windows 系统和 Linux 系统间传输文件 如果是在 Windows 主机上下载的 obscmd 及 Python, 则可以通过此工具将下载完成的 obscmd 及 Python 传输至待安装的 Linux 主机 obscmd 确保 Python 环境已搭建成功后, 使用以下命令解压 obscmd 即可开始使用 unzip 软件包名称 -d 软件存放目录 在内网下载并安装 obscmd 当待安装 obscmd 的 Linux 主机为弹性云服务器 (ECS) 且没有配置弹性 IP(EIP) 时, 则只能根据表 3-3 提供的链接, 从华为云内网下载 obscmd 表 3-3 内网 obscmd 下载链接 区域华北 - 北京一华东 - 上海二华南 - 广州 下载链接 obscmd.zip obscmd.zip obscmd.zip 步骤 1 登录待安装 obscmd 的 Linux 主机, 打开命令行工具 步骤 2 ( 可选 ) 使用 cd 命令, 切换至本地存储软件包的目录, ( 示例 ) 切换至 /home/tools 目录的命令如下 : cd /home/tools 步骤 3 使用 wget 命令, 根据 ECS 所在区域下载对应区域下的软件包 以下命令为从 华北 - 北京一 区域下载 obscmd 的示例 wget 当界面显示有 100% saved 等字样时, 如图 3-1 所示, 表示软件包已成功下载 图 3-1 下载成功 文档版本 01 ( ) 版权所有 华为技术有限公司 78

85 3 obscmd 步骤 4 obscmd 基于 Python 实现, 下载软件包后, 使用以下命令解压后即可使用 unzip obscmd.zip -d 软件存放目录 ( 示例 ) 解压软件包至 /home/tools 目录的命令如下 : unzip obscmd.zip -d /home/tools/ 说明 创建 obscmd 运行依赖 Python, 华为云提供的 ECS 默认都安装有 Python 工具, 您可以按照 检查 Python 版本提供的方法检查 Python 是否安装及其版本 如果 Python 工具未安装或版本不匹配, 您可以通过在线咨询人工客服或拨打 : , 联系华为云技术支持工程师获取对应安装包 说明 默认情况下, 在 ECS 上可以直接通过华为云内网使用 obscmd 如果本地或 VPC 的 DNS 解析没有使用内网 DNS, 则无法通过内网使用 obscmd, 此时请参考在 ECS 上通过内网访问 OBS 进行配置 3.3 注册账号并开通 OBS 操作步骤 在使用 obscmd 之前, 您需要拥有一个华为云账号并且成功开通 OBS OBS 提供按需和资源包两种计费方式, 充值或购买资源包即开通 OBS 服务 成功开通 OBS 后即可进行访问和使用 若您已有账号且账号已开通 OBS 服务, 请跳过此章节 步骤 1 登录华为云网站 步骤 2 注册账号 使用 OBS 前需注册一个华为云账号 若您已有账号, 请从步骤 3 开始 1. 在顶部导航栏右侧, 单击 注册 2. 在注册页面, 根据提示信息完成注册 注册成功后, 系统会自动跳转至您的个人信息界面 步骤 3 步骤 4 步骤 5 步骤 6 在顶部导航栏右侧, 单击 登录, 输账号名和密码 在顶部导航栏右侧, 单击 控制台, 进入华为云控制台 在顶部导航栏, 选择 服务列表 > 存储 > 对象存储服务, 进入 OBS 管理控制台 为保证您正常使用 OBS 服务, 建议您先充值购买 OBS 服务 购买方式, 请参见购买指南 3.4 创建 IAM 用户 为确保账号及资源的安全性, 不建议使用注册账号直接访问 OBS 建议通过统一身份认证服务 (Identity and Access Management,IAM) 创建具有 OBS 资源访问权限的用户, 用以在 obscmd 执行数据存取操作 如果您不需要使用 IAM 用户, 可以跳过此章节 文档版本 01 ( ) 版权所有 华为技术有限公司 79

86 3 obscmd 操作步骤 步骤 1 打开华为云网站 步骤 2 步骤 3 步骤 4 单击页面右上角的 控制台, 使用账号登录管理控制台 在顶部导航栏选择 服务列表 > 管理与部署 > 统一身份认证服务 IAM, 进入 统一身份认证服务 管理控制台 创建用户组 详细步骤请参见创建用户组, 创建成功后, 在 用户组权限 中选择 全局服务 > 对象存储服务, 为该用户组设置 OBS 策略 说明 与 OBS 相关的策略说明如下, 您可以根据说明选择适合的一种或多种策略 : OBS Buckets Viewer: 拥有该权限的用户, 可以执行获取桶列表 查询桶元数据和位置信息的操作 Tenant Administrator: 拥有该权限的用户, 可以对 OBS 资源执行任意操作 Tenant Guest: 拥有该权限的用户, 可以查询 OBS 资源的利用情况 步骤 5 创建用户 详细步骤请参见创建用户, 创建用户时 所属用户组 需选择步骤 4 创建的具有 OBS 权限的用户组 3.5 创建访问密钥 (AK 和 SK) 背景信息 约束和限制 操作步骤 本节介绍如何通过 OBS 管理控制台创建访问密钥 (AK 和 SK), 访问密钥 (AK 和 SK) 用于对请求加密签名, 确保请求的机密性 完整性和请求双方身份的正确性 AK 和 SK 支持 IAM 的认证机制, 以下是对 AK 和 SK 的解释说明 : AK:Access Key ID, 接入键标识, 用户在对象存储服务系统中的接入键标识, 一个接入键标识唯一对应一个用户, 一个用户可以同时拥有多个接入键标识 对象存储服务系统通过接入键标识识别访问系统的用户 SK:Secret Access Key, 安全接入键, 用户在对象存储服务系统中的安全接入键, 是用户访问对象存储服务系统的密钥, 用户根据安全接入键和请求头域生成鉴权信息 安全接入键和接入键标识一一对应 每个用户最多可以创建两个有效的访问密钥 步骤 1 打开华为云网站 步骤 2 单击页面右上角的 控制台, 使用账号或 IAM 用户登录华为云控制台 文档版本 01 ( ) 版权所有 华为技术有限公司 80

87 3 obscmd 步骤 3 单击页面右上角的用户名, 并选择 我的凭证 步骤 4 进入 账号管理 -> 基本信息 页面, 在右侧单击 我的凭证 中的 管理我的凭证 步骤 5 进入 我的凭证 页面, 单击 管理访问密钥 页签下方的 新增访问密钥 步骤 6 在弹出的 新增访问密钥 对话框中, 输入登录密码和对应验证码 说明 用户如果未绑定邮箱和手机, 则只需输入登录密码 用户如果同时绑定了邮箱和手机, 可以选择其中一种方式进行验证 步骤 7 单击 确定 步骤 8 在弹出的 下载确认 提示框中, 单击 确定 后, 密钥会直接保存到浏览器默认的下载文件夹中 说明 为防止访问密钥泄露, 建议您将其保存到安全的位置 如果用户在此提示框中单击 取消, 则不会下载密钥, 后续也将无法重新下载 如果需要使用访问密钥, 可以重新创建新的访问密钥 步骤 9 打开下载下来的 credentials.csv 文件既可获取到访问密钥 (AK 和 SK) 3.6 对接 OBS 公共参数配置项 obscmd 提供公共配置文件用于对桶名 代理 加密和超时等基本信息进行配置, 从而方便在上传或下载过程中, 只需要配置简单的路径等参数即可 前提条件 已安装 obscmd 及其依赖 Python, 具体操作请参考 3.2 下载并安装 obscmd 已获取账号或 IAM 用户的访问密钥 (AK 和 SK) 如果没有访问密钥, 可以参照 3.5 创建访问密钥 (AK 和 SK) 进行创建 说明 在华为云, 账号是云服务资源的责任主体, 对其拥有的资源和 IAM 用户具有完全控制权限 为确保账号及其资源的安全性, 不建议使用注册账号直接访问 OBS 建议通过 IAM 创建具有 OBS 资源访问权限的用户, 用以在 obscmd 执行数据存取操作 具体操作请参考 3.4 创建 IAM 用户 已获取待执行上传或下载操作的桶的名称 说明 您也可以通过 OBS 管理控制台创建一个新桶, 具体请参考创建桶 操作步骤 步骤 1 步骤 2 登录至 obscmd 工具所在主机 使用 cd 命令切换至工具解压目录 示例 :cd /home/tools/obscmd 步骤 3 工具的运行参数配置可以采用以下两种方式来实现, 若两种方式对同一参数都进行了配置, 工具会采用方式二的配置 文档版本 01 ( ) 版权所有 华为技术有限公司 81

88 3 obscmd 方式一 : 编辑 config.dat 中相关参数值 执行以下命令, 打开 obscmd 配置文件进行基础配置 vi config.dat 打开配置文件后, 进入编辑模式, 根据实际环境配置基础参数并保存, 具体的参数配置如表 3-4 所示 表 3-4 公共参数配置项 配置项 说明 可选 / 必 填 备注 ( 所有配置项的值均不区分大小写 ) Operation 指定对文件的操作类型 必填可选 Upload Download AK Access Key ID 接入键标识 必填 用户在对象存储服务系统中的接入键标识, 一个接入键标识唯一对应一个用户, 一个用户可以同时拥有多个接入键标识 对象存储服务系统通过接入键标识识别访问系统的用户 SK Secret Access Key 安全接入键 必填 用户在对象存储服务系统中的安全接入键, 是用户访问对象存储服务系统的密钥, 用户根据安全接入键和请求头域生成鉴权信息 安全接入键和接入键标识一一对应 BucketNameFix ed 桶名 必填 需要上传或下载对象的桶, 所有操 作均对该桶进行 您需要事先在 OBS 上创建桶 示例 : BucketNameFixed = fixed-bucket-01 Concurrency 工作并发数 必填 每个用户对应的并发数, 默认为 20, 表示 1 个用户对应 20 个并发 1 个并发表示 1 个线程或进程 ( 置空视为 1) MultipartObject Size 进行分段操作的对象大小分界值 (Byte) 必填 扫描到对象如果大于 MultipartObjectSize, 则会以多段形式上传并合并, 或者以 range 方式下载并合并, 置空不分段, 单位为字节 B, 默认配置为 ( 即 1GB) 示例 :MultipartObjectSize = 示例说明 : 若对象大于 1GB, 进行分段的上传或下载操作 文档版本 01 ( ) 版权所有 华为技术有限公司 82

89 3 obscmd 配置项 说明 可选 / 必 填 备注 ( 所有配置项的值均不区分大小写 ) PartSize 段大小 (Byte) 必填 分段大小为此处的配置值,OBS 协议要求不小于 5MB, 不大于 5GB ( 上传时工具会自动约束 ) 默认配置为 50MB, 可根据客户端性能及网络环境做有效配置 ( =10MB, =50MB, =100MB) 示例 :PartSize = 注意 : 若段大小设置过大, 进度刷新可能会很慢 单个对象的最终分段数量 ( 对象大小 / 段大小 ) 不能超过 段 Region 区域 可选 请求桶所在区域 需根据请求桶所在区域名称填写区域 例如请求桶所在区域为 华北 - 北京一, 此处则需要填写 cn-north-1 具体请参见区域和终端节点 当使用 KMS 服务端加密算法 或 特殊鉴权签名算法 且环境配置为多 Region 模式时必选 DomainName 域名 必填 请求发往的终端节点域名地址 (Endpoint) 需要与配置的区域信息对应 具体请参见区域和终端节点 VirtualHost 是否使用虚拟主机方式请求的开关 必填 是否使用虚拟主机方式请求, 若使用虚拟主机方式, 需要保证域名配置正确 ( 默认配置为 true) 示例 : true( 使用虚拟主机方式 ) false( 不使用虚拟主机方式 ) IsHTTPs Https 开关 必填 使用 HTTP 还是 HTTPs 请求 ( 默认配 置为 true) 可选值 : true( 使用 https) false( 使用 http) ProxyHost 代理服务器主机 可选 代理服务器主机 ProxyPort 代理服务器端口 可选 代理服务器端口 文档版本 01 ( ) 版权所有 华为技术有限公司 83

90 3 obscmd 配置项 说明 可选 / 必 填 备注 ( 所有配置项的值均不区分大小写 ) ProxyUserName 代理服务器账户 可选 代理服务器账户 ProxyPassWord 代理服务器密码 可选 代理服务器密码 sslversion ssl 协议版本 可选 ssl 协议版本号配置, 当 IsHTTPs 为 true 时生效 ( 如果留空, 默认为 SSLv23) 可选值 : TLSv1 TLSv1_1 TLSv1_2 SSLv23 SSLv2 SSLv3 说明 TLSv1 : 选择 TLS v1.0 协议 TLSv1_1 : 需要 openssl version , python 不低于 TLSv1_2 : 当前最安全协议 需要 openssl version ,python 不低于 SSLv23: 自动协商最安全协议 SSLv2 : 如果 openssl 编译时带了 OPENSSL_NO_SSL2 参数不可用 该协议不安全, 已不建议使用 SSLv3 : 若 openssl 编译时带了 OPENSSL_NO_SSL3 参数不可用 该协议不安全, 已不建议使用 SrvSideEncrypt Type 服务器端数据加密方法 可选 服务器端数据加密方法, 如果不启用, 保持为空 不区分大小写 可选值 : SSE-KMS( 使用 Key Management Service 提供的密钥进行服务端加密 ) SSE-C( 使用用户提供的密钥和密钥的 MD5 值进行服务端加密 ) 文档版本 01 ( ) 版权所有 华为技术有限公司 84

91 3 obscmd 配置项 说明 可选 / 必 填 备注 ( 所有配置项的值均不区分大小写 ) CustomerKey SSE-C 加密密钥 如果使用 SSE- C 服务端加密, 必填 如果配置 SSE-C, 需提供加密对象使用的密钥 SrvSideEncrypt Algorithm 指定服务端加密算法 可选 仅当 SrvSideEncryptType 为 SSE-KMS 时有效 ConnectTimeout 超时时间 必填 连接建立 / 请求等待超时时间, 单位 为秒 ( 若小于 5 秒, 工具会自动约束 为 5 秒 ) 默认配置为 300 CompareETag 校验 Etag 和 MD5, 即数据一致性的开关 可选 是否校验以及在 detail 文件中记录本地 MD5 和服务端返回的 ETag 置空默认关闭 (1. 性能角度考虑 : 若上传或下载的单个文件大于 10GB, 建议关闭 ) 可选值 : true( 打开 ) false( 关闭 ) RecordDetails 记录请求信息开关 必填 是否记录每个请求的详细结果 默认配置为 true 如果打开, 每次执行的请求信息会记录在 result/***_detail.csv 文件中 可选值 : true( 打开 ) false( 关闭 ) 说明 ***_detail.csv 文件名格式为 日期 _ 时间 _ 操作类型 _ 并发数 _detail.csv 示例 : _ _PutObject_20_d etail.csv 文档版本 01 ( ) 版权所有 华为技术有限公司 85

92 3 obscmd 配置项 说明 可选 / 必 填 备注 ( 所有配置项的值均不区分大小写 ) BadRequestCou nted 将错误请求纳入统计开关 必填 如果为 true 性能统计结果将包含错误请求, 此场景有可能导致如下统计出现偏差 : avglatency( 请求的平均时延 ), tps( 每秒事务处理量,transaction per second), sendbps( 传输的总流量 ), recvbps( 接收的总流量 ) 默认配置为 False RunSeconds 运行时长 ( 秒 ) 可选 运行指定时长后退出 如果未到指定时长时, 配置的请求数完成, 工具也会退出 配置为 0 表示不配置, 即按配置的请求数完成后退出 PrintProgress 打印实时结果开关 必填 是否打印运行中的实时结果和进度 默认配置为 true 可选值 : true( 打印实时结果 ) false( 不打印实时结果 ) CheckRoot 限制执行帐户权限 必填 是否必须 root 帐户才有权限操作 ( 默认配置为 false) 可选值 : true( 是 ) false( 否 ) 方式二 : 命令 + 参数的方式实现参数配置, 仅支持配置常用参数 (Operation LocalPath RemoteDir DownloadTarget SavePath AK SK BucketNameFixed Region DomainName), 其他参数可以方式一进行配置 执行以下命令可以查看支持的命令行参数及说明 python run.py --help 文档版本 01 ( ) 版权所有 华为技术有限公司 86

93 3 obscmd 3.7 上传本地文件 编辑配置文件方式 参数配置 obscmd 工具的本地上传功能, 会通过读取 config.dat 文件中配置项来进行传输控制, 包含上传的本地目录, 上传单个文件分段大小等 本地文件上传除了配置 config.dat 公共配置项, 还需要根据上传文件目录实际情况配置如表 3-5 所示参数 : 文档版本 01 ( ) 版权所有 华为技术有限公司 87

94 3 obscmd 表 3-5 上传本地文件参数配置项 配置项名称可选 / 必填说明 LocalPath 待上传目录 必填 需上传的本地文件夹或文件的地址 若上传多个单独指定的文件, 可以用英文逗号分隔 若指定文件夹, 则只能配置一个路径 注意 : 若以 '/' 符号结尾, 将认为是上传文件夹下所有对象, 而不是上传此文件夹 示例 : /home/objects /home/dir1/1.txt /home/dir1/1.txt,/ home/dir2/2.txt IgnoreExist 忽略上传到桶内的文件对象的开关 必填 是否跳过已上传到桶内的文件对象 默认配置为 false 注意 : 若桶内对象数过多, 请勿开启此项配置 可选值 : true( 不覆盖上传已有对象 ) false( 覆盖上传已有对象 ) RemoteDir 上传到桶内的目录 可选 上传到桶内的目录 留空则使用桶的根目录 如果目录不存在, 工具自动创建目录 示例 : RemoteDir = dir/ 文档版本 01 ( ) 版权所有 华为技术有限公司 88

95 3 obscmd 配置项名称可选 / 必填说明 PutWithACL Access Control Policy 对象的权限控制策略 可选 上传对象同时指定 ACL( 各策略详细说明见表 3-6, 默认 private) 可选值 : private public-read public-read-write authenticatedread bucket-ownerread bucket-ownerfull-control CheckFileChanging 检查本地文件是否正在被修改 可选 是否检查本地文件是否正在被修改, 若正在被修改, 则跳过该文件 置空默认关闭 ( 性能角度考虑 : 若上传的文件对象个数较多时, 建议关闭此校验 ) 说明 : 是在上传目标对象之前进行的一种检查, 不检查对象在上传的过程中是否进行了修改 可选值 : true false ArchiveAfterUpload 是否归档已上传成功的文件 可选 是否将已经上传成功的文件进行归档, 置空默认关闭 可选值 : true false 文档版本 01 ( ) 版权所有 华为技术有限公司 89

96 3 obscmd 配置项名称可选 / 必填说明 ArchiveDir 归档路径 当 ArchiveAfterUpload 为 true 时必填 指定数据归档路径, 默认路径为 / home/archive, 如果目录不存, 在数据归档时会进行创建 示例 : /home/archive CheckSoftLinks 是否跳过软链接对象进行上传 可选 是否跳过软链接对象进行上传 可选值 : true( 不上传软链接对象 ) false( 上传软链接对象 ) 表 3-6 OBS 预定义的权限控制策略 预定义的权限控制策略 private public-read public-read-write authenticated-read bucket-owner-read bucket-owner-full-control log-delivery-write 描述 桶或对象的所有者拥有完全控制的权限, 其他任何人都没有访问权限 桶或对象的所有者拥有完全控制的权限, 其他所有用户包括匿名用户拥有读的权限 桶或对象的所有者拥有完全控制的权限, 其他所有用户包括匿名用户拥有读和写的权限 桶或对象的所有者拥有完全控制的权限, 其他 OBS 授权用户拥有读权限 对象的所有者拥有完全控制的权限, 桶的所有者拥有只读的权限 对象的所有者拥有完全控制的权限, 桶的所有者拥有完全控制的权限 日志投递用户组拥有对桶的写权限以及读 ACP 的权限 运行示例 当公共参数和本地上传参数配置完成后, 即可在 obscmd 的安装目录执行 python run.py 开始上传本地对象至 OBS 文档版本 01 ( ) 版权所有 华为技术有限公司 90

97 3 obscmd 说明 如果使用./run.py, 需确保 run.py 文件有执行权限, 在 root 用户下使用 chmod +x * 增加权限 执行 python run.py 命令时,obscmd 会检查必填参数是否已配置, 如果未配置, 会以命令行形式提示用户输入作为临时参数使用 示例 : 本地文件上传运行中效果展示如下图所示 : 本地文件上传运行结束后结果汇总展示如下图所示 : 文档版本 01 ( ) 版权所有 华为技术有限公司 91

98 3 obscmd 屏显解析如表 3-7 所示 : 表 3-7 屏显解析 显示项 Operation 解释 执行的操作类型 RunTime 运行时长 ( 格式 : hh'mm'ss.milliseconds) RunningThreads HTTPs LongConnection Threads Requests OK 当前线程数 HTTPs 还是 HTTP 请求,true 为 HTTPs, false 为 HTTP 长连接还是短连接,true 为长连接,false 为短连接 此次运行的总线程数 当前 ( 最后 ) 已执行的请求数 当前已执行的请求数中 ( 最后 ) 成功的请求个数 文档版本 01 ( ) 版权所有 华为技术有限公司 92

99 3 obscmd 显示项 ClientErrs ServerErrs --OuterFlowControl --InnerFlowControl OtherErrs ErrRate TPS Last5TPS AvgLatency latencypercent DataSend DataRecv SendThroughput RecvThroughput BestReq WorstReq ExecutePath 解释 如果有请求未成功, 因客户端问题造成错误的请求个数 如果有请求未成功, 因服务端问题造成错误的请求个数 -- 当前 ( 最后 ) 服务器端上外部流控错误 -- 当前 ( 最后 ) 服务器端上内部流控错误 当前 ( 最后 ) 所有未知错误 ( 未接收到响应 ), 如网络故障等 当前 ( 最后 ) 错误率 当前 ( 最后 ) 每秒事务处理量 当前近 5 个周期 ( 从 0 每增加 3 秒算作一个周期 ) 内的每秒事务处理量 当前用户并发运行过程中所有成功请求的平均响应时间 用户并发运行过程中各时间段的请求占用百分比, 用字符串描述 当前 ( 最后 ) 所有发送的字节数 当前 ( 最后 ) 所有接收的字节数, 未响应记为 0 当前 ( 最后 ) 所计算出的发送带宽 当前 ( 最后 ) 所计算出的接收带宽 当前 ( 最后 ) 响应时间最快的 3 个请求 ID 及响应时长 当前 ( 最后 ) 响应时间最慢的 3 个请求 ID 及响应时长 此次运行的工具所在目录 命令行方式 obscmd 工具支持命令 + 参数方式运行, 仅支持配置常用参数 (Operation LocalPath RemoteDir DownloadTarget SavePath AK SK BucketNameFixed Region DomainName) 可执行以下命令查看参数说明 python run.py --help 文档版本 01 ( ) 版权所有 华为技术有限公司 93

100 3 obscmd 命令参数说明 : o : 操作类型 (upload 或者 download) l : 上传对象的本地路径 r : 上传对象的桶内路径 d : 下载对象的桶内路径 s : 下载对象的本地保存路径 b : 桶名 A : 用户 AK S : 用户 SK D : 域名地址 R : 区域上传命令示例 :python run.py -o upload -l /home/test/ -r test/ -b testbucket 说明 若同一参数既通过编辑 config.dat 进行了配置, 也通过命令 + 参数的方式进行了配置, 工具将以后者为准 3.8 下载桶内对象 文档版本 01 ( ) 版权所有 华为技术有限公司 94

101 3 obscmd 编辑配置文件方式 参数配置 obscmd 工具的下载桶内对象功能, 会通过读取 config.dat 文件满足客户下载对象的需求 下载桶内对象时除了 config.dat 中公共配置项, 还需要配置如表 3-8 所示参数 : 表 3-8 下载桶内对象参数配置项 配置项名称可选 / 必填说明 DownloadTarget 待下载的 OBS 桶内目标 可选 如果留空, 则下载桶内所有的对象 如果填写, 则下载指定的文件夹或对象 可以混合配置, 以英文逗号分隔 示例 : DownloadTarget = home/dir/ ( 下载文件夹 ) DownloadTarget = home/obj ( 下载单个对象 ) DownloadTarget = home/obj* ( 下载 home 文件夹中以 obj 为前缀的所有对象 ) SavePath 本地保存路径 必填 保存对象的本地路径 如果输入 一个不存在的本地路径, 自动创 建该文件夹 运行示例 当公共参数和下载桶内对象参数配置完成后, 即可在 obscmd 的安装目录执行 python run.py 开始下载 OBS 桶内对象至本地 说明 如果使用./run.py, 需确保 run.py 文件有执行权限, 在 root 用户下使用 chmod +x * 增加权限 执行 python run.py 命令时,obscmd 会检查必填参数是否已配置, 如果未配置, 会以命令行形式提示用户输入作为临时参数使用 示例 : 桶中对象下载到本地目录任务运行中示例 : 文档版本 01 ( ) 版权所有 华为技术有限公司 95

102 3 obscmd 桶中对象下载到本地运行结束后结果汇总展示如下图所示 : 屏显解析如表 3-9 所示 : 文档版本 01 ( ) 版权所有 华为技术有限公司 96

103 3 obscmd 表 3-9 屏显解析 显示项 Operation 解释 执行的操作类型, 下载时候为 GetObject RunTime 本次任务执行的时间 ( 格式 : hh'mm'ss.milliseconds) RunningThreads HTTPs 本次任务正在运行并发线程数 HTTPs 或 HTTP 请求方式,true 为 HTTPs, false 为 HTTP LongConnection HTTP 长连接或短连接,true 为长连接, false 为短连接 Threads Requests OK ClientErrs ServerErrs --OuterFlowControl --InnerFlowControl OtherErrs ErrRate TPS Last5TPS AvgLatency latencypercent DataSend DataRecv SendThroughput RecvThroughput 此次运行的总线程数 当前 ( 最后 ) 已执行的请求数 当前已执行的请求数中 ( 最后 ) 成功的请求个数 如果有请求未成功, 因客户端问题造成错误的请求个数 如果有请求未成功, 因服务端问题造成错误的请求个数 -- 当前 ( 最后 ) 服务器端上外部流控错误 -- 当前 ( 最后 ) 服务器端上内部流控错误 当前 ( 最后 ) 所有未知错误 ( 未接收到响应 ), 如网络故障等 当前 ( 最后 ) 错误率 当前 ( 最后 ) 每秒事务处理量 当前近 5 个周期 ( 从 0 每增加 3 秒算作一个周期 ) 内的每秒事务处理量 当前用户并发运行过程中所有成功请求的平均响应时间 用户并发运行过程中各时间段的请求占用百分比, 用字符串描述 当前 ( 最后 ) 所有发送的字节数 当前 ( 最后 ) 所有接收的字节数, 未响应记为 0 当前 ( 最后 ) 所计算出的发送带宽 当前 ( 最后 ) 所计算出的接收带宽 ( 下载时候带宽值 ) 文档版本 01 ( ) 版权所有 华为技术有限公司 97

104 3 obscmd 显示项 BestReq WorstReq ExecutePath 解释 当前 ( 最后 ) 响应时间最快的 3 个请求 ID 及响应时长 当前 ( 最后 ) 响应时间最慢的 3 个请求 ID 及响应时长 此次运行的工具所在目录 命令行方式 obscmd 工具支持命令 + 参数方式运行, 仅支持配置常用参数 (Operation LocalPath RemoteDir DownloadTarget SavePath AK SK BucketNameFixed Region DomainName) 可执行以下命令查看参数说明 python run.py --help 命令参数说明 : o : 操作类型 (upload 或者 download) l : 上传对象的本地路径 r : 上传对象的桶内路径 d : 下载对象的桶内路径 s : 下载对象的本地保存路径 b : 桶名 文档版本 01 ( ) 版权所有 华为技术有限公司 98

105 3 obscmd A : 用户 AK S : 用户 SK D : 域名地址 R : 区域下载命令示例 : python run.py -o download -d test/ -s /home/test -b testbucket 说明 若同一参数既通过编辑 config.dat 进行了配置也通过命令 + 参数的方式进行了配置, 工具将以后者为准 3.9 Python 工具安装参考 检查 Python 版本 执行 python V 命令, 查看 Python 版本 安装或升级 Python 检查 gcc 是否已安装 执行 gcc -v 命令, 检查是否安装 gcc 当命令行出现如下类似回显时, 表示 gcc 已安装 图 3-2 已安装 gcc 的回显 出现如下类似回显,gcc 未安装 图 3-3 未安装 gcc 的回显 要重新编译安装 openssl 或 Python, 需要客户端支持 gcc 编译环境 文档版本 01 ( ) 版权所有 华为技术有限公司 99

106 3 obscmd 安装 gcc 在有 internet 连接的情况下可以使用如下命令 : apt install gcc yum install gcc 安装或升级 openssl 以 openssl-1.0.2l 为例 : // ubuntu 操作系统 //RedHat,CentOs 类操作系统 通过 下载最新的 openssl 版本 上传 openssl-1.0.2x.tar.gz(x 表示 openssl 版本, 建议使用最新版本 ) 至客户端 ( 通过 sftp 等 ) 或者直接使用如下命令下载到执行机本地 : wget tar -xvf openssl-1.0.2n.tar.gz // 解压到当前目录 cd openssl-1.0.2n // 进入解压后的目录./config -fpic // 进行配置 编译并安装 openssl: make && make install 创建软链接, 验证安装 rm /usr/bin/openssl // 删除之前的 openssl PATH 变量 ln -s /usr/local/ssl/bin/openssl /usr/bin/openssl // 创建新的 openssl 版本路径 文档版本 01 ( ) 版权所有 华为技术有限公司 100

107 3 obscmd 安装 python 以 Python 版本为例 : 通过 下载需要的 Python 版本上传 Python tgz 至客户端, 解压, 进入解压后的目录或者采取直接下载到执行机本地的方式 : wget tar -xvf Python tgz // 解压到本地 cd Python // 进入解压后的目录./configure // 进行配置 编译并安装 python: make // 进行编译 make install // 进行安装 文档版本 01 ( ) 版权所有 华为技术有限公司 101

108 3 obscmd 进行 python 默认版本更新 : rm /usr/bin/python // 删除之前版本链接 ln -s /usr/local/bin/python2.7 /usr/bin/python python -v // 查看 python 版本是不是已经变为安装的版本 // 创建新版本 python 链接 文档版本 01 ( ) 版权所有 华为技术有限公司 102

109 3 obscmd 安装新版本 python 可能会导致原有 Linux 系统的 yum 不可用 ; 原因在于 yum 基于操作系统已有的 python 版本运行, 更新后的 python 版本 yum 不支持, 导致不可用 修正方法如下 : # 修改 yum 文件 vi /usr/bin/yum 将文件头部的 #!/usr/bin/python 改为 #!/usr/bin/python2.7 ( 此处的 python 版本路径根据操作系实际版本为准, 可以通过 ll /usr/bin/python 来获取原有版本信息 ) 3.10 问题处理 在分布式存储系统上运行 obscmd 工具报错 问题现象 根因分析 1. 当 obscmd 放置于分布式存储系统 ( 如 lustre glusterfs) 上, 运行 obscmd 工具, fcntl.flock 报错, 报错信息为 :Function not implemented. 2. 在该分布式文件系统上, 创建 tmpfile 并在 python 中使用如下命令, 出现 Function not implemented, 即为同一问题 import fcntl fd = open('tmpfile','w') fcntl.flock(fd,1) quit() lustre glusterfs 并不兼容 fcntl.flock 函数, 导致报错 文档版本 01 ( ) 版权所有 华为技术有限公司 103

110 3 obscmd 应对措施 请勿将 obscmd 放置于分布式存储系统上, 可将其放置于物理机本地目录后, 再运行 3.11 修订记录 发布日期 修订记录 第四次正式发布 本次更新说明如下 : 优化了章节结构 第三次正式发布 新增 是否跳过软链接 上传参数 本次更新说明如下 : 更新了 安装 obscmd 章节, 新增在华为云内网下载 obscmd 的方法 支持配置代理 增加命令行方式上传本地文件 增加命令行方式下载桶内文件 第二次正式发布 本次更新说明如下 : 增加 问题处理 章节 第一次正式发布 文档版本 01 ( ) 版权所有 华为技术有限公司 104

111 4 OBSFTP 4 OBSFTP 4.1 OBSFTP 工具介绍 概述 工具下载 特性说明 文件传输协议 (File Transfer Protocol,FTP) 是用于在网络上进行文件传输的一套标准协议, 使用客户 / 服务器模式 它属于网络传输协议的应用层 文件传送 (file transfer) 和文件访问 (file access) 之间的区别在于 : 前者由 FTP 提供, 后者由如 NFS 等应用系统提供 对象存储服务 (Object Storage Service,OBS) 是一个基于对象的海量存储服务, 能为用户提供超大存储容量, 适合存放任意类型的文件, 适合普通用户 网站 企业和开发者使用 由于 OBS 是一项面向 Internet 访问的服务, 提供了基于 HTTP/HTTPS 协议的 Web 服务接口, 用户可以随时随地连接到 Internet 的电脑上, 通过 OBS 管理控制台或客户端访问和管理存储在 OBS 中的数据 此外,OBS 支持 REST API 接口, 可使用户方便管理自己存储在 OBS 上的数据, 以及开发多种类型的上层业务应用 OBSFTP 工具利用 pyftpdlib 库的 FTP server 能力和对象存储云端存储能力, 提供出具有 FTP 接入的云上存储使用能力 在企业实际业务中, 无需单独搭建 FTP 服务器和存储池, 实现业务和运维的轻量化, 极大降低了原有的 FTP 访问方式的技术成本 个人或企业客户可在熟悉的 FTP Client 使用环境下, 同时解决数据存储和访问困难的问题 工具下载地址 : 本工具完全开源并遵循 MIT License, 您完全可以自行改造并用于商业或个人行为而不受影响 多操作系统支持 : 支持 32/64 位 Windows Linux 和 Mac 操作系统 免安装 & 配置 : 拥有默认配置, 解压后直接启动使用 开源透明 :OBSFTP 工具使用 Python 语言编程, 完整的源代码可直接在 GitHub 获取 ; 可以根据自己的业务诉求进行灵活的二次开发和改造 文档版本 01 ( ) 版权所有 华为技术有限公司 105

112 4 OBSFTP 功能说明 约束与限制 FTP 基本的数据上传 下载 删除能力无损支持 后端数据传输支持 HTTP/HTTPS 两种模式, 在兼容性和安全性上提供更多选择 使用不同桶进行不同服务的数据存储, 利于业务规划和运维 支持多个 FTP 客户端挂载使用 一般 4 核 8GB 内存的 X86 服务器可支撑 200 个以上客户端同时操作 由于 FTP 协议为明文传输, 为了数据的安全性建议将 OBSFTP 工具和 FTP Client 运行在同一台主机上, 通过 :port 地址来访问规避 FTP 协议的不安全性 工具包需要解压在以 ASCII 码支持的字符 ( 即英文与数字 _ 等 ) 组成的目录下 FTP Server 支持的 Python 版本 : Windows 系统需要先下载安装 Python2.6 或 Python2.7 系列 Linux/Unix 系统自带 Python, 可直接使用 OBSFTP 工具因 FTP 协议限制, 单个客户端上传大量数据不会并发进行, 因此如有大规模数据处理上云建议使用 obscmd 等工具或使用 OBS SDK 进行软件开发实现 4.2 OBSFTP 工具安装和使用 Windows 系统 前提条件 在使用本工具前, 您需完成华为云账号注册, 开通 OBS, 并创建一个可用的桶 在 Windows 上使用此工具前需要您先完成 Python 安装 Python 工具获取地址 : Python 安装指导 : 以普通 Windows 程序默认安装方式运行安装即可 操作步骤 步骤 1 将 OBSFTP 工具包解压到 ASCII 码支持的字符即英文与数字 _ 等组成的目录下 文档版本 01 ( ) 版权所有 华为技术有限公司 106

113 4 OBSFTP 步骤 2 按 Windows+R 打开运行窗口, 输入 cmd 命令, 按 Enter, 打开 CMD 命令窗口 步骤 3 在 CMD 命令窗口进入 OBSFTP 工具所在目录, 执行以下命令, 启动 OBSFTP 工具 python FTPServerStart.py 需要设置更多参数可以通过命令后端增加 --help 获取更多参数信息 具体参数请参考 高级参数设置使用 python FTPServerStart.py --help 步骤 4 使用客户端登录 ( 以 Filezilla 为例 ), 配置登录账号, 地址和端口 文档版本 01 ( ) 版权所有 华为技术有限公司 107

114 4 OBSFTP FTP Client 和 OBSFTP 运行在同一个主机时, 默认的 FTP SERVER 地址为 , 端口号为 服务端是云主机, 客户端在本地主机, 则 FTP SERVER 地址设置为云主机的弹性 IP (EIP) 说明 OBSFTP 部署在云主机, 客户端在本地时候, 启动 OBSFTP 需要设置 listen address 命令如下 : python FTPServerStart.py --listen_address=x.x.x.x 用户名的组成为 : AccessKeyID/bucketname ; 密码为 : AccessSecretyKeyID 步骤 5 登录成功后, 您便可以使用常用的 FTP 命令来管理存储在 OBS 上的文件 文档版本 01 ( ) 版权所有 华为技术有限公司 108

115 4 OBSFTP Linux/Unix 系统 前提条件 在使用本工具前, 您需完成华为云账号注册, 开通 OBS, 并创建一个可用的桶 通常 Linux/unix 系统已安装 Python 程序, 可通过 Python-V 确定其版本 如需升级, 请参考 Python 网站 升级到更高版本 操作步骤 步骤 1 将 OBSFTP 工具包解压到 ASCII 码支持的字符即英文与数字 _ 等组成的目录下 步骤 2 进入到 OBSFTP 工具所在目录, 执行以下命令, 启动 OBSFTP 工具 python FTPServerStart.py 文档版本 01 ( ) 版权所有 华为技术有限公司 109

116 步骤 3 使用客户端登录 ( 以 Filezilla 为例 ), 配置登录账号, 地址和端口 4 OBSFTP FTP Client 和 OBSFTP 运行在同一个主机时, 默认的 FTP SERVER 地址为 , 端口号为 服务端是云主机, 客户端在本地主机, 则 FTP SERVER 地址设置为云主机的弹性 IP (EIP) 说明 OBSFTP 部署在云主机, 客户端在本地时候, 启动 OBSFTP 需要设置 listen address 命令如下 : python FTPServerStart.py --listen_address=x.x.x.x 用户名的组成为 : AccessKeyID/bucketname ; 密码为 : AccessSecretyKeyID 步骤 4 登录成功后, 您便可以使用常用的 FTP 命令来管理存储在 OBS 上的文件 文档版本 01 ( ) 版权所有 华为技术有限公司 110