ServerCreate

Revision as of 13:40, 2 February 2012

This operation will create a new server. The server creation is asynchronous, the progress can be checked with the URL in the response Location header or the self link in the body.

POST /servers

Parameters

JSON

{
   "server":{
      "name":"new-server-test",
      "imageRef":"http://127.0.0.1:6543/images/20GB_Ubuntu%2010.10%20x64%20R1soft/",
      "flavorRef":"http://127.0.0.1:6543/flavors/3/"
}

name - string

Display name for this server

imageRef - string

Absolute URL of the Image to use

flavorRef - string

Absolute URL of the Flavor to use

Result

JSON

{
   "server":{
      "status":"ACTIVE",
      "updated":null,
      "hostId":"host012-aus01.hyperv.hostway",
      "addresses":{
         "public":[
            {
               "version":4,
               "addr":"216.185.158.89"
            }
         ],
         "private":[
            {
               "version":4,
               "addr":"172.16.2.143"
            }
         ]
      },
      "links":[
         {
            "href":"http://127.0.0.1:6543/servers/michalski275226-AUS001-0005/",
            "rel":"self"
         }
      ],
      "image":{
         "name":"Ubuntu 10.10 x64",
         "links":[
            {
               "href":"http://127.0.0.1:6543/images/20GB_Ubuntu%2010.10%20x64%20R1soft/",
               "rel":"self"
            }
         ],
         "id":"20GB_Ubuntu 10.10 x64 R1soft"
      },
      "userId":"michalski275226",
      "flavor":{
         "name":"1024MB Server3",
         "links":[
            {
               "href":"http://127.0.0.1:6543/flavors/3/",
               "rel":"self"
            }
         ],
         "id":3
      },
      "id":"michalski275226-AUS001-0005",
      "name":"michalski275226-AUS001-0005",
      "created":"2011-12-05T12:51:28",
      "tenantId":null,
      "accessIPv4":"216.185.158.89",
      "accessIPv6":null,
      "progress":100,
      "metadata":{
 
      }
   }
}

server

id - string

Unique identifier for this server.

links - list

Hypermedia for this resource.

status - string

Current state of the server. Values: BUILD, ACTIVE, SUSPENDED, DELETED, UNKNOWN

hostId - string

Id of the physical host this virtual machine is running on.

userId - string

Unique identifier for the owner of this server.

name - string

Name for this server.

created - string

The date and time this server was created. ISO 8601 format, YYYY-MM-DDTHH:MM:SS.

accessIPv4 - string

The default included public IPv4 address.

progress - number

The progress of the current this server while in the BUILD status. The value is in the range of 0 - 100, but currently will only even be 0, 50, 100.

metadata - object

Unused always an empty object.

tenantId

Unused always always null.

accessIPv6

Unused always null.

updated

Unused always null.

addresses

addresses.public.version - number

IP version of this address. Values: 4

addresses.public.addr = string

Public IP address of this server

addresses.private.version - number

IP version of this address. Values: 4

addresses.private.addr - string

Private IP address of this server

image

image.name - string

The display name of the image this server is based on.

image.links - list

Hypermedia for the image.

image.id - string

Unique identifier for image this server is based on.

flavor

flavor.name - string

The display name of the flavor this server is based on.

flavor.links - list

Hypermedia for the flavor.

flavor.id - string

Unique identifier for flavor this server is based on.