5.97. 主机

此服务管理主机。

表 5.303. 方法概述
名称	概述
`add`	创建新主机。
`list`	获取所有可用主机的列表。

创建新主机。

主机基于 host 参数的属性创建。name、address 和 root_password 属性是必需的。

例如，要添加主机发送以下请求：

POST /ovirt-engine/api/hosts

使用以下请求正文：

<host>
  <name>myhost</name>
  <address>myhost.example.com</address>
  <root_password>myrootpassword</root_password>
</host>

注意

root_password 元素仅包含在客户端提供的初始表示中，它不在从后续请求返回的表示中公开。

要添加托管引擎主机，请使用可选的 deploy_hosted_engine 参数：

POST /ovirt-engine/api/hosts?deploy_hosted_engine=true

表 5.304. 参数概述
名称	类型	方向	概述
`deploy_hosted_engine`	布尔值	In	当设置为 `true` 时，这意味着此主机应部署也应该部署托管引擎组件。
`主机`	主机	in/Out	从中用于创建新主机的主机定义作为参数传递，并且返回新创建的主机。
`undeploy_hosted_engine`	布尔值	In	当设置为 `true` 时，这意味着此主机应该未部署托管引擎组件，此主机将作为高可用性集群的一部分无法正常工作。

当设置为 true 时，这意味着此主机应部署也应该部署托管引擎组件。缺少的值被视为 true i.e deploy。省略此参数意味着 false，也不会在托管引擎区中执行操作。

当设置为 true 时，这意味着此主机应该未部署托管引擎组件，此主机将作为高可用性集群的一部分无法正常工作。缺少的值被视为 true，即 un-deploy。省略此参数意味着 false，也不会在托管引擎区中执行操作。