qingcloud-cli

Pre-release

This release is a pre-release and may not be stable for production use.

Command Line Interface for QingCloud

qingcloud-cli 是 QingCloud 青云的命令行接口，可以通过它对青云的资源进行查看、创建和操作。

Installation

可使用 pip 安装:

$ pip install qingcloud-cli

如果不是在 virtualenv 上安装，则需要 sudo

$ sudo pip install qingcloud-cli

如果你已安装 qingcloud-cli 并需要更新到最新版本，则可以:

$ pip install --upgrade qingcloud-cli

Command Completion

qingcloud-cli 包含命令自动补全功能，不过需要手动配置一下，而且目前只支持 linux 系统。

开启 tab 补全功能需要利用 complete 命令:

$ complete -C qingcloud_completer qingcloud

可以将这条命令加到你的启动脚本中。

Getting Started

使用 qingcloud-cli 必需一个配置文件，配置你自己的 qy_access_key_id 和 qy_secret_access_key 以及 zone 。比如:

qy_access_key_id: 'QINGCLOUDACCESSKEYID'
qy_secret_access_key: 'QINGCLOUDSECRETACCESSKEYEXAMPLE'
zone: 'pek1'

access key 可在青云控制台申请， zone 目前只有一个: pek1 。

配置文件默认放在 ~/.qingcloud/config.yaml ，也可在每次执行命令时以参数 -f /path/to/config 方式来指定。

Parameter Input

qingcloud-cli 的参数只有 int 和 string 类型。如果参数支持传递列表，则多个值之间以 英文逗号 , 分隔。如:

qingcloud iaas describe-keypairs -k kp-bn2n77ow,kp-b2ivaf15 -L 2

有时参数需要是 JSON 格式的字符串，如:

qingcloud iaas add-router-statics -r rtr-ba2nbge6 -s '[{"static_type":1,"val1":"80","val2":"192.168.99.2","val3":"8000"}]'

Command Output

Command 的返回结果为 JSON 结构。例如 describe-keypair 的返回结果:

{
  "action":"DescribeKeyPairsResponse",
  "total_count":2,
  "keypair_set":[
    {
      "description":null,
      "encrypt_method":"ssh-rsa",
      "keypair_name":"kp 1",
      "instance_ids":[
        "i-ogbndull"
      ],
      "create_time":"2013-08-30T05:13:50Z",
      "keypair_id":"kp-bn2n77ow",
      "pub_key":"AAAAB3..."
    },
    {
      "description":null,
      "encrypt_method":"ssh-rsa",
      "keypair_name":"kp 2",
      "create_time":"2013-08-31T05:13:50Z",
      "keypair_id":"kp-b2ivaf15",
      "pub_key":"AAAAB3..."
    }
  ],
  "ret_code":0
}

Metadata

Release files for qingcloud-cli (latest release)

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for qingcloud-cli (latest release)
File	Size	Uploaded
qingcloud-cli-0.6.tar.gz	83.6 kB	Sep 8, 2013	Details

Release files / qingcloud-cli-0.6.tar.gz

Download URL	qingcloud-cli-0.6.tar.gz
Size	83.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`107cc2c44af244c7f00f580a32a2287bd77e725bac43b8843d6215dbe627a1ab`
BLAKE2b-256 checksum How to use checksums	`8759a724bb33685901ee1e4c1d802e3f79f79d27769e25e18089fb43e42b6147`
Upload date	Sep 8, 2013
Uploaded using Trusted Publishing? What is trusted publishing?	No