qrsctl
简介
qrsctl 是根据七牛云存储API实现的一个简易命令行辅助工具。覆盖七牛云存储开发者网站包含的大部分甚至更高级的功能。开发者在对七牛云存储 API 有基本了解的情况下,此工具将会非常适用。
下载
qrsctl 命令行辅助工具下载地址:
使用方法
**注意:**Windows 系统用户在 开始 菜单栏选择 运行 输入 cmd 回车即可打开 DOS 命令行窗口,然后切换到 qrsctl.exe 的所在磁盘路径。假设你的 qrsctl.exe 存放在 F:\tools\test1\qrsctl.exe ,那么如下几行命令可以切换到 qrsctl.exe 存放的目录:
> F:
> cd tools
> cd test1
如图:
qrsctl 各个指令的用法可以在命令行直接输入 qrsctl 不带参数来获得。
登录
qrsctl login 参数
说明
User
用户名,一般为注册邮箱。
Passwd
登录密码
用您的开发者帐号登录七牛云存储,登录成功后,才能进行接下来所有其他指令操作。
登录成功后,会话的有效期是 3600 秒(一个小时),一个小时后需要重新登录。
账号管理
查看帐号信息
qrsctl info
返回账号信息
查看密钥(AccessKey/SecretKey)
qrsctl appinfo 参数
说明
AppName
应用名称,网站上默认使用的应用名称是:default
空间管理
创建空间(Bucket)
qrsctl mkbucket2 参数
说明
Bucket
空间名称,字母数字下划线组合。
将空间设置为公开
qrsctl private 0
将空间设置为私有
qrsctl private 1
列出所有空间(Buckets)
qrsctl buckets
查看指定空间(Bucket)信息
qrsctl bucketinfo
空间授权
qrsctl share 参数
说明
Bucket
指定将要授权的存储空间
Uid
将要被授权的用户uid
Permission
指定被授权用户的权限,1(只读),2(读写), -1(取消授权)
设置镜像存储(源站加速)
qrsctl img [,,...] [SrcHost]参数
说明
Bucket
指定用于托管源站资源的存储空间名称,必填。
SrcUrl
源站地址,必填,可设置多个,当第一个源返回500时去带二个源拉取资源。格式:http://domain:port/ 或者 http://ip:port/,其中 port 可选。
SrcHost
源站域名,可选。
取消镜像存储
qrsctl unimg
设置镜像存储回源容错属性
qrsctl imgsft
说明:
开启该属性时,如果 url 的后缀是典型的图片、音视频文件,比如 *.jpg *.jpeg *.png *.gif *.mp3 *.mp4等,然后源站返回的 mimeType 为 textml,则认为源站有可能出错,不缓存该文件。
如果 url 的后缀是典型的图片、音视频文件,比如 *.jpg *.jpeg *.png *.gif *.mp3 *.mp4等,
当返回码是200并且content-length=0的时候,不要返回200,因为客户端会缓存,改为返回 478,然后 error 是 zero content from source。
为0表示不启用镜像存储回源容错属性,为1表示启用镜像存储回源容错属性。
清除cdn缓存
qrsctl cdn/refresh ...
**注意:**最多指定10个 Url
数据处理
设置API规格别名
qrsctl style 参数
说明
Bucket
存储空间名称
aliasName
别名名称
fop
API规格定义,可使用图片处理接口、音视频处理接口等。
友好URL访问形式:
http:///
取消API规格别名
qrsctl unstyle
设置友好URL分隔符
qrsctl separator
设置原文件/图保护
qrsctl protected 参数
说明
Protected
可选值为 0 或者 1 ,0表示不开启保护,1表示开启保护。
文件操作
上传文件
qrsctl put
上传一个大文件(超过 4MB)
qrsctl put -c
加上选项 c 会启用切片并行上传一个大文件。(超过 4MB)
下载文件
qrsctl get
查看文件
qrsctl stat
复制文件
将 Bucket1 中的 KeySrc 复制到 Bucket2 并命名为 KeyDest, Bucket1 和 Bucket2 可以是同一个。
qrsctl cp
移动文件
将 Bucket1 中的 KeyOld 移动到 Bucket2 并命名为 KeyNew, Bucket1 和 Bucket2 可以是同一个。
qrsctl mv
删除文件
qrsctl del
使用技巧
qrsctl 遵循标准Linux工作方式,无出错则无提示,只打印必要的操作信息。
如想知道执行过程是否出错,可以使用下列技巧:
qrsctl command [arguments] && echo "OK"
如执行过程中无错误,则会在屏幕上输出OK字样。