qsctl is intended to be an advanced command line tool for QingStor, it provides powerful unix-like commands to let you manage QingStor resources just like files on local machine. Unix-like commands contains: cp, ls, mb, mv, rm, rb, and sync. All of them support batch processing.
virtualenv:
$ pip install qsctlSystem-Wide:
$ sudo pip install qsctlOn Windows systems, run it in a command-prompt window with administrator privileges, and leave out sudo.
To use qsctl, there must be a configuration file , for example:
access_key_id: 'ACCESS_KEY_ID_EXAMPLE'
secret_access_key: 'SECRET_ACCESS_KEY_EXAMPLE'The configuration file is ~/.qingstor/config.yaml by default, it also can be specified by the option -c /path/to/config.
You can also config other option like host , port and so on, just add lines below into configuration file, for example:
host: 'qingstor.com'
port: 443
protocol: 'https'
connection_retries: 3
# Valid levels are 'debug', 'info', 'warn', 'error', and 'fatal'.
log_level: 'debug'Commands supported by qsctl are listed below:
| ls | List QingStor keys under a prefix or all QingStor buckets. |
| cp | Copy local file(s) to QingStor or QingStor key(s) to local. |
| mb | Create a QingStor bucket. |
| rb | Delete an empty QingStor bucket or forcibly delete nonempty QingStor bucket. |
| mv | Move local file(s) to QingStor or QingStor key(s) to local. |
| rm | Delete a QingStor key or keys under a prefix. |
| sync | Sync between local directory and QingStor prefix. |
| presign | Generate a pre-signed URL for an object. |
List keys in bucket <mybucket> by running:
$ qsctl ls qs://mybucket
Directory test/
2016-04-03 11:16:04 4 Bytes test1.txt
2016-04-03 11:16:04 4 Bytes test2.txtSync from QingStor prefix to local directory:
$ qsctl sync qs://mybucket3/test/ test/
File 'test/README.md' written
File 'test/commands.py' writtenSee the detailed usage and more examples with 'qsctl help' or 'qsctl <command> help'.