ServerSnapshotCreate - Revision history

Mike.robski: 1 revision: Release 86

2013-10-11T17:00:55Z

1 revision: Release 86

Emanuela.mitreva: /* Response Codes */

2013-07-12T12:03:20Z

Response Codes

Mike.robski: 1 revision

2013-05-24T15:24:59Z

1 revision

Mike.robski at 14:54, 20 May 2013

2013-05-20T14:54:20Z

Mike.robski at 13:17, 20 May 2013

2013-05-20T13:17:03Z

Administrator: /* POST /servers/server_id/snapshots */

2013-04-13T01:29:17Z

POST /servers/server_id/snapshots

Administrator: Created page with "This operation will create a new server snapshot of a server. Server snapshot creation is asynchronous, the progress can be checked with the URL in the response Location heade..."

2013-04-13T00:37:39Z

Created page with "This operation will create a new server snapshot of a server. Server snapshot creation is asynchronous, the progress can be checked with the URL in the response Location heade..."

New page

This operation will create a new server snapshot of a server. Server snapshot 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/'''server_id'''/snapshots=
This operation will create a new server snapshot. Server snapshot creation is asynchronous, the progress can be checked with the URL in the response Location header or the self link in the body.

== Parameters ==
; server_id
: The unique identifier of the server.

=== JSON ===
<nowiki>
{
"snapshot": {
"name": "{name}",
"description": "{description}"
}
}</nowiki>

; name - ''string''
: Display name for this server snapshot

; description - ''string''
: Description for this server snapshot

== Result ==
=== JSON ===
<nowiki>
{
"snapshot": {
"id": "{snapshot_id}",
"name": "{snapshot_name}"
"description": "{description}",
"status": "{status}",
"guid": "{guid}",
"parent_guid": "{parent_guid}",
"relation_guid": "{relation_guid}",
"create_time": "{create_time}",
"links": [{"href": "http://{api_server}/servers/{server_id}/snapshots/{snapshot_id}/",
"rel": "self"}],
}
}
</nowiki>
* When a server snapshot is in pending status (has not completed the provisioning process), the create_time, guid, parent_guid, and relation_guid will be empty strings.
; id - ''string''
: Unique identifier for this server snapshot.

; name - ''string''
: Display name of this server snapshot.

; description - ''string''
: Description of this server snapshot.

; guid - ''string''
: GUID of this server snapshot.

; parent_guid - ''string''
: Parent GUID of this server snapshot.

; relation_guid - ''string''
: Relation GUID of this server snapshot.

; status - ''string''
: Status of this server snapshot; Values: 'ACTIVE', 'BUILD', 'DELETED'

; create_time - ''string''
: Created time of this server snapshot

; links - ''array''
: [[Hypermedia]] for this resource.

== Response Codes ==
; Success:
:''HTTP/1.1 202 Accepted''
::Request is accepted.

; Failure:
:''HTTP/1.1 400 Bad Request''
::The snapshot cannot be created because the server contains extra volumes.

:''HTTP/1.1 409 Conflict''
::The snapshot name must be unique in a server.

:''HTTP/1.1 413 Request entity too large''
::The snapshot can be created up to 3 in a server.

== Examples ==
'''Successfully create a new server'''
:'''POST''' <nowiki>http://{api_server}/servers/{server_id}/snapshots</nowiki>

''Request Headers:''
Content-Type:application/json
Charset=UTF-8
Authorization:Base64-encoded username & password string

''Request Body:''
<nowiki>
{
"snapshot": {
"name": "fitnesse snapshot",
"description": "fitnesse test snapshot"
}
}</nowiki>

''Response Code:''
<pre>HTTP/1.1 202 Accepted</pre>

