中文文档

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.

Visit https://github.com/qingstor/qsctl/releases to get latest releases.

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
zone: 'zone_name'

You can also run qsctl command without config file, it will try to find config file in specific directories, and if none of them contain a config file, there will be an interactive setup to help you create the config file, which will be created at {$HOME}/.qingstor/config.yaml. (PS: The specific config file path depends on your os, usually ~/.qingstor/config.yaml in unix-like os, and C:\User\{username}\.qingstor\config.yaml in Windows.)

Commands supported by qsctl are listed below:

• cat: Cat a remote object into stdout.
• cp: Copy local file(s) to QingStor or QingStor key(s) to local.
• ls: List buckets, or objects with given prefix.
• mb: Make a new bucket.
• mv: Move local file(s) to QingStor or QingStor key(s) to local
• presign: Get the pre-signed URL by given object key.
• rb: Delete a bucket.
• rm: Remove remote object(s).
• stat: Stat a remote object.
• sync: Sync between local directory and QS-Directory.
• tee: Tee from stdin to a remote object. (NOTICE: qsctl will not tee the content to stdout like linux tee command does.)

See the detailed usage and examples with qsctl --help or qsctl <command> --help.