ServerActionResize

(Difference between revisions)
Jump to: navigation, search
Line 1: Line 1:
The resize function changes the [[Flavor]] of a server.
+
The resize action changes the [[Flavor]] of a [[server]].
  
'''POST''' /servers/'''id'''/action
+
='''POST''' /servers/'''id'''/action=
  
 
== Parameters ==
 
== Parameters ==
 
; 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 ===
 
<big><source lang="javascript">
 
 
  {
 
  {
 
     "resize" :
 
     "resize" :
Line 19: Line 18:
 
       }
 
       }
 
  }
 
  }
</source></big>
 
  
 +
; id - ''string''
 +
: The id of the flavor to use.
  
; id - ''string''
 
: The id is of the flavor to be used.
 
 
== Response Codes ==
 
== Response Codes ==
 
; Success:  
 
; Success:  
:''HTTP/1.1 202 Accepted''
+
: ''HTTP/1.1 202 Accepted'' : The request is accepted for processing.
:The request is accepted for processing.
+
 
 
; Failure:
 
; Failure:
:''HTTP/1.1 200 OK 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 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.
== Examples ==
+
: ''HTTP/1.1 403 Forbidden'' : This server cannot be resized.
'''Successfully resize a server'''
+
: ''HTTP/1.1 405 Method Not Allowed'' : The requested action is not supported.
:'''POST''' http(s)://{api_server}/167/action
+
: ''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.
''Request Headers:''
+
    Content-Type:application/json
+
    Charset=UTF-8
+
    Authorization:Base64-encoded username & password string
+
 
+
''Request Body:''
+
{
+
    "resize" :
+
      {
+
          "flavor":
+
            {
+
                "id":"3"
+
            }
+
      }
+
}
+
 
+
''Response Code:''
+
<pre>HTTP/1.1 202 Accepted</pre>
+
 
+
'''Unauthorized access'''
+
:'''POST''' http(s)://{api_server}/{server_id}/action
+
 
+
''Request Headers:''
+
    Content-Type:application/json
+
    Charset=UTF-8
+
    Authorization:Base64-encoded fake_authentication_string
+
 
+
''Response Code:''
+
<pre>HTTP/1.1 401 Unauthorized</pre>
+
 
+
''Response Body:''
+
    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.
+
  
 
<!--  THIS CODE ENABLES DISQUS COMMENTS ON THE PAGE - DELETE TO DISABLE COMMENTING-->
 
<!--  THIS CODE ENABLES DISQUS COMMENTS ON THE PAGE - DELETE TO DISABLE COMMENTING-->

Revision as of 15:12, 4 July 2012

The resize action changes the Flavor of a server.

Contents

POST /servers/id/action

Parameters

id
The unique identifier of the server to be resized.

Request

JSON

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

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


blog comments powered by Disqus


Personal tools
Namespaces
Variants
Actions
APIs
Navigation
Toolbox