Synnefo

.. _compute-api-guide:

API Guide

*********

`Cyclades <cyclades.html>`_ is the Compute Service of `Synnefo

<http://www.synnefo.org>`_. The Cyclades/Compute API complies with

`OpenStack Compute <http://docs.openstack.org/api/openstack-compute/2/content>`_

with custom extensions when needed.

This document's goals are:

* Define the Cyclades/Compute REST API

* Clarify the differences between Cyclades and OpenStack/Compute

Users and developers who wish to access Cyclades through its REST API are

advised to use the

`kamaki <http://www.synnefo.org/docs/kamaki/latest/index.html>`_ command-line

client and associated python library, instead of making direct calls.

Overview

========

* OpenStack does not define if requests for invalid URLs should return 404 or a

* Fault. We return a BadRequest Fault.

* OpenStack does not define if requests with a wrong HTTP method should return

* 405 or a Fault. We return a BadRequest Fault.

General API Information

=======================

Authentication

--------------

All requests use the same authentication method: an ``X-Auth-Token`` header is

passed to the servive, which is used to authenticate the user and retrieve user

related information. No other user details are passed through HTTP.

Efficient Polling with the Changes-Since Parameter

--------------------------------------------------

* Effectively limit support of the changes-since parameter in **List Servers**

  and **List Images**.

* Assume that garbage collection of deleted servers will only affect servers

  deleted ``POLL_TIME`` seconds (default: 3600) in the past or earlier. Else

  loose the information of a server getting deleted.

* Images do not support a deleted state, so deletions cannot be tracked.

Limitations

-----------

* Version MIME type and vesionless requests are not currently supported.

* Cyclades only supports JSON Requests and JSON/XML Responses. XML Requests are

  currently not supported.

* Optional content compression support is currently not supported.

* To prevent abuse, HTTP sessions have a timeout of 20 seconds before being

  closed.

* Full URI references and ``self`` and ``bookmark`` links are not supported.

* Pagination is currently not supported.

* Cached responses are currently not supported.

* Limits are currently not supported.

* Extensions are currently not supported.

API Operations

==============

.. rubric:: Servers

================================================== ========================================= ====== ======== ==========

Description                                        URI                                       Method Cyclades OS/Compute

================================================== ========================================= ====== ======== ==========

`List <#list-servers>`_                            ``/servers``                              GET    ✔        ✔

\                                                  ``/servers/detail``                       GET    ✔        ✔

`Create <#create-server>`_                         ``/servers``                              POST   ✔        ✔

`Get Stats <#get-server-stats>`_                   ``/servers/<server-id>/stats``            GET    ✔        **✘**

`Get Diagnostics <#get-server-diagnostics>`_       ``/servers/<server-id>/diagnostics``      GET    ✔        **✘**

`Get Details <#get-server-details>`_               ``/servers/<server id>``                  GET    ✔        ✔

`Rename <#rename-server>`_                         ``/servers/<server id>``                  PUT    ✔        ✔

`Delete <#delete-server>`_                         ``/servers/<server id>``                  DELETE ✔        ✔

`List Addresses <#list-server-addresses>`_         ``/servers/<server id>/ips``              GET    ✔        ✔

`Get NICs by Net <#get-server-nics-by-network>`_   ``/servers/<server id>/ips/<network id>`` GET    ✔        ✔

`List Metadata <#list-server-metadata>`_           ``/servers/<server-id>/metadata``         GET    ✔        ✔

`Update Metadata <#set-update-server-metadata>`_   ``/servers/<server-id>/metadata``         PUT    **✘**    ✔

\                                                  ``/servers/<server-id>/metadata``         POST   ✔        ✔

`Get Meta Item <#get-server-metadata-item>`_       ``/servers/<server-id>/metadata/<key>``   GET    ✔        ✔

`Update Meta Item <#update-server-metadata-item>`_ ``/servers/<server-id>/metadata/<key>``   PUT    ✔        ✔

`Delete Meta Item <#delete-server-metadata>`_      ``/servers/<server-id>/metadata/<key>``   DELETE ✔        ✔

