gns3-server/docs/api/v2/compute/virtualbox/projectsprojectidvirtualboxnodesnodeid.rst
2016-05-12 10:39:50 +02:00

8.7 KiB

/v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}

GET /v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}

Get a VirtualBox VM instance

Parameters

  • node_id: UUID for the instance
  • project_id: UUID for the project

Response status codes

  • 200: Success
  • 400: Invalid request
  • 404: Instance doesn't exist

Output

Name Mandatory Type Description
acpi_shutdown boolean ACPI shutdown
adapter_type string VirtualBox adapter type
adapters integer number of adapters
console integer console TCP port
enable_remote_console boolean enable the remote console
headless boolean headless mode
name string VirtualBox VM instance name
node_id string VirtualBox VM instance UUID
project_id string Project UUID
ram integer Amount of RAM
use_any_adapter boolean allow GNS3 to use any VirtualBox adapter
vm_directory ['string', 'null']
vmname string VirtualBox VM name (in VirtualBox itself)

Sample session

../../../examples/compute_get_projectsprojectidvirtualboxnodesnodeid.txt

PUT /v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}

Update a VirtualBox VM instance

Parameters

  • node_id: UUID for the instance
  • project_id: UUID for the project

Response status codes

  • 200: Instance updated
  • 400: Invalid request
  • 404: Instance doesn't exist
  • 409: Conflict

Input

Name Mandatory Type Description
acpi_shutdown boolean ACPI shutdown
adapter_type string VirtualBox adapter type
adapters integer number of adapters
console integer console TCP port
enable_remote_console boolean enable the remote console
headless boolean headless mode
name string VirtualBox VM instance name
ram integer Amount of RAM
use_any_adapter boolean allow GNS3 to use any VirtualBox adapter
vmname string VirtualBox VM name (in VirtualBox itself)

Output

Name Mandatory Type Description
acpi_shutdown boolean ACPI shutdown
adapter_type string VirtualBox adapter type
adapters integer number of adapters
console integer console TCP port
enable_remote_console boolean enable the remote console
headless boolean headless mode
name string VirtualBox VM instance name
node_id string VirtualBox VM instance UUID
project_id string Project UUID
ram integer Amount of RAM
use_any_adapter boolean allow GNS3 to use any VirtualBox adapter
vm_directory ['string', 'null']
vmname string VirtualBox VM name (in VirtualBox itself)

Sample session

../../../examples/compute_put_projectsprojectidvirtualboxnodesnodeid.txt

DELETE /v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}

Delete a VirtualBox VM instance

Parameters

  • node_id: UUID for the instance
  • project_id: UUID for the project

Response status codes

  • 400: Invalid request
  • 404: Instance doesn't exist
  • 204: Instance deleted