Red Hat Training

A Red Hat training course is available for Red Hat Virtualization

第 14 章 主机

14.1. 主机元素

主机集合 提供有关 Red Hat Virtualization 环境中主机的信息。API 用户通过从入口点 URI 获取的 rel="hosts" 链接访问此信息。
可以使用 All-Content: true 标头检索 GET 请求的其他信息。
下表显示了主机资源表示法中包含的特定元素。

表 14.1. 主机元素

元素 类型 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 名称、拓扑内核=、拓扑 socket=、拓扑 threads= 和 速度的子元素。拓扑 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 中。