72.18. 服务器列表
列出服务器
使用方法:
openstack server list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
[--quote {all,minimal,none,nonnumeric}]
[--noindent] [--max-width <integer>]
[--fit-width] [--print-empty]
[--sort-column SORT_COLUMN]
[--reservation-id <reservation-id>]
[--ip <ip-address-regex>]
[--ip6 <ip-address-regex>] [--name <name-regex>]
[--instance-name <server-name>]
[--status <status>] [--flavor <flavor>]
[--image <image>] [--host <hostname>]
[--all-projects] [--project <project>]
[--project-domain <project-domain>]
[--user <user>] [--user-domain <user-domain>]
[--long] [-n | --name-lookup-one-by-one]
[--marker <server>] [--limit <num-servers>]
[--deleted] [--changes-before <changes-before>]
[--changes-since <changes-since>]
[--locked | --unlocked]
表 72.66. 可选参数
| 值 | 概述 |
|---|---|
| -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 | 包含所有项目(仅限管理员) |
| --project <project> | 按项目(仅限管理员)(名称或 ID)搜索 |
| --project-domain <project-domain> | 项目所属的域(名称或 id)。这可在项目名称之间有冲突时使用。 |
| --user <user> | 按用户(仅限管理员)(名称或 ID)搜索 |
| --user-domain <user-domain> | 用户所属的域(名称或 id)。这在用户名之间有冲突时可以使用。 |
| --long | 列出输出中的其他字段 |
| -n, --no-name-lookup | 跳过类别和镜像名称 lookup.mutual with "--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 选项。 |
| --deleted | 仅显示已删除的服务器(仅管理)。 |
| --changes-before <changes-before> | 仅列出在一定时间之前更改的服务器。所提供的时间应当是 ISO 8061 格式的时间(例如,2016-03-05T06:27:59Z)。(由 API 版本 2.66 支持 - 2.latest) |
| --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 或更高。 |
表 72.67. 输出格式器
| 值 | 概述 |
|---|---|
| -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | 输出格式,默认为 table |
| -c COLUMN, --column COLUMN | 指定要包含的列,可以重复 |
| --sort-column SORT_COLUMN | 指定排序数据的列(指定首先具有优先级的非存在列将被忽略)可以重复 |
表 72.68. CSV Formatter
| 值 | 概述 |
|---|---|
| --quote {all,minimal,none,nonnumeric} | 当包含引号时,默认为 nonnumeric |
表 72.69. JSON Formatter
| 值 | 概述 |
|---|---|
| --noindent | 是否禁用缩进 json |
表 72.70. 表格式
| 值 | 概述 |
|---|---|
| --max-width <integer> | 最大显示宽度 <1 来禁用。您还可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。 |
| --fit-width | 适合显示宽度的表。如果 --max-width 大于 0,则意味着。将环境变量 CLIFF_FIT_WIDTH=1 设置为 always 启用 |
| --print-empty | 如果没有要显示数据,则打印空表。 |