第 14 章 主机
14.1. 主机元素
主机集合 提供有关 Red Hat Virtualization 环境中主机的信息。API 用户通过从入口点 URI 获取的 rel="hosts" 链接访问此信息。
可以使用
All-Content: true 标头检索 GET 请求的其他信息。
下表显示了主机资源表示法中包含的特定元素。
| 元素 | 类型 | Description | Properties |
|---|---|---|---|
link rel="storage" | 关系 | 到主机存储的 storage 子集合的链接。 | 
|
link rel="nics" | 关系 | 到主机网络接口的 nics 子集合的链接。 | |
link rel="numanodes" | 关系 | 主机 NUMA 节点的 numanodes 子集合的链接。 | |
link rel="tags" | 关系 | 到主机标签 标签 子集合的链接。 | |
link rel="permissions" | 关系 | 到主机 权限权限 子集合的链接。 | |
link rel="statistics" | 关系 | 到主机 统计数据的统计信息 子集合的链接。 |
|
link rel="hooks" | 关系 | 到主机 hook 的 hook 子集合的链接。 | |
link rel="fenceagents" | 关系 | 到主机隔离代理的 fenceagents 子集合的链接。 | |
link rel="katelloerrata" | 关系 | 到主机勘误表的 katelloerrata 子集合的链接。 | |
link rel="devices" | 关系 | 主机设备的 devices 子集合的链接。 | |
link rel="networkattachments" | 关系 | 到 host 网络配置的 networkattachments 子集合的链接。 | |
link rel="unmanagednetworks" | 关系 | 到主机上非受管网络的 unmanagednetworks 子集合的链接。 | |
link rel="storageconnectionextensions" | 关系 | 到 host 存储连接扩展的 storageconnectionextensions 子集合的链接。 | |
name | 字符串 | 主机的唯一标识符。 | |
root_password | 字符串 | 此主机的 root 密码仅包含在客户端提供的主机表示法中。 | 
|
注释 | 字符串 | 有关主机的任何注释。 | |
address | 字符串 | 主机的 IP 地址或主机名。 |
|
certificate | complex | 对主机证书详细信息的引用，包括 组织 和主题。 |
|
status | 请参见以下 | 主机状态。 |
|
external_status | complex/enumerated | 外部系统和插件报告的主机健康状态。state 元素包含 ok、info、warning、error 或 failure 的枚举值。 | |
cluster id= | GUID | 对包含此主机的集群的引用。 | |
port | 整数 | 在此主机上运行的 VDSM 守护进程的监听端口。 |
|
type | rhel 或 ovirt_node之一 | 主机类型。 |
|
storage_manager priority= | 布尔值： true 或 false | 指定主机是否为存储管理器。 |
|
version major= minor= build= revision= full_version= | complex | 主机的兼容性级别。 |
|
hardware_information | complex | 有关主机硬件的信息，包括 制造商,版本,serial_number,product_name,uuid, 和 family。 | |
power_management type= | complex | 主机电源管理的配置选项，包括 启用、选项、kdump_detection、auto_pm_enabled 和 代理。有关主机电源管理选项的更多信息，请参阅 第 14.4 节 “电源管理元素”。 | |
ksm | 布尔值： true 或 false | 如果启用了内核同页合并(KSM)，则为 true。 | |
transparent_hugepages | 布尔值： true 或 false | 如果启用了 Transparent Hugepages，则为 true。 | |
iscsi | complex | 主机的 SCSI 启动器。 |
|
ssh | complex | 有关与主机 SSH 连接的详细信息，包括 端口和 指纹。 | |
cpu | complex | 主机 CPU 的统计信息。包括 CPU 名称、拓扑内核=、拓扑 和 速度的子元素。拓扑 cores= 在 拓扑 socket= 聚合总内核时聚合了总核。虚拟机可用的内核总数等于插槽的数量乘以每个插槽的内核。 |
|
内存 | 整数 | 主机内存量（以字节为单位）。 |
|
max_scheduling_memory | 整数 | 可以字节为单位使用的最大内存量。 |
|
summary | complex | 主机上虚拟机的摘要统计信息。包括 活动、迁移 和虚拟机 总数的子元素。 |
|
os type= | complex | 主机上安装的操作系统的详细信息，包括 版本 full_version=。 |
|
libvirt_version major= minor= build= revision= full_version= | complex | 主机的 libvirt 兼容性级别。 |
|
status 包含以下枚举的值之一： down、error、initialize、Installing、install_failed、maintenance、non_operational、non_responsive、Pending_approval、preparing_ for_maintenance、connect、boot、t assigned 和 up。capabilities 下的 host_states 中。
