1 登录
1.1 登录界面
1.2 登录界面说明
1. 接入节点:客户根据访问的服务端选择“南方中心”或者“北京”;
2. AccessKey:即账号;
3. SecretKey:即密码;
注意:不要向其他人提供 SecretKey 信息,如果SecretKey 泄露,请到 BSS 平台自行重置修改。
4. 记住密钥:选择记住密钥,退出程序后,下次登录时,登录界面上的信息还在,用户无需再次填写;不选择记住密钥,退出程序后,下次登录时,用户需要填写相关信息;
2 模块说明
2.1 我的文件
主要用来创建 bucket;
注意:右上角“X”标记,只是将客户端最小化,不是关闭客户端。
鼠标双击创建的 bucket 名称就能按照界面进行文件操作。
2.2 传输列表
显示上传和下载的实时情况,若人为删除传输完成记录,将不会再有记录显示。
2.3 账号管理
登录界面勾选”记住密钥”,此处将显示登录的账号信息。
2.4 设置中心
通用
设置保持默认允许分块上传的块大小请勾上自动,本地日志记录位置如图所示。注意:分块大小过大,上传超过 15 分钟会导致签名失效,报RequestTimeTooSkewed 异常。
传输
设置最大并发数请根据自己的传输带宽进行设置,比如 4M/s 的带宽,传输的文件超过 10G 的大小,建议并发数目不要超过 2;上传时遇到同名文件策略,默认是跳过,请根据实际情况调整。 上传时遇到同名文件策略:上传时先检查目标路径是否存在同名文件,如果不存在直接上传,否则对比两者的 md5 值,如果相同跳过上传,不同则根据设置的策略进行处理。
覆盖
:本地文件直接覆盖云端文件;跳过
:跳过上传本地文件;保留两者
:上传时在文件名后添加(.当前时间戳)的后缀再上传。注意:单个文件最大建议不要超过 20G,修改设置后,点击保存,
才能对新生成的任务有效,已经开始传输的文件不受影响。2.5 定时任务
新建定时任务说明:
1. 任务名称:用户自定义任务名称;
2. 任务类型:分为上传/下载;
新建文件夹:选择是,在定时任务触发时,会先在目标路径下创建一个任务触发日期加任务名称的目录,格式为“YYYYMMDD_任务名称”,然后把源路径下的所有文件上传到该目录下。选择否就直接将源路径下所有文件上传至目标路径
3. 源路径:源路径可手动编辑,支持%YYYYMMDD%匹配当天日期,%YYYYMMDD-n%匹配前 n 天的当日日期。比如要上传当天(2020 年 12月 28 号)的一个压缩包文件 file-20201228.tar.gz,则对应的定时任务源路径可 以写成 file-%YYYYMMDD%.tar.gz。如果写成 file-%YYYYMMDD-1%.tar.gz,则表示上传的文件是 file-20201227.tar.gz。
4. 目标路径:若状态为上传,目标路径为将文件上传到哪个 bucket 的具体路径;若状态为下载,目标路径为保存下载文件的路径;
5. 时间类型:一次性和周期性;即定时任务一次性执行还是多次执行;
6. 时间选择:一次性任务需要选择具体执行的时间点,周期性任务可以设置每个星期的一天或者几天的某一时间点触发该定时任务,生成相应的传输任务。
说明:只有定时任务状态是“已禁用”的才能删除;
3 用户名及注销
3.1 用户名及注销模块截图
3.2 功能说明
1. 用户名显示:即用户在登录时输入的用户名;
2. 注销:点击该按钮后,跳转到登录界面;
4 附录说明
常见错误码说明:
AccessDenied:认证失败
BucketAlreadyExists:创建时 bucket 已存在
TooManyBuckets:创建 bucket 时个数超过限制
BucketNotEmpty:删除时 bucket 不为空
NoSuchBucket:bucket 不存在
NoSuchKey:文件不存在
KeyAlreadyExists:重命名目录或文件时文件名已存在
QuotaExceeded:超出配额限制
PartSizeTooSmall:上传分块太小,需调整分块大小,重新开始任务
RequestTimeTooSkewed:a.本地时间与服务器时间相差过大,设置本地时间为北京时间;b.文件分块大小设置不合理,导致文件传输过程超过 15 分钟,超过签名有效期
NetworkingError:网络异常,等待重传
TimeoutError:服务器长时间未响应,等待重传
UnknownEndpoint:接入地址有误
UserAborted:定时任务正常调度生成传输任务时,用户手动点击了暂停全部或取消全部
XMLParserError:服务返回 403 Forbidden,确认 ip 和 accessKey 是否已配置在白名单
Md5NotMatch:校验 MD5 值失败
InvalidPart:分块上传时分块信息无效或者分块任务碎片已经被删除
503:服务不可用(Service Unavailable)
504:网关超时(Gateway Timeout)
ENOENT:本地路径不存在
ETIMEDOUT:网络连接超时
ECONNRESET:客户端连接超时被重置
EPERM:没有权限访问本地文件