PUT /api/hosts/:id
Update a host.

Examples

PUT /api/hosts/temp.yourdomain.net
{
  "host": {}
}
200
{
  "host": {
    "sp_name": "",
    "sp_ip": "",
    "serial": null,
    "name": "temp.yourdomain.net",
    "installed_at": null,
    "image_file": "",
    "last_report": null,
    "enabled": true,
    "sp_mac": "",
    "puppet_ca_proxy_id": null,
    "medium_id": 980190962,
    "ip": "2.3.4.5",
    "id": 298486374,
    "certname": "temp.yourdomain.net",
    "uuid": null,
    "use_image": null,
    "updated_at": "2012-12-18T15:24:48Z",
    "root_pass": "xybxa6JUkz63w",
    "model_id": null,
    "mac": "aa:bb:cc:dd:ee:ff",
    "last_compile": null,
    "comment": null,
    "owner_id": 886836129,
    "operatingsystem_id": 309172073,
    "location_id": null,
    "organization_id": null,
    "environment_id": 334344675,
    "build": false,
    "subnet_id": 980190962,
    "sp_subnet_id": null,
    "hostgroup_id": null,
    "environment": {
      "environment": {
        "name": "production",
        "id": 334344675
      }
    },
    "domain_id": 589326610,
    "source_file_id": null,
    "puppet_proxy_id": 182953976,
    "ptable_id": 980190962,
    "owner_type": "User",
    "puppet_status": 0,
    "disk": null,
    "created_at": "2012-12-18T15:24:43Z",
    "managed": null,
    "last_freshcheck": null,
    "image_id": null,
    "compute_resource_id": 980190962,
    "architecture_id": 501905019
  }
}

Params

Param name Description
id
required
Value: Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.
host
required
Value: Must be a Hash
host[name]
optional
Value: Must be String
host[environment_id]
optional
Value: Must be String
host[ip]
optional

not required if using a subnet with dhcp proxy


Value: Must be String
host[mac]
optional

not required if its a virtual machine


Value: Must be String
host[architecture_id]
optional
Value: Must be a number.
host[domain_id]
optional
Value: Must be a number.
host[puppet_proxy_id]
optional
Value: Must be a number.
host[operatingsystem_id]
optional
Value: Must be String
host[medium_id]
optional
Value: Must be a number.
host[ptable_id]
optional
Value: Must be a number.
host[subnet_id]
optional
Value: Must be a number.
host[sp_subnet_id]
optional
Value: Must be a number.
host[model_id_id]
optional
Value: Must be a number.
host[hostgroup_id]
optional
Value: Must be a number.
host[owner_id]
optional
Value: Must be a number.
host[puppet_ca_proxy_id]
optional
Value: Must be a number.
host[image_id]
optional
Value: Must be a number.
host[host_parameters_attributes]
optional
Value: Must be Array