3.26.3. Update host

Method	URI	Description
PUT	`/v2/{tenant_id}/os-hosts/{host_name}`	Enables a host or puts it in maintenance mode.

Normal response codes: 200

This table shows the URI parameters for the update host request:

Name	Type	Description
`{tenant_id}`	String	The ID for the tenant or account in a multi-tenancy cloud.
`{host_name}`	String	The name of the host of interest to you.

Example 3.219. Update host: JSON request

{
    "status": "enable",
    "maintenance_mode": "disable"
}

Example 3.220. Update host: XML request

<?xml version="1.0" encoding="UTF-8" ?>
<updates>
    <status>enable</status>
    <maintenance_mode>disable</maintenance_mode>
</updates>

This operation does not require a request body.

Example 3.221. Update host: JSON response

{
    "host": "0738dca90a8c43fdadd0be28715520e2",
    "maintenance_mode": "off_maintenance",
    "status": "enabled"
}

Example 3.222. Update host: XML response

<?xml version='1.0' encoding='UTF-8'?>
<host status="enabled" maintenance_mode="off_maintenance" host="d85f05519b57457c83da18c39fa8e00d"/>

This operation does not return a response body.