# salt.cloud.clouds.qingcloud

## QingCloud Cloud Module

Added in version 2015.8.0.

The QingCloud cloud module is used to control access to the QingCloud. http://www.qingcloud.com/

Use of this module requires the `access_key_id`, `secret_access_key`, `zone` and `key_filename` parameter to be set.

Set up the cloud configuration at `/etc/salt/cloud.providers` or `/etc/salt/cloud.providers.d/qingcloud.conf`:

    my-qingcloud:
      driver: qingcloud
      access_key_id: AKIDMRTGYONNLTFFRBQJ
      secret_access_key: clYwH21U5UOmcov4aNV2V2XocaHCG3JZGcxEczFu
      zone: pek2
      key_filename: /path/to/your.pem

depends:

  requests

salt.cloud.clouds.qingcloud.avail_images(kwargs=None, call=None)

  Return a list of the images that are on the provider.

  CLI Examples:

      salt-cloud --list-images my-qingcloud
      salt-cloud -f avail_images my-qingcloud zone=gd1

salt.cloud.clouds.qingcloud.avail_locations(call=None)

  Return a dict of all available locations on the provider with relevant data.

  CLI Examples:

      salt-cloud --list-locations my-qingcloud

salt.cloud.clouds.qingcloud.avail_sizes(kwargs=None, call=None)

  Return a list of the instance sizes that are on the provider.

  CLI Examples:

      salt-cloud --list-sizes my-qingcloud
      salt-cloud -f avail_sizes my-qingcloud zone=pek2

salt.cloud.clouds.qingcloud.create(vm_)

  Create a single instance from a data dict.

  CLI Examples:

      salt-cloud -p qingcloud-ubuntu-c1m1 hostname1
      salt-cloud -m /path/to/mymap.sls -P

salt.cloud.clouds.qingcloud.destroy(instance_id, call=None)

  Destroy an instance.

  CLI Example:

      salt-cloud -a destroy i-2f733r5n
      salt-cloud -d i-2f733r5n

salt.cloud.clouds.qingcloud.get_configured_provider()

  Return the first configured instance.

salt.cloud.clouds.qingcloud.get_dependencies()

  Warn if dependencies aren't met.

salt.cloud.clouds.qingcloud.list_nodes(call=None)

  Return a list of the instances that are on the provider.

  CLI Examples:

      salt-cloud -Q my-qingcloud

salt.cloud.clouds.qingcloud.list_nodes_full(call=None)

  Return a list of the instances that are on the provider.

  CLI Examples:

      salt-cloud -F my-qingcloud

salt.cloud.clouds.qingcloud.list_nodes_min(call=None)

  Return a list of the instances that are on the provider. Only a list of instances names, and their state, is returned.

  CLI Examples:

      salt-cloud -f list_nodes_min my-qingcloud

salt.cloud.clouds.qingcloud.list_nodes_select(call=None)

  Return a list of the instances that are on the provider, with selected fields.

  CLI Examples:

      salt-cloud -S my-qingcloud

salt.cloud.clouds.qingcloud.query(params=None)

  Make a web call to QingCloud IaaS API.

salt.cloud.clouds.qingcloud.reboot(instance_id, call=None)

  Reboot an instance.

  CLI Examples:

      salt-cloud -a reboot i-2f733r5n

salt.cloud.clouds.qingcloud.script(vm_)

  Return the script deployment object.

salt.cloud.clouds.qingcloud.show_image(kwargs, call=None)

  Show the details from QingCloud concerning an image.

  CLI Examples:

      salt-cloud -f show_image my-qingcloud image=trustysrvx64c
      salt-cloud -f show_image my-qingcloud image=trustysrvx64c,coreos4
      salt-cloud -f show_image my-qingcloud image=trustysrvx64c zone=ap1

salt.cloud.clouds.qingcloud.show_instance(instance_id, call=None, kwargs=None)

  Show the details from QingCloud concerning an instance.

  CLI Examples:

      salt-cloud -a show_instance i-2f733r5n

salt.cloud.clouds.qingcloud.start(instance_id, call=None)

  Start an instance.

  CLI Examples:

      salt-cloud -a start i-2f733r5n

salt.cloud.clouds.qingcloud.stop(instance_id, force=False, call=None)

  Stop an instance.

  CLI Examples:

      salt-cloud -a stop i-2f733r5n
      salt-cloud -a stop i-2f733r5n force=True