华为云对象存储服务第三方客户指南S3cmd日端用户指资料下载.pdf

1、深圳市龙岗区坂田华为总部办公楼 邮编：518129网址：http:/客户服务邮箱：客户服务电话：4008302118文档版本 02（2017-09-28）华为专有和保密信息版权所有 华为技术有限公司i目目 录录1 简介简介.12 兼容性列表兼容性列表.23 设置设置.43.1 工具准备.43.2 注册云服务帐号.43.3 开通 OBS 服务.43.4 登录 OBS 管理控制台.53.5 创建访问密钥（AK 和 SK）.53.6 对接 OBS.64 操作指南操作指南.94.1 桶管理.94.1.1 创建桶.94.1.2 获取桶列表.104.1.3 查看桶存量信息.104.1.4 查看桶的基本信息

2、.104.1.5 配置桶策略.114.1.6 配置静态网站托管.154.1.7 配置跨域资源共享（CORS）.174.1.8 配置日志记录.204.1.9 配置生命周期管理规则.214.1.10 删除桶.244.2 对象管理.254.2.1 上传对象.254.2.2 获取对象列表.274.2.3 同步对象.274.2.4 复制对象.284.2.5 移动对象.294.2.6 查看对象的基本信息.294.2.7 配置对象的 ACL 权限.304.2.8 配置对象过期规则.314.2.9 下载对象.324.2.10 删除对象.33对象存储服务第三方客户端用户指南（S3cmd）目 录文档版本 02（2

3、017-09-28）华为专有和保密信息版权所有 华为技术有限公司ii4.3 多段上传任务管理.334.3.1 查看多段上传任务.334.3.2 查询段列表.344.3.3 中断多段上传任务.354.4 其他操作.354.4.1 修改配置文件.354.5 操作实例.365 常见问题常见问题.385.1 S3cmd 是否支持分段上传对象？.385.2 S3cmd 对上传对象的大小有限制吗？.385.3 S3cmd 对下载对象的大小有限制吗？.385.4 S3cmd 是否支持服务端加密？.385.5 S3cmd 是否支持批量上传多个对象？.395.6 S3cmd 是否支持批量删除多个对象？.395.

4、7 S3cmd 是否支持断点续传？.396 异常处理异常处理.406.1 采用 HTTPS 方式无法与 OBS 建立连接.406.2 使用 HTTPS 访问名称带点的桶或对象失败.41A 文档修订记录文档修订记录.42对象存储服务第三方客户端用户指南（S3cmd）目 录文档版本 02（2017-09-28）华为专有和保密信息版权所有 华为技术有限公司iii1 简介简介S3cmd是一款基于Python开发的开源命令行工具，可用于上传、检索和管理存储在Amazon S3或者其他使用S3协议的云存储服务中的数据，具有免费、简单、易用等优势。对于熟悉命令行程序的用户，S3cmd是执行批量处理、自动化任

5、务的理想选择。您在使用对象存储服务（Object Storage Service，OBS）时，除可以使用官方提供的客户端之外，也可使用S3cmd接入，对OBS中的桶和对象进行操作，比如上传、下载、删除、设置权限等等。S3cmd适用于Linux和MAC操作系统。本文档以S3cmd 1.6.1版本为例，在Linux Suse操作系统上对S3cmd的使用进行介绍。S3cmd与OBS大部分接口兼容，本文提供了兼容性列表和命令使用示例供您参考，详情请参见2 兼容性列表兼容性列表。如果S3cmd软件升级等造成软件操作与本文档所述不一致，请以S3cmd的官网（http:/s3tools.org/usage）

6、指导为准。对象存储服务第三方客户端用户指南（S3cmd）1 简介文档版本 02（2017-09-28）华为专有和保密信息版权所有 华为技术有限公司12 兼容性列表兼容性列表表表 2-1 S3cmd 兼容性列表操作操作说明说明章节链接章节链接创建桶创建一个OBS桶。4.1.1 创建桶创建桶获取桶列表获取用户在OBS中所有的桶。4.1.2 获取桶列表获取桶列表查看桶存量信息查看指定桶的存量信息。4.1.3 查看桶存量信息查看桶存量信息查看桶的基本信息查看指定桶的基本信息。4.1.4 查看桶的基本信息查看桶的基本信息配置桶策略管理（包括配置、更新和删除）桶策略。4.1.5 配置桶策略配置桶策略配置静

7、态网站托管管理（配置和删除）静态网站托管。4.1.6 配置静态网站托管配置静态网站托管配置跨域资源共享（CORS）管理（配置、更新和删除）桶的跨域资源共享规则。4.1.7 配置跨域资源共享配置跨域资源共享（CORS）配置日志记录管理（包括开启和关闭）桶的日志记录功能。4.1.8 配置日志记录配置日志记录配置生命周期管理规则管理（包括配置、更新、删除）桶的生命周期管理规则。4.1.9 配置生命周期管理配置生命周期管理规则规则删除桶删除指定的OBS桶。4.1.10 删除桶删除桶上传对象上传对象至指定桶中。4.2.1 上传对象上传对象获取对象列表获取指定桶中的对象列表。4.2.2 获取对象列表获取对

8、象列表同步对象同步本地与OBS之间的对象。4.2.3 同步对象同步对象复制对象在OBS上为已存在的对象创建一个副本。4.2.4 复制对象复制对象移动对象在OBS桶间或桶内移动对象。4.2.5 移动对象移动对象查看对象的基本信息查看指定对象的基本信息。4.2.6 查看对象的基本信查看对象的基本信息息对象存储服务第三方客户端用户指南（S3cmd）2 兼容性列表文档版本 02（2017-09-28）华为专有和保密信息版权所有 华为技术有限公司2操作操作说明说明章节链接章节链接配置对象的ACL权限为指定用户配置某个对象的ACL权限。4.2.7 配置对象的配置对象的ACL权权限限配置对象过期规则配置指定