`Actions <#server-actions>`_                       ``servers/<server id>/action``            POST   ✔        ✔

================================================== ========================================= ====== ======== ==========

.. rubric:: Flavors

==================================== ======================== ====== ======== ==========

Description                          URI                      Method Cyclades OS/Compute

==================================== ======================== ====== ======== ==========

`List <#list-flavors>`_              ``/flavors``             GET    ✔        ✔

\                                    ``/flavors/detail``      GET    ✔        **✘**

`Get details <#get-flavor-details>`_ ``/flavors/<flavor-id>`` GET    ✔        ✔

==================================== ======================== ====== ======== ==========

.. rubric:: Images

=========================================== ===================================== ====== ======== ==========

Description                                 URI                                   Method Cyclades OS/Compute

=========================================== ===================================== ====== ======== ==========

`List <#list-images>`_                      ``/images``                           GET    ✔        ✔

\                                           ``/images/detail``                    GET    ✔        ✔

`Get details <#get-image-details>`_         ``/images/<image-id>``                GET    ✔        ✔

`Delete <#delete-image>`_                   ``/images/<image id>``                DELETE ✔        ✔

`List Metadata <#list-image-metadata>`_     ``/images/<image-id>/metadata``       GET    ✔        ✔

`Update Metadata <#update-image-metadata>`_ ``/images/<image-id>/metadata``       POST   ✔        ✔

\                                           ``/images/<image-id>/metadata``       PUT    **✘**    ✔

`Get Meta Item <#get-image-metadata>`_      ``/image/<image-id>/metadata/<key>``  GET    ✔        ✔

`Update Metadata <#update-image-metadata>`_ ``/images/<image-id>/metadata/<key>`` PUT    ✔        ✔

`Delete Metadata <#delete-image-metadata>`_ ``/images/<image-id>/metadata/<key>`` DELETE ✔        ✔

=========================================== ===================================== ====== ======== ==========

List Servers

------------

List all virtual servers owned by the user.

.. rubric:: Request

=================== ====== ======== ==========

URI                 Method Cyclades OS/Compute

=================== ====== ======== ==========

``/servers``        GET    ✔        ✔

``/servers/detail`` GET    ✔        ✔

=================== ====== ======== ==========

* Both requests return a list of servers. The first returns just ``id``,

  ``name`` and ``links``, while the second returns the full collections of

  server attributes.

|

==============  ========================= ======== ==========

Request Header  Value                     Cyclades OS/Compute

==============  ========================= ======== ==========

X-Auth-Token    User authentication token required required

==============  ========================= ======== ==========

|

================= =================================== ======== ==========

Request Parameter Value                               Cyclades OS/Compute

================= =================================== ======== ==========

json              Respond in json                     default  **✘**

xml               Respond in xml                      ✔        **✘**

changes-since     Servers delete since that timestamp ✔        ✔

image             Image reference                     **✘**    ✔

flavor            VM flavor reference                 **✘**    ✔

server            Server flavor reference             **✘**    ✔

status            Server status                       **✘**    ✔

marker            Last list last ID                   **✘**    ✔

limit             Page size                           **✘**    ✔

================= =================================== ======== ==========

* **json** and **xml** parameters are mutually exclusive. If none supported,

the response will be formated in json.

* **status** refers to the `server status <#status-ref>`_

* **changes-since** must be an ISO8601 date string

.. rubric:: Response

=========================== =====================

Return Code                 Description

=========================== =====================

200 (OK)                    Request succeeded

304 (No servers since date) Can be returned if ``changes-since`` is given

400 (Bad Request)           Invalid or malformed ``changes-since`` parameter

401 (Unauthorized)          Missing or expired user token

403 (Forbidden)             User is not allowed to perform this operation

500 (Internal Server Error) The request cannot be completed because of an

\                           internal error

503 (Service Unavailable)   The server is not currently available

=========================== =====================

|

Response body contents::

  servers: [

    {

      <server attribute>: <value>,

      ...

    }, ...

  ]

The server attributes are listed `here <#server-ref>`_

