ServerActionResize

From Hostway API Documentation
(Difference between revisions)
Jump to: navigation, search
(Created page with "Changes the Flavor of a server. '''POST''' /servers/'''id'''/action == Parameters == ; id : The unique identifier of the image to be retrieved. ''Note see warnings in [[...")
 
m (1 revision: Release 86)
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Changes the [[Flavor]] of a server.
+
The resize action changes the [[Flavor]] of a [[Server]].
  
'''POST''' /servers/'''id'''/action
+
='''POST''' /accounts/''{accountId}''/flexcloud/servers/''{id}''/action=
  
 
== Parameters ==
 
== Parameters ==
 +
; accountId - ''string''
 +
: The selected account Id.
 +
 
; id
 
; id
: The unique identifier of the image to be retrieved. ''Note see warnings in [[Hypermedia]]''.
+
: The unique identifier of the server to be resized.
  
 +
== Request==
 
=== JSON ===
 
=== JSON ===
  <nowiki>
+
  {
{
+
    "resize" :
  "resize":{
+
      {
      "flavor":{
+
          "flavor":
        "id":"4"
+
            {
      }
+
                "id":"{flavor_id}"
  }
+
            }
}
+
      }
</nowiki>
+
}
  
 
; id - ''string''
 
; id - ''string''
: The id of the flavor to to use. Why is this not a flavorRef with an absolute URL?
+
: The id of the flavor to use.
 +
 
 +
== Response Codes ==
 +
; Success:
 +
: ''HTTP/1.1 202 Accepted'' : The request is accepted for processing.
  
== Result ==
+
; Failure:
 +
: ''HTTP/1.1 400 Bad Request'' : Server already uses this flavor.
 +
: ''HTTP/1.1 401 Unauthorized'' : This server could not verify that you are authorized to access the document you requested.  Either you supplied the wrong credentials (e.g., bad password), or your browser does not understand how to supply the credentials required.
 +
: ''HTTP/1.1 403 Forbidden'' : This server cannot be resized.
 +
: ''HTTP/1.1 404 Not Found'' : The resource requested is not found.
 +
: ''HTTP/1.1 405 Method Not Allowed'' : The requested action is not supported.
 +
: ''HTTP/1.1 500 Internal Server Error'' : Unknown error was raised while processing your request.
 +
: ''HTTP/1.1 503 Service Unavailable'' : Selected profile is unavailable.
  
<!--  THIS CODE ENABLES DISQUS COMMENTS ON THE PAGE - DELETE TO DISABLE COMMENTING-->
+
== Alternative URI /servers/{id}/action ==
 +
An alternative way to execute this call is to omit the ''accountId'' portion of the URI. In this case the system assumes the request is executed for the account identified in the [[Authentication|authorization header]].
  
{{#widget:DISQUS
+
<code>POST /servers/{id}/action</code>
|id=hostway
+
|uniqid={{PAGENAME}}
+
|url={{fullurl:{{PAGENAME}}}}
+
}}
+
  
<!--  ########################################################################### -->
+
[[Category:Hostway API]]
 +
[[Category:FlexCloud Server API]]

Latest revision as of 11:00, 11 October 2013

The resize action changes the Flavor of a Server.

Contents

[edit] POST /accounts/{accountId}/flexcloud/servers/{id}/action

[edit] Parameters

accountId - string
The selected account Id.
id
The unique identifier of the server to be resized.

[edit] Request

[edit] JSON

{
   "resize" :
      {
         "flavor":
            {
               "id":"{flavor_id}"
            }
      }
}
id - string
The id of the flavor to use.

[edit] Response Codes

Success
HTTP/1.1 202 Accepted : The request is accepted for processing.
Failure
HTTP/1.1 400 Bad Request : Server already uses this flavor.
HTTP/1.1 401 Unauthorized : This server could not verify that you are authorized to access the document you requested. Either you supplied the wrong credentials (e.g., bad password), or your browser does not understand how to supply the credentials required.
HTTP/1.1 403 Forbidden : This server cannot be resized.
HTTP/1.1 404 Not Found : The resource requested is not found.
HTTP/1.1 405 Method Not Allowed : The requested action is not supported.
HTTP/1.1 500 Internal Server Error : Unknown error was raised while processing your request.
HTTP/1.1 503 Service Unavailable : Selected profile is unavailable.

[edit] Alternative URI /servers/{id}/action

An alternative way to execute this call is to omit the accountId portion of the URI. In this case the system assumes the request is executed for the account identified in the authorization header.

POST /servers/{id}/action

Personal tools
Namespaces
Variants
Actions
APIs
Navigation
Toolbox