搜索

72.19. 服务器列表

download PDF

列出服务器

使用方法:

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]
                             [--sort-ascending | --sort-descending]
                             [--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>]
                             [--deleted]
                             [--availability-zone AVAILABILITY_ZONE]
                             [--key-name KEY_NAME]
                             [--config-drive | --no-config-drive]
                             [--progress PROGRESS] [--vm-state <state>]
                             [--task-state <state>] [--power-state <state>]
                             [--long] [-n | --name-lookup-one-by-one]
                             [--marker <server>] [--limit <num-servers>]
                             [--changes-before <changes-before>]
                             [--changes-since <changes-since>]
                             [--locked | --unlocked] [--tags <tag>]
                             [--not-tags <tag>]

表 72.72. 命令参数
概述

-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

根据可用区搜索(仅在微版本 2.83 之前管理)

--key-name KEY_NAME

按照密钥对名称搜索(仅在微版本 2.83 之前管理)

--config-drive

仅显示附加了配置驱动器的服务器(仅在 microversion 2.83 之前管理员)

--no-config-drive

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

--progress PROGRESS

按进度值(%)搜索(仅在微版本 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-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 或更高版本支持)

表 72.73. 输出格式选项
概述

-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

以降序排列列

表 72.74. CSV 格式选项
概述

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

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

表 72.75. JSON 格式选项
概述

--noindent

是否禁用缩进 json

表 72.76. 表格式器选项
概述

--max-width <integer>

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

--fit-width

将表适合显示宽度。如果 --max-width 大于 0,则表示表示。将环境变量 CLIFF_FIT_WIDTH=1 设置为 always 启用

--print-empty

如果没有要显示的数据,打印空表。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.