*Example List Servers: JSON (regular)*

.. code-block:: javascript

  GET https://example.org/compute/v2.0/servers

  {

    "servers": [

      {

        "links": [

          {

            "href": "https://example.org/compute/v2.0/servers/42", 

            "rel": "self"

          }, {

            "href": "https://example.org/compute/v2.0/servers/42", 

            "rel": "bookmark"

          }

        ],

        "id": "42",

        "name": "My Server",

      }, {

        "links": [

          {

            "href": "https://example.org/compute/v2.0/servers/43", 

            "rel": "self"

          }, {

            "href": "https://example.org/compute/v2.0/servers/43", 

            "rel": "bookmark"

          }

        ],

        "id": "84",

        "name": "My Server",

      }

    ]

  }

*Example List Servers: JSON (detail)*

.. code-block:: javascript

  {

    "servers": [

      {

        "addresses": [

          "2718": [

            {

              "version": 6,

              "addr": "2001:443:2dfc:1232:a810:3cf:fe9b:21ab",

              "OS-EXT-IPS:type": "fixed"

            }

          ],

          "2719": [

            {

              "version": 4,

              "addr": "192.168.1.2",

              "OS-EXT-IPS:type": "floating"

            }

          ]

        ],

        "attachments": [

            {

              "id": "18",

              "network_id": "2718",

              "mac_address": "aa:01:02:6c:34:ab",

              "firewallProfile": "DISABLED",

              "ipv4": "",

              "ipv6": "2001:443:2dfc:1232:a810:3cf:fe9b:21ab"

              "OS-EXT-IPS:type": "fixed"

            }, {

              "id": "19",

              "network_id": "2719",

              "mac_address": "aa:00:0c:6d:34:bb",

              "firewallProfile": "PROTECTED",

              "ipv4": "192.168.1.2",

              "ipv6": ""

              "OS-EXT-IPS:type": "floating"

            }

        ],

        "links": [

          {

            "href": "https://example.org/compute/v2.0/servers/42", 

            "rel": "self"

          }, {

            "href": "https://example.org/compute/v2.0/servers/42", 

            "rel": "bookmark"

          }

        ],

        "image": {

          "id": "im4g3-1d",

          "links": [

            {

              "href": "https://example.org/compute/v2.0/images/im4g3-1d", 

              "rel": "self"

            }, {

              "href": "https://example.org/compute/v2.0/images/im4g3-1d", 

              "rel": "bookmark"

            }, {

              "href": "https://example.org/image/v1.0/images/im4g3-1d", 

              "rel": "alternate"

            }

          ]

        },

        "suspended": false,

        "created': '2011-04-19T10:18:52.085737+00:00',

        "flavor": {

          "id": 1",

          "links": [

            {

              "href": "https://example.org/compute/v2.0/flavors/1", 

              "rel": "self"

            }, {

              "href": "https://example.org/compute/v2.0/flavors/1", 

              "rel": "bookmark"

            }

          ]

        },

        "id": "42",

        "security_groups": [{"name": "default"}],

        "user_id": "s0m5-u5e7-1d",

        "accessIPv4": "",

        "accessIPv6": "",

        "progress": 100,

        "config_drive": "",

        "status": "ACTIVE",

        "updated": "2011-05-29T14:07:07.037602+00:00",

        "hostId": "",

        "SNF:fqdn": "snf-42.vm.example.org",

        "key_name": null,

        "name": "My Server",

        "created": "2014-02-12T08:31:37.834542+00:00",

        "tenant_id": "s0m5-u5e7-1d",

        "SNF:port_forwarding": {},

        "SNF:task_state": "",

        "diagnostics": [

            {

                "level": "DEBUG",

                "created": "2014-02-12T08:31:37.834542+00:00",

                "source": "image-info",

                "source_date": "2014-02-12T08:32:35.929507+00:00",

                "message": "Image customization finished successfully.",

                "details": null

            }

        ],

        "metadata": {

            "os": "debian",

            "users": "root"

        }

      }, {

      {

        "addresses": [

          "2718": [

            {

              "version": 6,

              "addr": "2001:443:2dfc:1232:a810:3cf:fe9b:21cd",

              "OS-EXT-IPS:type": "fixed"

            }

          ],

          "4178": [

            {

              "version": 4,

              "addr": "192.168.1.3",

              "OS-EXT-IPS:type": "floating"

            }

          ]

        ],

        "attachments": [

            {

              "id": "36",

              "network_id": "2718",

              "mac_address": "aa:01:02:6c:34:cd",

              "firewallProfile": "DISABLED",

              "ipv4": "",

              "ipv6": "2001:443:2dfc:1232:a810:3cf:fe9b:21cd"

              "OS-EXT-IPS:type": "fixed"

            }, {

              "id": "38",

              "network_id": "4178",

              "mac_address": "aa:00:0c:6d:34:cc",

              "firewallProfile": "PROTECTED",

              "ipv4": "192.168.1.3",

              "ipv6": ""

              "OS-EXT-IPS:type": "floating"

            }

        ],

        "links": [

          {

            "href": "https://example.org/compute/v2.0/servers/84", 

            "rel": "self"

          }, {

            "href": "https://example.org/compute/v2.0/servers/84", 

            "rel": "bookmark"

          }

        ],

        "image": {

          "id": "im4g3-1d",

          "links": [

            {

              "href": "https://example.org/compute/v2.0/images/im4g3-1d", 

              "rel": "self"

            }, {

              "href": "https://example.org/compute/v2.0/images/im4g3-1d", 

              "rel": "bookmark"

            }, {

              "href": "https://example.org/image/v1.0/images/im4g3-1d", 

              "rel": "alternate"

            }

          ]

        },

        "suspended": false,

        "created': '2011-04-21T10:18:52.085737+00:00',

        "flavor": {

          "id": 3",

          "links": [

            {

              "href": "https://example.org/compute/v2.0/flavors/3", 

              "rel": "self"

            }, {

              "href": "https://example.org/compute/v2.0/flavors/3", 

              "rel": "bookmark"

            }

          ]

        },

        "id": "84",

        "security_groups": [{"name": "default"}],

        "user_id": "s0m5-u5e7-1d",

        "accessIPv4": "",

        "accessIPv6": "",

        "progress": 100,

        "config_drive": "",

        "status": "ACTIVE",

        "updated": "2011-05-30T14:07:07.037602+00:00",

        "hostId": "",

        "SNF:fqdn": "snf-84.vm.example.org",

        "key_name": null,

        "name": "My Other Server",

        "created": "2014-02-21T08:31:37.834542+00:00",

        "tenant_id": "s0m5-u5e7-1d",

        "SNF:port_forwarding": {},

        "SNF:task_state": "",

        "diagnostics": [

          {

            "level": "DEBUG",

            "created": "2014-02-21T08:31:37.834542+00:00",

            "source": "image-info",

            "source_date": "2014-02-21T08:32:35.929507+00:00",

            "message": "Image customization finished successfully.",

            "details": null

          }

        ],

        "metadata": {

          "os": "debian",

          "users": "root"

        }

      }

    ]

  }

Create Server

-------------

Create a new virtual server

.. rubric:: Request

============ ====== ======== ==========

URI          Method Cyclades OS/Compute

============ ====== ======== ==========

``/servers`` POST   ✔        ✔

============ ====== ======== ==========

|

==============  ========================= ======== ==========

Request Header  Value                     Cyclades OS/Compute

==============  ========================= ======== ==========

X-Auth-Token    User authentication token required required

Content-Type    Type or request body      required required

Content-Length  Length of request body    required required

==============  ========================= ======== ==========

*Example Request Headers*::

  X-Auth-Token:   z31uRXUn1LZy45p1r7V==

  Content-Type:   application/json

  Content-Length: 735

|

================= ===============

Request Parameter Value

================= ===============

json              Respond in json

xml               Respond in xml

================= ===============

Request body contents::

  server: {

      <server attribute>: <value>,

      ...

      personality: [

        {

          <personality attribute>: <value>,

          ...

        },

        ...

      ],

      ...

  }

=========== ==================== ======== ==========

Attributes  Description          Cyclades OS/Compute

=========== ==================== ======== ==========

name        The server name      ✔        ✔

imageRef    Image id             ✔        ✔

flavorRef   Resources flavor     ✔        ✔

personality Personality contents ✔        ✔

metadata    Custom metadata      ✔        ✔

=========== ==================== ======== ==========

* **name** can be any string

* **imageRed** and **flavorRed** should refer to existing images and hardware

  flavors accessible by the user

* **metadata** are ``key``:``value`` pairs of custom server-specific metadata.

  There are no semantic limitations.

* **personality** (optional) is a list of personality injections. A personality

  injection is a way to add a file into a virtual server while creating it.

  Each change modifies/creates a file on the virtual server. The injected data

  (``contents``) should not exceed 10240 *bytes* in size and must be base64

  encoded. The file mode should be a number, not a string. A personality

  injection contains the following attributes:

====================== =================== ======== ==========

Personality Attributes Description         Cyclades OS/Compute

====================== =================== ======== ==========

path                   File path on server ✔        ✔

contents               Data to inject      ✔        ✔

group                  User group          ✔        **✘**

mode                   File access mode    ✔        **✘**

owner                  File owner          ✔        **✘**

====================== =================== ======== ==========

*Example Create Server Request: JSON*

.. code-block:: javascript

  {

    "server": {

      "name": "My Server Name: Example Name",

      "imageRef": "da7a211f-...-f901ce81a3e6",

      "flavorRef": 289,

      "personality": [

        {

          "path": "/Users/myusername/personlities/example1.file",

          "contents": "some data to inject",

          "group": "remotely-set user group",

          "mode": 0600,

          "owner": "ausername"

        }, {

          "path": "/Users/myusername/personlities/example2.file",

          "contents": "some more data to inject",

          "group": "",

          "mode": 0777,

          "owner": "anotherusername"

        }

      ],

      "metadata": {

        "EloquentDescription": "Example server with personality",

        "ShortDescription": "Trying VMs"

      }

    }

  }

.. rubric:: Response

=========================== =====================

Return Code                 Description

=========================== =====================

200 (OK)                    Request succeeded

400 (Bad Request)           Malformed request data

401 (Unauthorized)          Missing or expired user token

403 (Forbidden)             User is not allowed to perform this operation

404 (Not Found)             Image or Flavor not found

413 (Over Limit)            Exceeded some resource limit (#VMs, personality

size, etc.)

415 (Bad Media Type)        

500 (Internal Server Error) The request cannot be completed because of an

\                           internal error

503 (Service Unavailable)   No available backends or service currently

\                           unavailable

=========================== =====================

|

Response body contents::

  server: {

    <server attribute>: <value>,

    ...

  }

Server attributes are `listed here <#server-ref>`_.

*Example Create Server Response: JSON*

.. code-block:: javascript

  {

    "server": {

      "addresses": 

      "id": 28130,

        "links": [

            {

                "href": "https://example.org/compute/v2.0/servers/42", 

                "rel": "self"

            }, 

            {

                "href": "https://example.org/compute/v2.0/servers/42", 

                "rel": "bookmark"

            }

        ],

      "image": {

        "id": im4g3-1d

        "links": [

            {

                "href": "https://example.org/compute/v2.0/images/im4g3-1d"

                "rel": "self"

            }, {

                "href": "https://example.org/compute/v2.0/images/im4g3-1d"

                "rel": "bookmark"

            }, {

                "href": "https://example.org/image/v1.0/images/im4g3-1d"

                "rel": "alternate"

            }

        ]

      },

      "flavor": {

        "id": 289

        "links": [

            {

                "href": "https://example.org/compute/v2.0/flavors/289"

                "rel": "self"

            }, {

                "href": "https://example.org/compute/v2.0/flavors/289"

                "rel": "bookmark"

            }

        ]

      },

      "status": "BUILD",

      "updated": "2013-04-10T13:52:18.140686+00:00",

      "hostId": "",

      "name": "My Server Name: Example Name",

      "created": "2013-04-10T13:52:17.085402+00:00",

      "adminPass": "fKCqlZe2at",

      "suspended": false,

      "progress": 0

      "metadata": {

        "EloquentDescription": "Example server with personality",

        "ShortDescription": "Trying VMs"

      }

    }

  }

*Example Create Server Response: XML*

.. code-block:: xml

  <?xml version="1.0" encoding="UTF-8"?>

  <server xmlns="http://docs.openstack.org/compute/api/v1.1"\

    xmlns:atom="http://www.w3.org/2005/Atom"

    id="1"

    status="BUILD"

    hostId="",

    name="My Server Name: Example Name"

    created="2013-04-10T13:52:17.085402+00:00"

    adminPass="fKCqlZe2at"

    suspended="false"

    progress="0"

    ...

  />

Get Server Stats

----------------

.. note:: This operation is not part of OS/Compute v2.

This operation returns URLs of graphs showing CPU and Network statistics.

.. rubric:: Request

============================== ====== ======== ==========

URI                            Method Cyclades OS/Compute

============================== ====== ======== ==========

``/servers/<server-id>/stats`` GET    ✔        **✘**

============================== ====== ======== ==========

* **server-id** is the identifier of the virtual server

|

==============  ========================= ======== ==========

Request Header  Value                     Cyclades OS/Compute

==============  ========================= ======== ==========

X-Auth-Token    User authentication token required required

==============  ========================= ======== ==========

|

================= ===============

Request Parameter Value          

================= ===============

json              Respond in json

xml               Respond in xml 

================= ===============

* **json** and **xml** parameters are mutually exclusive. If none supported,

the response will be formated in json.

.. note:: Request body should be empty

.. rubric:: Response

=========================== =====================

Return Code                 Description

=========================== =====================

200 (OK)                    Request succeeded

400 (Bad Request)           Invalid server ID or Server deleted

401 (Unauthorized)          Missing or expired user token

403 (Forbidden)             Administratively suspended server

404 (Not Found)             Server not found

500 (Internal Server Error) The request cannot be completed because of an

\                           internal error

503 (Service Unavailable)   The server is not currently available

=========================== =====================

|

Response body contents::

  stats: {<parameter>: <value> }

============= ======================

Parameter     Description

============= ======================

serverRef     Server ID

refresh       Refresh frequency

cpuBar        Latest CPU load graph URL

cpuTimeSeries CPU load / time graph URL

netBar        Latest Network load graph URL

netTimeSeries Network load / time graph URL

============= ======================

* **refresh** is the recommended sampling rate

*Example Get Server Stats Response: JSON*

.. code-block:: javascript

  {

    "stats": {

      "serverRef": 1,

      "refresh": 60,

      "cpuBar": "http://stats.okeanos.grnet.gr/b9a...048c/cpu-bar.png",

      "cpuTimeSeries": "http://stats.okeanos.grnet.gr/b9a...048c/cpu-ts.png",

      "netBar": "http://stats.okeanos.grnet.gr/b9a...048c/net-bar.png",

      "netTimeSeries": "http://stats.okeanos.grnet.gr/b9a...048c/net-ts.png"

    }

  }

*Example Get Network Details Response: XML*

.. code-block:: xml

  <?xml version="1.0" encoding="UTF-8"?>

  <stats xmlns="http://docs.openstack.org/compute/api/v1.1"\

    xmlns:atom="http://www.w3.org/2005/Atom"

    serverRef="1"

    refresh="60"

    cpuBar="https://www.example.org/stats/snf-42/cpu-bar/",

    netTimeSeries="https://example.org/stats/snf-42/net-ts/",

    netBar="https://example.org/stats/snf-42/net-bar/",

    cpuTimeSeries="https://www.example.org/stats/snf-42/cpu-ts/"

  </stats>

Get Server Diagnostics

----------------------

.. note:: This operation is not part of OS/Compute v2.

This operation returns diagnostic information (logs) for a server.

.. rubric:: Request

==================================== ====== ======== ==========

URI                                  Method Cyclades OS/Compute

==================================== ====== ======== ==========

``/servers/<server-id>/diagnostics`` GET    ✔        **✘**

==================================== ====== ======== ==========

* **server-id** is the identifier of the virtual server

|

==============  ========================= ======== ==========

Request Header  Value                     Cyclades OS/Compute

==============  ========================= ======== ==========

X-Auth-Token    User authentication token required required

==============  ========================= ======== ==========

.. note:: Request parameters should be empty

.. note:: Request body should be empty

.. rubric:: Response

=========================== =====================

Return Code                 Description

=========================== =====================

200 (OK)                    Request succeeded

400 (Bad Request)           Invalid server ID or Server deleted

401 (Unauthorized)          Missing or expired user token

403 (Forbidden)             Administratively suspended server

404 (Not Found)             Server not found

500 (Internal Server Error) The request cannot be completed because of an

\                           internal error

503 (Service Unavailable)   The server is not currently available

=========================== =====================

|

Response body contents::

  [

    {

      <diagnostic attribute}: <value>,

      ...

    }, {

      <diagnostic attribute}: <value>,

      ...

    },

    ...

  ]