9、对象的过期规则。4.2.8 配置对象过期规则配置对象过期规则下载对象从OBS桶下载对象至本地。4.2.9 下载对象下载对象删除对象删除存储在OBS上的指定对象。4.2.10 删除对象删除对象查看多段上传任务查看指定桶的多段上传任务。4.3.1 查看多段上传任务查看多段上传任务查看段列表查看多段上传任务的列表。4.3.2 查询段列表查询段列表中断多段上传任务中断多段上传任务。4.3.3 中断多段上传任务中断多段上传任务对象存储服务第三方客户端用户指南（S3cmd）2 兼容性列表文档版本 02（2017-09-28）华为专有和保密信息版权所有 华为技术有限公司33 设置设置3.1 工具准备工具准备

10、参见S3cmd官方网站（http:/s3tools.org/s3cmd），按要求准备S3cmd的安装环境和软件安装包，并按照软件包中说明文件（INSTALL）安装好S3cmd工具。S3cmd安装完成后，可通过以下方式验证是否成功。步骤步骤1 打开命令行工具。步骤步骤2 执行以下命令。s3cmd-help如果返回S3cmd使用帮助，表示S3cmd安装成功。-结束结束3.2 注册云服务帐号注册云服务帐号使用OBS之前必须要有一个云服务帐号。操作步骤操作步骤步骤步骤1 打开浏览器。步骤步骤2 登录华为云网站。步骤步骤3 单击“注册”。步骤步骤4 在注册页面，根据提示信息完成注册。注册成功后，系统会自

11、动跳转至您的个人信息界面。-结束结束3.3 开通开通 OBS 服务服务使用OBS服务之前必须先充值，才能正常使用OBS服务。对象存储服务第三方客户端用户指南（S3cmd）3 设置文档版本 02（2017-09-28）华为专有和保密信息版权所有 华为技术有限公司4操作步骤操作步骤步骤步骤1 登录OBS管理控制台。步骤步骤2 单击页面右上角的用户名并选择“用户中心”进入用户中心页面。步骤步骤3 单击“充值”，系统自动跳转到充值窗口。步骤步骤4 根据界面提示信息，对账户进行充值。步骤步骤5 充值成功后，关闭充值窗口，返回管理控制台首页。步骤步骤6 单击“对象存储服务”，开通并进入OBS管理控制台。-

12、结束结束3.4 登录登录 OBS 管理控制台管理控制台您可以通过网页登录OBS管理控制台。操作步骤操作步骤步骤步骤1 登录云服务网站。步骤步骤2 单击页面右上角的“管理控制台”。步骤步骤3 使用帐号密码登录。如您尚未注册云服务，可单击“免费注册”，根据界面提示注册一个云服务帐号。步骤步骤4 在管理控制台首页，选择“所有服务 存储 对象存储服务”。-结束结束3.5 创建访问密钥（创建访问密钥（AK 和和 SK）此处介绍如何通过OBS管理控制台创建访问密钥（AK和SK），访问密钥（AK和SK）用于对请求加密签名，确保请求的机密性、完整性和请求双方身份的正确性。背景信息背景信息AK和SK支持IAM的

13、认证机制，以下是对AK和SK的解释说明：lAK：Access Key ID，接入键标识，用户在对象存储服务系统中的接入键标识，一个接入键标识唯一对应一个用户，一个用户可以同时拥有多个接入键标识。对象存储服务系统通过接入键标识识别访问系统的用户。lSK：Secret Access Key，安全接入键，用户在对象存储服务系统中的安全接入键，是用户访问对象存储服务系统的密钥，用户根据安全接入键和请求头域生成鉴权信息。安全接入键和接入键标识一一对应。约束和限制约束和限制每个用户最多可以创建两个有效的访问密钥。对象存储服务第三方客户端用户指南（S3cmd）3 设置文档版本 02（2017-09-28）华

14、为专有和保密信息版权所有 华为技术有限公司5前提条件前提条件已注册并开通云服务帐号。操作步骤操作步骤步骤步骤1 登录OBS管理控制台。步骤步骤2 单击页面右上角的用户名，并选择“我的凭证”。步骤步骤3 进入“我的凭证”页面，单击“管理访问密钥”页签下方的“新增访问密钥”。步骤步骤4 在弹出的“新增访问密钥”对话框中，输入登录密码和对应验证码。说明说明l用户如果未绑定邮箱和手机，则只需输入登录密码。l用户如果同时绑定了邮箱和手机，可以选择其中一种方式进行验证。步骤步骤5 单击“确定”。步骤步骤6 在弹出的“下载确认”提示框中，单击“确定”后，密钥会直接保存到浏览器默认的下载文件夹中。说明说明为防

15、止访问密钥泄露，建议您将其保存到安全的位置。如果用户在此提示框中单击“取消”，则不会下载密钥，后续也将无法重新下载。如果需要使用访问密钥，可以重新创建新的访问密钥。步骤步骤7 打开下载下来的“credentials.csv”文件既可获取到访问密钥（AK和SK）。-结束结束后续处理后续处理当用户发现访问密钥被异常使用（包括丢失、泄露等情况），或不再使用访问密钥时，建议在访问密钥列表中单击“删除”，立即删除相关密钥。删除访问密钥时，需要输入登录密码和邮箱或者手机验证码进行验证。删除的访问密钥将永久删除且无法恢复。3.6 对接对接 OBSS3cmd安装完成后，需要在S3cmd配置与OBS的对接信息，获得OBS的认证后，才能对OBS进行访问。前提条件前提条件l已完成对接前的资源准备（包括安装S3cmd和获取OBS访问密钥）。l（