66.19. 服务器列表

-h, --help

显示帮助信息并退出

--reservation-id <reservation-id>

仅返回与保留匹配的实例

--ip <ip-address-regex>

匹配 ip 地址的正则表达式

--ip6 <ip-address-regex>

匹配 ipv6 地址的正则表达式。请注意，这个选项只适用于非管理员用户，在使用 ''--os-compute-api-version' 2.5 或更高版本时。

--name <name-regex>

匹配名称的正则表达式

--instance-name <server-name>

匹配实例名称的正则表达式（仅限管理员）

--status <status>

根据服务器状态搜索

--flavor <flavor>

按类别搜索（名称或 id）

--image <image>

按照镜像（名称或 id）搜索

--host <hostname>

按主机名搜索

--all-projects

包括所有项目（仅限管理员）（可以使用 ALL_PROJECTS envvar 指定）

--project <project>

按项目（仅限管理员）搜索（仅限管理员）（名称或 id）

--project-domain <project-domain>

项目所属的域（名称或 id）。这可在存在项目名称之间冲突时使用。

--user <user>

按照用户（名称或 id）搜索（仅在微版本 2.83 之前管理）

--user-domain <user-domain>

用户所属的域（名称或 id）。这可在用户名之间存在冲突时使用。

--deleted

仅显示已删除的服务器（仅限管理员）

--availability-zone AVAILABILITY_ZONE

根据可用区搜索（仅在 microversion 2.83 之前管理员）

--key-name KEY_NAME

按照密钥对名称搜索（仅在 microversion 2.83 之前管理员）

--config-drive

仅显示附加配置驱动器的服务器（仅在微版本 2.83 之前管理）

--no-config-drive

仅显示附加配置驱动器的服务器（仅在微版本 2.83 之前管理）

--progress PROGRESS

按照进度值(%)搜索（仅在 microversion 2.83 之前管理员）

--vm-state <state>

按照 vm_state 值搜索（仅在 microversion 2.83 之前管理员）

--task-state <state>

按照 task_state 值搜索（只有在 microversion 2.83 之前的管理员）

--power-state <state>

根据 power_state 值搜索（仅在 microversion 2.83 之前管理员）

--long

列出输出中的其他字段

-n, --no-name-lookup

跳过类别和镜像名称查找。与 "--name-lookup-one-by-one" 选项相互排斥。

--name-lookup-one-by-one

查找类别和镜像名称时，根据需要将其查找为一，而不是全部查找（默认）。与 "--no-name- lookup|-n" 选项相互排斥。

--marker <server>

上一页的最后一个服务器。在标记后显示服务器列表。如果未指定，则显示所有服务器。与 '--deleted' 一起使用时，标记必须是 ID，否则可以使用名称或 ID。

--limit <num-servers>

要显示的最大服务器数量。如果限值等于 -1，则会显示所有服务器。如果限制大于 Nova API 的 osapi_max_limit 选项，则将改为使用 osapi_max_limit。

--changes-before <changes-before>

仅列出在一定时间点前更改的服务器。提供的时间应该是 ISO 8061 格式的时间（例如，2016-03-05T06:27:59Z）。（由 --os-compute-api-version 2.66 或更高版本支持）

--changes-since <changes-since>

仅列出在一定时间后更改的服务器。提供的时间应该是 ISO 8061 格式的时间（例如，2016-03-04T06:27:59Z）。

--locked

仅显示锁定的服务器（由 --os- compute-api-version 2.73 或更高版本支持）

--unlocked

仅显示解锁的服务器（由 --os- compute-api-version 2.73 或更高版本支持）

--tags <tag>

仅列出带有指定标签的服务器。指定多次以过滤多个标签（由 --os-compute-api-version 2.26 或更高版本支持）

--not-tags <tag>

仅列出没有指定标签的服务器。指定多次过滤多个标签（由 --os-compute-api-version 2.26 或更高版本支持）

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式，默认为 table

-c COLUMN, --column COLUMN

指定要包含的列，可以重复显示多个列

--sort-column SORT_COLUMN

指定排序数据的列（指定第一个指定的列具有优先级，非存在的列将被忽略）可以重复

--sort-ascending

以升序对列进行排序

--sort-descending

以降序对列进行排序

--quote {all,minimal,none,nonnumeric}

当包含引号时，则默认为非数字

--noindent

是否禁用对 json 的缩进

--max-width <integer>

最大显示宽度，即 <1 来禁用。您还可以使用 CLIFF_MAX_TERM_WIDTH 环境变量，但参数具有优先权。

--fit-width

将表与显示宽度匹配。如果 --max 宽度大于 0，则表示表示。将环境变量 CLIFF_FIT_WIDTH=1 设置为 always 启用

--print-empty

如果没有要显示数据，则打印空表。