==================== ===========

Diagnostic attribute Description

==================== ===========

level                Debug level

created              Log entry timestamp

source               Log source proccess

source_date          Log source date

message              Log description

details              Detailed log description

==================== ===========

*Example Get Server Diagnostics Response: JSON*

.. code-block:: javascript

  [

    {

      "level": "DEBUG",

      "created": "2013-04-09T15:25:53.965144+00:00",

      "source": "image-helper-task-start",

      "source_date": "2013-04-09T15:25:53.954695+00:00",

      "message": "FixPartitionTable",

      "details": null

    }, {

      "level": "DEBUG",

      "created": "2013-04-09T15:25:46.413718+00:00",

      "source": "image-info",

      "source_date": "2013-04-09T15:25:46.404477+00:00",

      "message": "Starting customization VM...",

      "details": null

    }, {

      "level": "DEBUG",

      "created": "2013-04-09T15:25:46.207038+00:00",

      "source": "image-info",

      "source_date": "2013-04-09T15:25:46.197183+00:00",

      "message": "Image copy finished.",

      "details": "All operations finished as they should. No errors reported."

    }

  ]

Get Server Details

------------------

This operation returns detailed information for a virtual server

.. rubric:: Request

======================== ====== ======== ==========

URI                      Method Cyclades OS/Compute

