5.216.7. 获取 GET
检索虚拟机的描述。
名称 | 类型 | 方向 | 概述 |
---|---|---|---|
| In | 指明虚拟机的所有属性是否应该包含在响应中。 | |
| In | 指明是否应该根据用户权限过滤结果。 | |
| In | 表示返回的结果是否描述虚拟机目前正在运行,或者如果将其描述有已执行的修改,但仅在重启时才会生效。 | |
| Out | 虚拟机的描述。 |
5.216.7.1. all_content 复制链接链接已复制到粘贴板!
复制链接链接已复制到粘贴板!
指明虚拟机的所有属性是否应该包含在响应中。
默认情况下排除以下属性:
-
控制台(Console)
-
initialization.configuration.data
- 描述虚拟机的 OVF 文档。 -
rng_source
-
soundcard
-
virtio_scsi
例如,要检索虚拟机 '123' 的完整表示,请按如下所示发送请求:
GET /ovirt-engine/api/vms/123?all_content=true
GET /ovirt-engine/api/vms/123?all_content=true
注意
不包括这些属性的原因是性能:它们被很少使用,它们需要额外的查询数据库。因此,只有在真正需要时才尝试使用这个参数。