python-cloudservers 1.2

命令行API

安装此软件包会为您提供shell命令cloudservers，您可以使用它来与Rackspace交互。

您需要提供您的Rackspace用户名和API密钥。您可以使用--username和--apikey参数来这样做，但将其设置为环境变量更容易

export CLOUD_SERVERS_USERNAME=jacobian
export CLOUD_SERVERS_API_KEY=yadayada

您可以通过运行cloudservers help在shell中找到完整的文档

usage: cloudservers [--username USERNAME] [--apikey APIKEY] <subcommand> ...

Command-line interface to the Cloud Servers API.

Positional arguments:
  <subcommand>
    backup-schedule     Show or edit the backup schedule for a server.
    backup-schedule-delete
                        Delete the backup schedule for a server.
    boot                Boot a new server.
    delete              Immediately shut down and delete a server.
    flavor-list         Print a list of available 'flavors' (sizes of
                        servers).
    help                Display help about this program or one of its
                        subcommands.
    image-create        Create a new image by taking a snapshot of a running
                        server.
    image-delete        Delete an image.
    image-list          Print a list of available images to boot from.
    ip-share            Share an IP address from the given IP group onto a
                        server.
    ip-unshare          Stop sharing an given address with a server.
    ipgroup-create      Create a new IP group.
    ipgroup-delete      Delete an IP group.
    ipgroup-list        Show IP groups.
    ipgroup-show        Show details about a particular IP group.
    list                List active servers.
    reboot              Reboot a server.
    rebuild             Shutdown, re-image, and re-boot a server.
    rename              Rename a server.
    resize              Resize a server.
    resize-confirm      Confirm a previous resize.
    resize-revert       Revert a previous resize (and return to the previous
                        VM).
    root-password       Change the root password for a server.
    show                Show details about the given server.

Optional arguments:
  --username USERNAME   Defaults to env[CLOUD_SERVERS_USERNAME].
  --apikey APIKEY       Defaults to env[CLOUD_SERVERS_API_KEY].

See "cloudservers help COMMAND" for help on a specific command.

Python API

还有一个完整的Python API。

作为快速入门

>>> import cloudservers
>>> cs = cloudservers.CloudServers(USERNAME, API_KEY)
>>> cs.flavors.list()
[...]
>>> cs.servers.list()
[...]
>>> s = cs.servers.create(image=2, flavor=1, name='myserver')

... time passes ...

>>> s.reboot()

... time passes ...

>>> s.delete()

常见问题解答

libcloud有什么问题？

没有！然而，作为一个跨服务绑定，它本质上是最小公分母；我需要访问Rackspace特定的API（共享IP组、镜像快照、调整大小等）。我还想有一个命令行工具。

有什么新功能？

请参阅发行说明。