3.2. 资源

3.2.1. 列出一个集合中的资源（list）

使用 list 命令列出一个特定类型中的所有资源。它还可以包括一个可以对结果进行过滤的查询。
语法

list [collection] [options]

表 3.2. list 标准选项

选项描述
--show-all显示列出的每个资源的所有非空属性。如果没有使用这个选项，列出的资源只会显示 id、name 和 description 属性。
--query [QUERY]使用基于 Red Hat Virtualization Manager 查询语言的服务器端查询来过滤列表。
--kwargs [QUERY]使用客户端的查询来过滤结果。
--case_sensitive true|false在进行查询时区分大小写。
--max可以显示的最多结果数。

注意

只适用于特定资源的选项会在相应资源的定义页中列出。

例 3.3. list 示例

列出虚拟机： 
[RHEVM shell (connected)]# list vms
列出虚拟机（包括所有属性）： 
[RHEVM shell (connected)]# list vms --show-all
列出状态为 'up' 的虚拟机： 
[RHEVM shell (connected)]# list vms --query "status=up"
使用通配符列出所有域中的、满足一定条件的用户： 
[RHEVM shell (connected)]# list users --query "usrname=jsmith@*"  --case_sensitive false
显示 list 的帮助信息： 
[RHEVM shell (connected)]# list --help

3.2.2. 显示一个资源（show）

使用 show 命令显示资源属性。
语法

show [resource] [id|name] [options]

表 3.3. show 标准选项

选项描述
--id [UUID]使用资源的 UUID 值指定资源。
--name [NAME]使用资源名来指定资源。

注意

只适用于特定资源的选项会在相应资源的定义页中列出。

例 3.4. show 命令示例

显示带有指定 id 的虚拟机: 
[RHEVM shell (connected)]# show vm fcadfd5f-9a12-4a1e-bb9b-2b9d5c2e04c3
显示带有指定名称的虚拟机： 
[RHEVM shell (connected)]# show vm RHEL6-Server

3.2.3. 添加一个资源（add）

使用 add 命令添加一个新资源。
语法

add [resource] [options]

注意

只适用于特定资源的选项会在相应资源的定义页中列出。

例 3.5. add 命令示例

创建一个虚拟机： 
[RHEVM shell (connected)]# add vm [vm-options]
创建一个用户： 
[RHEVM shell (connected)]# add user [user-options]
使用 expect 选项可以使 add 命令同步（在以下示例中，add 命令会等待 https/http 返回 ‘201’）： 
[RHEVM shell (connected)]# add vm [vm-options] --expect '201-created'

3.2.4. 更新一个资源（update）

使用 update 命令修改一个存在的资源。
语法

update [resource] [id|name] [options]

注意

只适用于特定资源的选项会在相应资源的定义页中列出。

例 3.6. update 命令示例

更新一个虚拟机： 
[RHEVM shell (connected)]# update vm RHEL6-Server [vm-options]

3.2.5. 删除一个资源（remove）

使用 remove 命令删除一个资源。
语法

remove [resource] [id|name] [options]

表 3.4. remove 标准选项

选项描述
--async异步删除资源。
--force强制删除资源。这会同时删除相关资源在数据库中的所有记录，并只对 datacenter 和 vm 资源有效。

注意

只适用于特定资源的选项会在相应资源的定义页中列出。

例 3.7. remove 命令示例

删除一个虚拟机： 
[RHEVM shell (connected)]# remove vm RHEL6-Server
异步删除一个虚拟机： 
[RHEVM shell (connected)]# remove vm RHEL6-Server --async true
强制删除虚拟机： 
[RHEVM shell (connected)]# remove vm RHEL6-Server --force

3.2.6. 在资源上执行特定操作（action）

使用 action 命令执行一个与资源类型相关的特殊操作。
语法

action [resource] [id|name] [action] [options]

注意

只适用于特定资源的操作会在相应资源的定义页中列出。

例 3.8. action 命令示例

启动一个虚拟机 
[RHEVM shell (connected)]# action vm RHEL6-Server start
停止一个虚拟机： 
[RHEVM shell (connected)]# action vm RHEL6-Server stop
async 选项可以使用 action 命令以同步形式进行： 
[RHEVM shell (connected)]# action vm [vm-options] --async false

3.2.7. 使用子资源（--RESOURCE-identifier）

一些资源是以其它资源的子资源的形式出现的，子资源和它们的上级资源存在一个依赖关系。使用 --RESOURCE-identifier [name] 选项（其中的 RESOURCE 是上级资源的类型）来把一个资源标记为另一个资源的子资源。

例 3.9. 使用 add 创建子资源的示例

在虚拟机上创建一个网卡（NIC） 
[RHEVM shell (connected)]# add nic --vm-identifier RHEL6-Server [nic-options]
以上命令中的 --vm-identifier RHEL6-Server 选项指定了把 NIC 添加到运行 RHEL6 Server 的虚拟机上。
在虚拟机上创建一个存储磁盘： 
[RHEVM shell (connected)]# add disk --vm-identifier RHEL6-Server [user-options]
以上命令中的 --vm-identifier RHEL6-Server 选项指定了把 一个存储磁盘添加到运行 RHEL6 Server 的虚拟机上。