''Response Body:''
<nowiki>
{
"snapshot": {
"id": "snapshot_jello614636-USOTE-0214_2012Jul19_m5yf9Bz8a",
"name": "test snapshot"
"description": "test snapshot description",
"status": "BUILD",
"guid": "",
"parent_guid": "",
"relation_guid": "",
"create_time": "0000-00-00 00:00:00",
"links": [
{"href": "http://{api_server}/servers/{server_id}/snapshots/snapshot_jello614636-USOTE-0214_2012Jul19_m5yf9Bz8a/",
"rel": "self"}],
}
}</nowiki>



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

@@ Line 2: / Line 2: @@
 ='''POST''' /servers/'''server_id'''/snapshots=
 == Parameters ==
@@ Line 124: / Line 123: @@
 }</nowiki>
 [[Category:Hostway API]]
 [[Category:FlexCloud Server API]]

@@ Line 2: / Line 2: @@
 ='''POST''' /servers/'''server_id'''/snapshots=
 == Parameters ==
@@ Line 123: / Line 124: @@
 }</nowiki>
 [[Category:Hostway API]]
 [[Category:FlexCloud Server API]]

← Older revision		Revision as of 01:29, 13 April 2013
Line 2:		Line 2:

	='''POST''' /servers/'''server_id'''/snapshots=		='''POST''' /servers/'''server_id'''/snapshots=
−	~~This operation will create a new server snapshot. Server snapshot creation is asynchronous, the progress can be checked with the URL in the response Location header or the self link in the body.~~

	== Parameters ==		== Parameters ==

@@ Line 1: / Line 1: @@
 This operation will create a new server snapshot of a server. Server snapshot 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/'''server_id'''/snapshots=
+='''POST''' /accounts/''{accountId}''/flexcloud/servers/''{server_id}''/snapshots=
 == Parameters ==
 ; server_id
 : The unique identifier of the server.
@@ Line 35: / Line 39: @@
          "relation_guid": "{relation_guid}",
          "create_time": "{create_time}",
-         "links": [{"href": "http://{api_server}/servers/{server_id}/snapshots/{snapshot_id}/",
+         "links": [{"href": "http://{api_server}/accounts/{accountId}/flexcloud/servers/{server_id}/snapshots/{snapshot_id}/",
                     "rel": "self"}],
+     }
@@ Line 76: / Line 80: @@
 :''HTTP/1.1 400 Bad Request''
 ::The snapshot cannot be created because the server contains extra volumes.
 :''HTTP/1.1 409 Conflict''
@@ Line 81: / Line 88: @@
 :''HTTP/1.1 413 Request entity too large''
 ::The snapshot can be created up to 3 in a server.
-−
 == Examples ==
 '''Successfully create a new server'''
-:'''POST''' <nowiki>http://{api_server}/servers/{server_id}/snapshots</nowiki>
+:'''POST''' <nowiki>http://{api_server}/accounts/{accountId}/flexcloud/servers/{server_id}/snapshots</nowiki>
 ''Request Headers:''
@@ Line 118: / Line 124: @@
          "create_time": "0000-00-00 00:00:00",
          "links": [
-             {"href": "http://{api_server}/servers/{server_id}/snapshots/snapshot_jello614636-USOTE-0214_2012Jul19_m5yf9Bz8a/",
+             {"href": "http://{api_server}/accounts/{accountId}/flexcloud/servers/{server_id}/snapshots/snapshot_jello614636-USOTE-0214_2012Jul19_m5yf9Bz8a/",
               "rel": "self"}],
+     }
 }</nowiki>
-{{disqus}}
+'''Failure while trying to update server with a wrong account number'''
 [[Category:Hostway API]]
 [[Category:FlexCloud Server API]]

@@ Line 123: / Line 123: @@
 }</nowiki>
+{{disqus}}
-<!--  THIS CODE ENABLES DISQUS COMMENTS ON THE PAGE - DELETE TO DISABLE COMMENTING-->
+[[Category:Hostway API]]
+[[Category:FlexCloud Server API]]
-{{#widget:DISQUS
-|id=hostway
-|uniqid={{PAGENAME}}
-|url={{fullurl:{{PAGENAME}}}}
-}}
-−
-<!--  ########################################################################### -->