2.3. Updating Instances

PUT /instances/{instance_id}

Updates the specified attributes of the specified instance. The supported attributes are: user_id, project_id, backup_limit, backup_mode, and name. Changing instance’s project and user IDs reassigns it to the specified user.

Available only to admins.

Request example:

# curl -s -X PUT -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' -d '
{
    "project_id": "",
    "user_id": ""
}
' https://<controller_hostname>/api/v1/instances/f50fffca-e83d-44d1-857e-944c6e2eee00

Response example:

{
  "user_id": "117888d5a0db48508447fd44cae57a62",
  "uuid": "61c88513-8e3e-4d6b-8c6e-5e0cd973fc15",
  "config": {
    "memory": "512",
    "vnc-encrypted": "False",
    "tools-state": "possibly_installed",
    "vnc-port": "0",
    "is_attach_limited": "0",
    "hostname": "",
    "storage": "10240",
    "vnc-status": "False",
    "tools-version": "",
    "vnc-key": "",
    "cpu": "8",
    "os-name": "CentOS Linux"
  },
  "image": "centos-7",
  "host": "ppnode1.local.site",
  "sdk_name": "ct2",
  "ips": [],
  "state": "running",
  "backup_limit": 3,
  "backup_mode": "always_full",
  "project_id": "ea2dbb0a4dda4430b7211e714736b13b",
  "type": "ct",
  "name": "ve-61c88513-8e3e-4d6b-8c6e-5e0cd973fc15"
}