6.119. 主机
管理主机的服务。
| 名称 | 概述 |
|---|---|
|
| 创建新主机. |
|
| 获取所有可用主机的列表。 |
6.119.1. 添加 POST
创建新主机.
主机基于 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 元素仅包含在客户端提供的初始表示法中，不会在从后续请求返回的表示中公开。
自引擎版本 4.1.2 起，当新添加主机时，主机防火墙定义将默认被覆盖。
要添加托管引擎主机，请使用可选的 deploy_hosted_engine 参数：
POST /ovirt-engine/api/hosts?deploy_hosted_engine=true
如果集群有一个支持自动部署的默认外部网络供应商，则在添加主机时会部署外部网络供应商。只有 OVN 的外部网络提供程序支持自动部署。要部署集群中定义的外部网络供应商，请在添加主机时覆盖外部网络供应商，请发送以下请求：
POST /ovirt-engine/api/hosts
使用一个请求正文，其中包含对 external_network_provider_configuration 中所需提供程序的引用：
<host>
<name>myhost</name>
<address>myhost.example.com</address>
<root_password>123456</root_password>
<external_network_provider_configurations>
<external_network_provider_configuration>
<external_network_provider name="ovirt-provider-ovn"/>
</external_network_provider_configuration>
</external_network_provider_configurations>
</host>| 名称 | 类型 | 方向 | 概述 |
|---|---|---|---|
|
| in |
当设置为 | |
|
| in |
当设置为 | |
|
| in/Out | 创建新主机的主机定义作为参数传递，而新创建的主机将返回。 | |
|
| in | 指明是否应当在安装成功后重新启动该主机。 | |
|
| in |
当设置为 |
6.119.1.1. 激活
当设置为 true 时，此主机将在安装完成后激活。当设置为 false 时，主机安装后将保持 维护 状态。如果没有此参数，将解释为 true，因为所需的默认行为是在安装后激活主机。
6.119.1.2. deploy_hosted_engine
当设置为 true 时，此主机将部署托管引擎组件。缺少的值被视为 true，即部署托管引擎组件。省略此参数等于 false，主机不会在托管引擎区域执行任何操作。
6.119.1.3. reboot
指明是否应当在安装成功后重新启动该主机。默认值为 true。
6.119.1.4. undeploy_hosted_engine
当设置为 true 时，此主机将取消部署托管引擎组件，且不会作为高可用性集群的一部分运行。缺少的值被视为 true，即 un-deploy。省略此参数等于 false，主机不会在托管引擎区域执行任何操作。
