6.269.2. 列出 GET

列出虚拟机的所有配置的图形控制台。

重要

默认情况下，如果没有指定 当前 参数，返回的数据对应于下一次虚拟机执行。在系统的当前实施中，这意味着不会填充 地址 和端口 属性，因为系统不知道将什么地址和端口用于下一次执行。由于在大多数情况下需要这些属性，因此强烈建议您明确包含 当前 参数，值为 true。

无法保证返回的图形控制台列表的顺序。

Expand

表 6.842. 参数摘要
名称	类型	方向	概述
`consoles`	GraphicsConsole[]	out	虚拟机的图形控制台列表。
`current`	布尔值	in	指定返回的数据应当与下一次虚拟机执行或当前执行对应。
`follow`	字符串	in	指明应遵循哪些内联链接。
`max`	整数	in	设置要返回的最大控制台数。

指定返回的数据应当与下一次虚拟机执行或当前执行对应。

重要

地址和 端口 属性将不会填充，除非值为 true。

例如，要获取当前执行虚拟机的数据，包括 地址 和端口 属性，请发送如下所示的请求：

GET /ovirt-engine/api/vms/123/graphicsconsoles?current=true

GET /ovirt-engine/api/vms/123/graphicsconsoles?current=true

Copy to Clipboard

Toggle word wrap

默认值为 false。

返回顶部