======================== ====== ======== ==========

``/servers/<server id>`` GET    ✔        ✔

======================== ====== ======== ==========

* **server-id** is the identifier of the virtual server

|

==============  ========================= ======== ==========

Request Header  Value                     Cyclades OS/Compute

==============  ========================= ======== ==========

X-Auth-Token    User authentication token required required

==============  ========================= ======== ==========

.. note:: Request parameters should be empty

.. note:: Request body should be empty

.. rubric:: Response

=========================== =====================

Return Code                 Description

=========================== =====================

200 (OK)                    Request succeeded

400 (Bad Request)           Malformed server id

401 (Unauthorized)          Missing or expired user token

403 (Forbidden)             Administratively suspended server

404 (Not Found)             Server not found

500 (Internal Server Error) The request cannot be completed because of an

\                           internal error

503 (Service Unavailable)   No available backends or service currently

\                           unavailable

=========================== =====================

|

Response body contents::

  server: {

    <server attribute>: <value>,

    ...

  }

================= ====================== ======== ==========

Server Attributes Description            Cyclades OS/Compute

================= ====================== ======== ==========

id                The server id          ✔        ✔

name              The server name        ✔        ✔

hostId            Server playground      empty    ✔

created           Creation date          ✔        ✔

updated           Creation date          ✔        ✔

flavor            The flavor id          ✔        ✔

image             The image id           ✔        ✔

progress          Build progress         ✔        ✔

status            Server status          ✔        ✔

suspended         If server is suspended ✔        **✘**