View source

Creates a new server. The server creation is asynchronous the progress can be check with at the URL in the response Location header or the self link in the body.

'''POST''' /servers

== Parameters ==
=== JSON ===
 <nowiki>
{
   "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/"
}
</nowiki>

; 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 ===
 <nowiki>
{
   "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":{

      }
   }
}
</nowiki>

==== 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.

<!--  THIS CODE ENABLES DISQUS COMMENTS ON THE PAGE - DELETE TO DISABLE COMMENTING-->

{{#widget:DISQUS
|id=hostway
|uniqid={{PAGENAME}}
|url={{fullurl:{{PAGENAME}}}}
}}

<!--  ########################################################################### -->