Machine Resource

Cloud Admin Enterprise Admin User

Contents:

Machine resource represents the attributes of a real physical machines. This entity will be queried for its resources when a new Virtual Machine is deployed.

Machine Data Model

Field Name Type Occurs Required Description
name String 1 true The name of the rack
cpu Integer 1 true The number of CPUs of the Machine. Should be bigger than 0
cpuRatio Integer 1 optional Virtual with Physical CPU relation
cpuUsed Integer 1 false The number of cpu's used currently.
description String 1 optional A brief description of the machine
hd Long 1 true the value of the Hard Disk (in bytes)
hdUsed Long 1 false The value of used Hard Disk (in bytes)
ram Integer 1 true The value of RAM (in Megas)
ramUsed Integer 1 false The value of RAM used (in Megas)
state String 1 true The state of the machine
virtualSwitch String 1 true The IP of the virtual switch for the default vlan

Methods related to Machine Resource

Retrieve a list of machines

Synopsis: GET http://example.com/api/admin/datacenters/{$datacenterId}/racks/{$rackId}/machines
Request Headers: Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Request example: Retrieve all machines for a Rack

GET Machines Request

Response Headers: Content-Length, Content-Type.
Response Message Body: A list of Machine.
Response Status: 200, 400, 401, 403.
Response example: Retrieve response

GET Machines Request
Create a new Machine

Synopsis: POST http://example.com/api/admin/datacenters/{$datacenterId}/racks/{$rackId}/machines
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: Machine.
Request example: Create new Machine

POST Machine Request

Response Headers: Content-Length, Content-Type, Location.
Response Message Body: Machine.
Response Status: 201, 400, 401, 403.
Response example: The creation response

POST Machine Response
Retrieve a Machine

Synopsis: GET http://example.com/api/admin/datacenters/{$datacenterId}/racks/{$rackId}/machines/{$machineId}
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Retrieve information about a Machine.

GET Machine Request

Response Headers: Content-Length, Content-Type.
Response Message Body: Machine.
Response Status: 200, 401, 403.
Example Response: Response of the GET over a Machine

GET Machine Response
Update an existing Machine

Synopsis: PUT http://example.com/api/admin/datacenters/{$datacenterId}/racks/{$rackId}/machines/{$machineId}
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: Machine.
Example Request: Update Machine entity.

PUT Machine Request

Response Headers: Content-Length, Content-Type.
Response Message Body: N/A.
Response Status: 200, 400, 401, 403.

PUT Machine Response
Delete a Machine

Synopsis: DELETE http://example.com/api/admin/datacenters/{$datacenterId}/racks/{$rackId}/machines/{$machineId}
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Delete Machine entity.

DELETE Machine Request

Response Headers: Content-Length, Content-Type.
Response Message Body: N/A.
Response Status: 200, 401, 403, 409
Example Response: Response of the deletion

DELETE Machine Response
Create a machine with its hypervisor.
New Feature
This feature has been available since version 1.6.8

If the machine include an element hypervisor it's created in the same request.
Synopsis: POST http://example.com/api/admin/datacenters/{$datacenterId}/racks/{$rackId}/machines
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: Machine.
Request example: Create new Machine

POST Machine Request

Response Headers: Content-Length, Content-Type, Location.
Response Message Body: Machine.
Response Status: 201, 400, 401, 403.
Response example: The creation response

POST Machine Response
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Sep 03, 2011

    Anonymous says:

    This is the perfect way to break down this inofrmtaion.

    This is the perfect way to break down this inofrmtaion.

  2. Sep 03, 2011

    Anonymous says:

    lQRWnX <a href="http://uloppikdbnye.com/">uloppikdbnye</a>

    lQRWnX <a href="http://uloppikdbnye.com/">uloppikdbnye</a>

  3. Sep 04, 2011

    Anonymous says:

    9DA6ji , [url=http://bkqoigpvkpem.com/]bkqoigpvkpem[/url], [...

    9DA6ji , [url=http://bkqoigpvkpem.com/]bkqoigpvkpem[/url], [link=http://uligwlmeuheb.com/]uligwlmeuheb[/link], http://spxqqqqaospc.com/

  4. Sep 06, 2011

    Anonymous says:

    ySAygB , [url=http://cjvucgrkhbuy.com/]cjvucgrkhbuy[/url], [...

    ySAygB , [url=http://cjvucgrkhbuy.com/]cjvucgrkhbuy[/url], [link=http://sijyvvywxgdj.com/]sijyvvywxgdj[/link], http://ewmpydmllglq.com/