Distros

Distros in CloudsFor may refer to one of a few different kinds of objects. Distro may refer to a template that has been taken of a VM instance. It may also mean an installable ISO image representing a base to create VMs.

To see full list of distros, you will generally send GET request to the distros endpoint at /api/v1/distros.

List all Distros

To list all of the distros available, send a GET request to /api/v1/distros. The response will be a JSON object with a key called distros. This will be set to an array of distro objects, each of which will contain the standard distro attributes:

Attribute	Type	Description
id	string	A unique string to identify a specific distro.
name	string	Identifier to use to create new VM
image_type	string	Kind of a distro - ready to use template or ISO image, that you can use install the system manually
description	string	Detailed description of a distro.

cURL Example:

curl -X GET -H 'Content-Type: application/json' -u 'user@example.com:password' "https://cloudsfor.com/api/v1/distros"

Request Headers:

Content-Type: application/json
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

Response Headers:

content-type: application/json; charset=utf-8
status: 200 OK

Response Body:

{
  "distros": [
    {
      "id": "11081d5dcd884cf48f73a9d0ba8be005",
      "name": "CentOS-6.6-x86_64-minimal.iso",
      "description": "CentOS distro",
      "image_type": "iso"
    },
    {
      "id": "6b0d616465c611e4a170089e010d4886",
      "name": "windows-server-2008-r2-dc-en",
      "description": "Win Server 2008 R2 SP1",
      "image_type": "template"
    }
  ],
  "meta": {
    "total": 2
  }
}