nova¶
nova 客户端是计算服务 (nova) API 及其扩展的命令行界面 (CLI)。
要获取特定 nova 命令的帮助，请输入
$ nova help COMMAND
自版本 17.8.0 起已弃用：nova CLI 已被统一的 openstack CLI 取代。有关使用 openstack CLI 的信息，请参阅 OpenStackClient。
nova 用法¶
usage: nova [--version] [--debug] [--os-cache] [--timings]
[--os-region-name <region-name>] [--service-type <service-type>]
[--service-name <service-name>]
[--os-endpoint-type <endpoint-type>]
[--os-compute-api-version <compute-api-ver>]
[--os-endpoint-override <bypass-url>] [--profile HMAC_KEY]
[--insecure] [--os-cacert <ca-certificate>]
[--os-cert <certificate>] [--os-key <key>] [--timeout <seconds>]
[--collect-timing] [--os-auth-type <name>]
[--os-auth-url OS_AUTH_URL] [--os-system-scope OS_SYSTEM_SCOPE]
[--os-domain-id OS_DOMAIN_ID] [--os-domain-name OS_DOMAIN_NAME]
[--os-project-id OS_PROJECT_ID]
[--os-project-name OS_PROJECT_NAME]
[--os-project-domain-id OS_PROJECT_DOMAIN_ID]
[--os-project-domain-name OS_PROJECT_DOMAIN_NAME]
[--os-trust-id OS_TRUST_ID]
[--os-default-domain-id OS_DEFAULT_DOMAIN_ID]
[--os-default-domain-name OS_DEFAULT_DOMAIN_NAME]
[--os-user-id OS_USER_ID] [--os-username OS_USERNAME]
[--os-user-domain-id OS_USER_DOMAIN_ID]
[--os-user-domain-name OS_USER_DOMAIN_NAME]
[--os-password OS_PASSWORD]
<subcommand> ...
子命令
add-fixed-ip已弃用 将网络上的新 IP 地址添加到服务器。
add-secgroup向服务器添加安全组。
agent-create创建新的 agent 构建。
agent-delete删除现有的 agent 构建。
agent-list列出所有构建。
agent-modify修改现有的 agent 构建。
aggregate-add-host将主机添加到指定的聚合。
aggregate-cache-images请求将镜像预缓存到聚合内的宿主机上。（受 API 版本 ‘2.81’ - ‘2.latest’ 支持）
aggregate-create使用指定的详细信息创建新的聚合。
aggregate-delete删除聚合。
aggregate-list打印所有聚合的列表。
aggregate-remove-host从指定的聚合中删除指定的主机。
aggregate-set-metadata更新与聚合关联的元数据。
aggregate-show显示指定聚合的详细信息。
aggregate-update更新聚合的名称和可选的可用区。
availability-zone-list列出所有可用区。
备份中通过创建“备份”类型的快照来备份服务器。
boot启动新的服务器。
clear-password从元数据服务器清除服务器的管理员密码。 此操作实际上不会更改实例服务器密码。
cloudpipe-configure已弃用 更新 cloudpipe 实例的 VPN IP/端口。
cloudpipe-create已弃用 为给定的项目创建一个 cloudpipe 实例。
cloudpipe-list已弃用 打印所有 cloudpipe 实例的列表。
console-log获取服务器的控制台日志输出。
删除立即关闭并删除指定的服务器。
diagnostics检索服务器诊断信息。
evacuate从故障主机撤离服务器。
flavor-access-add为给定的租户添加 flavor 访问权限。
flavor-access-list打印有关给定 flavor 的访问信息。
flavor-access-remove为给定的租户删除 flavor 访问权限。
flavor-create创建一个新的 flavor。
flavor-delete删除特定的 flavor
flavor-key设置或取消 flavor 的 extra_spec。
flavor-list打印可用的 ‘flavor’（服务器大小）列表。
flavor-show显示有关给定 flavor 的详细信息。
flavor-update更新现有 flavor 的描述。（受 API 版本 ‘2.55’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
floating-ip-associate已弃用 将浮动 IP 地址关联到服务器。
floating-ip-disassociate已弃用 将浮动 IP 地址从服务器分离。
force-delete强制删除服务器。
get-mks-console获取服务器的 MKS 控制台。（受 API 版本 ‘2.8’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
get-password获取服务器的管理员密码。 此操作调用元数据服务来查询元数据信息，并且不会从服务器本身读取密码信息。
get-rdp-console获取服务器的 rdp 控制台。
get-serial-console获取服务器的串口控制台。
get-spice-console获取服务器的 spice 控制台。
get-vnc-console获取服务器的 vnc 控制台。
host-action已弃用 对宿主机执行电源操作。
host-describe已弃用 描述特定的宿主机。
host-evacuate从故障主机上撤离所有实例。
host-evacuate-live将指定主机上的所有实例实时迁移到其他可用主机。
host-list已弃用 按服务列出所有宿主机。
host-meta设置或删除主机上所有实例的元数据。
host-servers-migrate将指定主机上的所有实例冷迁移到其他可用主机。
host-update已弃用 更新宿主机设置。
hypervisor-list列出 hypervisor。（受 API 版本 ‘2.0’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
hypervisor-servers列出属于特定超visor的服务器。
hypervisor-show显示指定超visor的详细信息。
hypervisor-stats获取所有计算节点上的 hypervisor 统计信息。
hypervisor-uptime显示指定超visor的运行时间。
image-create通过拍摄正在运行的服务器的快照来创建新镜像。
instance-action显示一个操作。
instance-action-list列出服务器上的操作。
instance-usage-audit-log列出/获取服务器使用情况审计。
interface-attach将网络接口附加到服务器。
interface-detach将网络接口从服务器分离。
interface-list列出附加到服务器的接口。
keypair-add创建用于服务器的新密钥对。
keypair-delete删除按名称给定的密钥对。（受 API 版本 ‘2.0’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
keypair-list打印用户的密钥对列表（受 API 版本 ‘2.0’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
keypair-show显示给定密钥对的详细信息。（受 API 版本 ‘2.0’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
限制打印速率和绝对限制。
列表列出服务器。
list-secgroup列出服务器的安全组。
live-migration将正在运行的服务器迁移到新机器。
live-migration-abort中止正在进行中的实时迁移。（受 API 版本 ‘2.24’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
live-migration-force-complete强制正在进行的实时迁移完成。（受 API 版本 ‘2.22’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
lock锁定服务器。普通（非管理员）用户将无法对锁定的服务器执行操作。
meta设置或删除服务器上的元数据。
migrate迁移服务器。调度器将选择新的宿主机。
migration-list打印迁移列表。
暂停暂停服务器。
quota-class-show列出配额类别的配额。
quota-class-update更新配额类别的配额。（受 API 版本 ‘2.0’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
quota-defaults列出租户的默认配额。
quota-delete删除租户/用户的配额，使其配额将恢复到默认值。
quota-show列出租户/用户的配额。
quota-update更新租户/用户的配额。（受 API 版本 ‘2.0’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
reboot重启服务器。
rebuild关闭、重新镜像并重启服务器。
refresh-network刷新服务器网络信息。
remove-fixed-ip已弃用 从服务器删除 IP 地址。
remove-secgroup从服务器移除安全组。
rescue将服务器重新启动到救援模式，从初始镜像或指定的镜像启动机器，并将当前启动磁盘作为辅助磁盘附加。
reset-network重置服务器的网络。
reset-state重置服务器的状态。
调整大小调整服务器的大小。
resize-confirm确认之前的调整大小操作。
resize-revert撤销之前的调整大小（并返回到之前的 VM）。
restore恢复一个软删除的服务器。
resume恢复服务器。
server-group-create创建具有指定细节的新服务器组。
server-group-delete删除特定的服务器组。
server-group-get获取特定的服务器组。
server-group-list打印所有服务器组的列表。
server-migration-list获取指定服务器的迁移列表。（受 API 版本 ‘2.23’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
server-migration-show获取指定服务器的迁移。（受 API 版本 ‘2.23’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
server-tag-add向服务器添加一个或多个标签。（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
server-tag-delete从服务器删除一个或多个标签。（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
server-tag-delete-all删除服务器上的所有标签。（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
server-tag-list获取服务器上的标签列表。（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
server-tag-set将标签列表设置为服务器。（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
server-topology检索给定服务器的 NUMA 拓扑。（受 API 版本 ‘2.78’ - ‘2.latest’ 支持）
service-delete删除服务。
service-disable禁用服务。
service-enable启用服务。
service-force-down强制服务进入 down 状态。（受 API 版本 ‘2.11’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
service-list显示所有正在运行的服务的列表。按宿主机和二进制过滤。
set-password更改服务器的管理员密码。
shelve搁置服务器。
shelve-offload从计算节点移除搁置的服务器。
show显示给定服务器的详细信息。
ssh通过 SSH 连接到服务器。
start启动服务器。
停止停止服务器。
挂起暂停服务器。
trigger-crash-dump触发实例中的崩溃转储。（受 API 版本 ‘2.17’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
unlock解锁服务器。
取消暂停取消暂停服务器。
取消救援从正常启动磁盘再次启动服务器。
unshelve取消挂起服务器。
update更新服务器的名称或描述。
使用情况显示单个租户的使用情况数据。
usage-list列出所有租户的使用情况数据。
version-list列出所有 API 版本。
virtual-interface-list已弃用 显示给定服务器的虚拟接口信息。
volume-attach将卷附加到服务器。
volume-attachments列出附加到服务器的所有卷。
volume-detach从服务器分离卷。
volume-update更新服务器上的附件。将数据从附加的卷迁移到指定的可用卷，并交换到新的卷上的活动附件。从 microversion 2.85 开始，支持更新
delete_on_termination删除标志，该标志允许更改实例删除时卷删除的行为。x509-create-cert已弃用 为租户中的用户创建 x509 证书。
x509-get-root-cert已弃用 获取 x509 根证书。
bash-completion将所有命令和选项打印到 stdout，以便 nova.bash_completion 脚本不必对其进行硬编码。
help显示有关此程序或其子命令的帮助。
nova 可选参数¶
--version显示程序版本号并退出
--debug打印调试输出。
--os-cache使用身份验证令牌缓存。如果未设置
env[OS_CACHE]，则默认为 False。--timings打印调用时间信息。
--os-region-name <region-name>默认为
env[OS_REGION_NAME]。--service-type <service-type>对于大多数操作，默认为 compute。
--service-name <service-name>默认为
env[NOVA_SERVICE_NAME]。--os-endpoint-type <endpoint-type>默认为
env[NOVA_ENDPOINT_TYPE]、env[OS_ENDPOINT_TYPE]或 publicURL。--os-compute-api-version <compute-api-ver>接受 X、X.Y（其中 X 是主版本号，Y 是次版本号）或“X.latest”，默认为
env[OS_COMPUTE_API_VERSION]。--os-endpoint-override <bypass-url>使用此 API 端点而不是服务目录。默认为
env[OS_ENDPOINT_OVERRIDE]。--profile HMAC_KEY用于加密操作上下文数据的 HMAC 密钥。此密钥应为 nova 配置中 OSprofiler 中间件配置的 HMAC 密钥的值；它在 Nova 配置文件“/etc/nova/nova.conf”中指定。如果没有密钥，即使服务器端启用了 OSprofiler，也不会触发分析。
--os-auth-type <name>, --os-auth-plugin <name>要使用的身份验证类型
nova add-secgroup¶
usage: nova add-secgroup <server> <secgroup>
向服务器添加安全组。
位置参数
<server>服务器的名称或 ID。
<secgroup>安全组的名称或 ID。
nova agent-create¶
usage: nova agent-create <os> <architecture> <version> <url> <md5hash>
<hypervisor>
创建新的 agent 构建。
位置参数
<os>操作系统类型。
<architecture>架构类型。
<version>版本。
<url>URL。
<md5hash>MD5 哈希值。
<hypervisor>hypervisor 类型。
nova agent-delete¶
usage: nova agent-delete <id>
删除现有的 agent 构建。
位置参数
<id>agent-build 的 ID。
nova agent-list¶
usage: nova agent-list [--hypervisor <hypervisor>]
列出所有构建。
可选参数
--hypervisor <hypervisor>hypervisor 类型。
nova agent-modify¶
usage: nova agent-modify <id> <version> <url> <md5hash>
修改现有的 agent 构建。
位置参数
<id>agent-build 的 ID。
<version>版本。
<url>URL
<md5hash>MD5 哈希值。
nova aggregate-add-host¶
usage: nova aggregate-add-host <aggregate> <host>
将主机添加到指定的聚合。
位置参数
<aggregate>聚合的名称或 ID。
<host>要添加到聚合的宿主机。
nova aggregate-cache-images¶
usage: nova aggregate-cache-images <aggregate> <image> [<image> ..]
请求将镜像预缓存到聚合内的宿主机上。（受 API 版本 ‘2.81’ - ‘2.latest’ 支持）
在版本 16.0.0 中添加。
位置参数
<aggregate>聚合的名称或 ID。
<image>要缓存的镜像的名称或 ID。
nova aggregate-create¶
usage: nova aggregate-create <name> [<availability-zone>]
使用指定的详细信息创建新的聚合。
位置参数
<name>聚合的名称。
<availability-zone>聚合的可用区（可选）。
nova aggregate-delete¶
usage: nova aggregate-delete <aggregate>
删除聚合。
位置参数
<aggregate>要删除的聚合的名称或 ID。
nova aggregate-list¶
usage: nova aggregate-list
打印所有聚合的列表。
nova aggregate-remove-host¶
usage: nova aggregate-remove-host <aggregate> <host>
从指定的聚合中删除指定的主机。
位置参数
<aggregate>聚合的名称或 ID。
<host>要从聚合中删除的宿主机。
nova aggregate-set-metadata¶
usage: nova aggregate-set-metadata <aggregate> <key=value> [<key=value> ...]
更新与聚合关联的元数据。
位置参数
<aggregate>要更新的聚合的名称或 ID。
<key=value>要添加/更新到聚合的元数据。仅指定键以删除元数据项。
nova aggregate-show¶
usage: nova aggregate-show <aggregate>
显示指定聚合的详细信息。
位置参数
<aggregate>聚合的名称或 ID。
nova aggregate-update¶
usage: nova aggregate-update [--name NAME]
[--availability-zone <availability-zone>]
<aggregate>
更新聚合的名称和可选的可用区。
位置参数
<aggregate>要更新的聚合的名称或 ID。
可选参数
--name NAME聚合的新名称。
--availability-zone <availability-zone>聚合的新可用区。
nova availability-zone-list¶
usage: nova availability-zone-list
列出所有可用区。
nova backup¶
usage: nova backup <server> <name> <backup-type> <rotation>
通过创建“备份”类型的快照来备份服务器。
位置参数
<server>服务器的名称或 ID。
<name>备份镜像的名称。
<backup-type>备份类型，例如“daily”或“weekly”。
<rotation>Int 参数，表示保留多少个备份。
nova boot¶
usage: nova boot [--flavor <flavor>] [--image <image>]
[--image-with <key=value>] [--boot-volume <volume_id>]
[--snapshot <snapshot_id>] [--min-count <number>]
[--max-count <number>] [--meta <key=value>]
[--key-name <key-name>] [--user-data <user-data>]
[--availability-zone <availability-zone>]
[--security-groups <security-groups>]
[--block-device-mapping <dev-name=mapping>]
[--block-device key1=value1[,key2=value2...]]
[--swap <swap_size>]
[--ephemeral size=<size>[,format=<format>]]
[--hint <key=value>]
[--nic <auto,none,net-id=net-uuid,net-name=network-name,port-id=port-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr,tag=tag>]
[--config-drive <value>] [--poll] [--admin-pass <value>]
[--access-ip-v4 <value>] [--access-ip-v6 <value>]
[--description <description>] [--tags <tags>]
[--return-reservation-id]
[--trusted-image-certificate-id <trusted-image-certificate-id>]
[--host <host>]
[--hypervisor-hostname <hypervisor-hostname>]
[--hostname <hostname>]
<name>
启动新的服务器。
为了创建具有预先存在的端口的服务器，这些端口包含 resource_request 值，例如用于保证最小带宽服务质量支持，需要 microversion 2.72。
位置参数
<name>新服务器的名称。
可选参数
--flavor <flavor>flavor 的名称或 ID（请参阅 ‘nova flavor-list’）。
--image <image>镜像的名称或 ID（请参阅 ‘glance image-list’）。
--image-with <key=value>镜像元数据属性（请参阅 ‘glance image-show’）。
--boot-volume <volume_id>要从启动的卷 ID。
--snapshot <snapshot_id>要从启动的快照 ID（将创建一个卷）。
--min-count <number>至少启动 <number> 台服务器（受配额限制）。
--max-count <数字>启动最多 <数字> 台服务器（受配额限制）。
--meta <键=值>将任意键/值元数据记录到元数据服务器上的 /meta_data.json 文件中。可以多次指定。
--key-name <密钥名称>在使用 keypair-add 命令之前应该创建的密钥对的密钥名称。
--user-data <用户数据>要传递给元数据服务器的用户数据文件。
--availability-zone <availability-zone>服务器放置的可用区。
--security-groups <安全组>逗号分隔的安全组名称列表。
--block-device-mapping <设备名=映射>块设备映射，格式为 <设备名>=<ID>:<类型>:<大小(GiB)>:<终止时删除>。
--block-devicekey1=value1[,key2=value2…] 块设备映射，键包括：id=UUID（仅在使用源镜像、快照或卷时，为镜像 ID、快照 ID 或卷 ID），source=源类型（镜像、快照、卷或空白），dest=块设备的的目标类型（卷或本地），bus=设备的总线（例如 uml、lxc、virtio 等；如果省略，超visor 驱动程序会选择合适的默认值，仅当提供设备类型时才有效），type=设备类型（例如 disk、cdrom 等；默认为 ‘disk’），device=设备名称（例如 vda、xda 等；如果省略，超visor 驱动程序会根据所选总线选择合适的设备；请注意 libvirt 驱动程序始终使用默认设备名称），size=块设备的大小，以 MiB（用于交换分区）和 GiB（用于其他格式）为单位（如果省略，超visor 驱动程序会计算大小），format=设备将被格式化（例如 swap、ntfs 等；可选），bootindex=用于对引导磁盘进行排序的整数（对于基于镜像的实例，等于 0，对于其他实例需要指定），shutdown=关机行为（保留或删除，对于本地目标设置为删除），tag=设备元数据标签（可选；受 API 版本 ‘2.42’ - ‘2.latest’ 支持），以及 volume_type=创建卷的类型（ID 或名称），当 source 为 blank、image 或 snapshot 且 dest 为 volume 时（可选；受 API 版本 ‘2.67’ - ‘2.latest’ 支持）。
--swap <交换分区大小>创建并附加一个大小为 <交换分区大小> MiB 的本地交换分区块设备。
--ephemeralsize=<大小>[,format=<格式>] 创建并附加一个大小为 <大小> GiB 的本地临时块设备，并将其格式化为 <格式>。
--hint <键=值>将任意键/值对发送到调度器以供自定义使用。
--nic <auto,none,net-id=net-uuid,net-name=network-name,port-id=port-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr,tag=tag>在服务器上创建一个 NIC。要创建多个 NIC，请多次指定选项，除非使用特殊值 ‘auto’ 或 ‘none’。auto：如果可用，自动分配网络资源。不能与任何其他 nic 值一起指定，也不能多次指定。none：根本不附加 NIC。不能与任何其他 nic 值一起指定，也不能多次指定。net-id：将 NIC 附加到具有特定 UUID 的网络。net-name：将 NIC 附加到具有此名称的网络（必须提供 port-id 或 net-id 或 net-name），v4-fixed-ip：NIC 的 IPv4 固定地址（可选），v6-fixed-ip：NIC 的 IPv6 固定地址（可选），port-id：将 NIC 附加到具有此 UUID 的端口 tag：接口元数据标签（可选）（必须提供 port-id 或 net-id）。(受 API 版本 ‘2.42’ - ‘2.latest’ 支持)
--config-drive <值>启用 config drive。该值必须是一个布尔值。
--poll报告新服务器的启动进度，直到完成。
--admin-pass <值>实例的管理员密码。
--access-ip-v4 <值>实例的替代访问 IPv4 地址。
--access-ip-v6 <值>实例的替代访问 IPv6 地址。
--description <description>服务器的描述。（受 API 版本 ‘2.19’ - ‘2.latest’ 支持）
--tags <标签>服务器的标签。标签必须用逗号分隔：–tags <标签1,标签2>（受 API 版本 ‘2.52’ - ‘2.latest’ 支持）
--return-reservation-id返回与创建的服务器关联的预留 ID。
--trusted-image-certificate-id <受信任镜像证书 ID>用于在镜像签名验证过程中验证证书的受信任镜像证书 ID。默认值为 env[OS_TRUSTED_IMAGE_CERTIFICATE_IDS]。可以通过多次指定来传递多个受信任镜像证书 ID。（受 API 版本 ‘2.63’ - ‘2.latest’ 支持）
--host <host>请求创建服务器的主机。默认情况下仅限管理员。（受 API 版本 ‘2.74’ - ‘2.latest’ 支持）
--hypervisor-hostname <超visor 主机名>请求创建服务器的超visor 主机名。默认情况下仅限管理员。（受 API 版本 ‘2.74’ - ‘2.latest’ 支持）
--hostname <主机名>实例的主机名。这设置了存储在元数据服务器中的主机名：需要在客户机上运行的 cloud-init 等实用程序才能将这些更改传播到客户机。（受 API 版本 ‘2.90’ - ‘2.latest’ 支持）
nova clear-password¶
usage: nova clear-password <server>
从元数据服务器清除服务器的管理员密码。 此操作实际上不会更改实例服务器密码。
位置参数
<server>服务器的名称或 ID。
nova console-log¶
usage: nova console-log [--length <length>] <server>
获取服务器的控制台日志输出。
区域设置编码问题
如果您遇到如下错误：
UnicodeEncodeError: 'ascii' codec can't encode characters in position
解决这些问题的方案取决于您的计算机运行的区域设置。
例如，如果您有一台德语 Linux 机器，可以通过导出区域设置为 de_DE.utf-8 来解决问题
export LC_ALL=de_DE.utf-8
export LANG=de_DE.utf-8
如果您使用的是美国机器，en_US.utf-8 是首选编码。在一些较新的 Linux 系统上，您还可以尝试 C.UTF-8 作为区域设置
export LC_ALL=C.UTF-8
export LANG=C.UTF-8
位置参数
<server>服务器的名称或 ID。
可选参数
--length <长度>要尾随的行数。
nova delete¶
usage: nova delete [--all-tenants] <server> [<server> ...]
立即关闭并删除指定的服务器。
位置参数
<server>服务器的名称或 ID。
可选参数
--all-tenants按名称删除其他租户的服务器（仅限管理员）。
nova diagnostics¶
usage: nova diagnostics <server>
检索服务器诊断信息。
位置参数
<server>服务器的名称或 ID。
nova evacuate¶
usage: nova evacuate [--password <password>] [--on-shared-storage] [--force] <server> [<host>]
从故障主机撤离服务器。
位置参数
<server>服务器的名称或 ID。
<host>目标主机的名称或 ID。如果未指定主机，调度器将选择一个。
可选参数
--password <密码>在撤离的服务器上设置提供的管理员密码。如果服务器位于共享存储上，则不适用。
--on-shared-storage指定服务器文件位于共享存储上。（受 API 版本 ‘2.0’ - ‘2.13’ 支持）
--force通过不验证调度器提供的目标主机来强制撤离。（受 API 版本 ‘2.29’ - ‘2.67’ 支持）
警告
这可能导致实际上无法将服务器撤离到指定的宿主机。建议要么不指定宿主机，让调度器选择一个，要么指定宿主机，而不使用
--force。
nova flavor-access-add¶
usage: nova flavor-access-add <flavor> <tenant_id>
为给定的租户添加 flavor 访问权限。
位置参数
<flavor>要添加给定租户访问权限的风味名称或 ID。
<tenant_id>要添加风味访问权限的租户 ID。
nova flavor-access-list¶
usage: nova flavor-access-list [--flavor <flavor>]
打印有关给定 flavor 的访问信息。
可选参数
--flavor <flavor>按风味名称或 ID 过滤结果。
nova flavor-access-remove¶
usage: nova flavor-access-remove <flavor> <tenant_id>
为给定的租户删除 flavor 访问权限。
位置参数
<flavor>要从给定租户中删除访问权限的风味名称或 ID。
<tenant_id>要删除风味访问权限的租户 ID。
nova flavor-create¶
usage: nova flavor-create [--ephemeral <ephemeral>] [--swap <swap>]
[--rxtx-factor <factor>] [--is-public <is-public>]
[--description <description>]
<name> <id> <ram> <disk> <vcpus>
创建一个新的 flavor。
位置参数
<name>新风味的唯一名称。
<id>新风味的唯一 ID。指定 ‘auto’ 将为 ID 生成 UUID。
<ram>内存大小，以 MiB 为单位。
<disk>磁盘大小，以 GiB 为单位。
<vcpus>vcpus 数量
可选参数
--ephemeral <ephemeral>临时空间大小，以 GiB 为单位（默认值为 0）。
--swap <swap>交换空间大小，以 MiB 为单位（默认值为 0）。
--rxtx-factor <factor>RX/TX 因子（默认值为 1）。
--is-public <is-public>使风味可供公众访问（默认值为 true）。
--description <description>风味的自由形式描述。长度限制为 65535 个字符。仅允许可打印字符。（受 API 版本 ‘2.55’ - ‘2.latest’ 支持）
nova flavor-delete¶
usage: nova flavor-delete <flavor>
删除特定的 flavor
位置参数
<flavor>要删除的风味名称或 ID。
nova flavor-key¶
usage: nova flavor-key <flavor> <action> <key=value> [<key=value> ...]
设置或取消 flavor 的 extra_spec。
位置参数
<flavor>风味的名称或 ID。
<action>操作：‘set’ 或 ‘unset’。
<key=value>要设置或删除的 extra_specs（仅在 unset 时需要键）。
nova flavor-list¶
usage: nova flavor-list [--extra-specs] [--all] [--marker <marker>]
[--min-disk <min-disk>] [--min-ram <min-ram>]
[--limit <limit>] [--sort-key <sort-key>]
[--sort-dir <sort-dir>]
打印可用的 ‘flavor’（服务器大小）列表。
可选参数
--extra-specs获取每个风味的 extra-specs。
--all显示所有风味（仅限管理员）。
--marker <marker>上一个页面的最后一个风味 ID；显示 “marker” 之后的风味列表。
--min-disk <min-disk>按最小磁盘空间（以 GiB 为单位）过滤风味。
--min-ram <min-ram>按最小 RAM（以 MiB 为单位）过滤风味。
--limit <limit>要显示的最多风味数量。如果 limit 大于 Nova API 的 ‘CONF.api.max_limit’ 选项，则将使用 ‘CONF.api.max_limit’ 代替。
--sort-key <sort-key>风味列表排序键。
--sort-dir <sort-dir>风味列表排序方向。
nova flavor-show¶
usage: nova flavor-show <flavor>
显示有关给定 flavor 的详细信息。
位置参数
<flavor>风味的名称或 ID。
nova flavor-update¶
usage: nova flavor-update <flavor> <description>
更新现有 flavor 的描述。（受 API 版本 ‘2.55’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
版本 10.0.0 中添加。
位置参数
<flavor>要更新的风味名称或 ID。
<description>风味的自由形式描述。长度限制为 65535 个字符。仅允许可打印字符。
nova force-delete¶
usage: nova force-delete <server>
强制删除服务器。
位置参数
<server>服务器的名称或 ID。
nova get-mks-console¶
usage: nova get-mks-console <server>
获取服务器的 MKS 控制台。（受 API 版本 ‘2.8’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
版本 3.0.0 中添加。
位置参数
<server>服务器的名称或 ID。
nova get-password¶
usage: nova get-password <server> [<private-key>]
获取服务器的管理员密码。 此操作调用元数据服务来查询元数据信息，并且不会从服务器本身读取密码信息。
位置参数
<server>服务器的名称或 ID。
<private-key>私钥（用于本地解密密码）（可选）。如果指定，该命令将显示明文（解密）VM 密码。如果未指定，将显示加密的 VM 密码。
nova get-rdp-console¶
usage: nova get-rdp-console <server> <console-type>
获取服务器的 rdp 控制台。
位置参数
<server>服务器的名称或 ID。
<console-type>RDP 控制台的类型（“rdp-html5”）。
nova get-serial-console¶
usage: nova get-serial-console [--console-type CONSOLE_TYPE] <server>
获取服务器的串口控制台。
位置参数
<server>服务器的名称或 ID。
可选参数
--console-type CONSOLE_TYPE串行控制台的类型，默认值为“serial”。
nova get-spice-console¶
usage: nova get-spice-console <server> <console-type>
获取服务器的 spice 控制台。
位置参数
<server>服务器的名称或 ID。
<console-type>Spice 控制台的类型（“spice-html5”）。
nova get-vnc-console¶
usage: nova get-vnc-console <server> <console-type>
获取服务器的 vnc 控制台。
位置参数
<server>服务器的名称或 ID。
<console-type>VNC 控制台的类型（“novnc” 或 “xvpvnc”）。
nova host-evacuate¶
usage: nova host-evacuate [--target_host <target_host>] [--force] [--strict]
<host>
从故障主机上撤离所有实例。
位置参数
<host>要搜索的超visor 主机名（或模式）。
警告
如果只想从特定主机撤离，请使用完全限定域名。
可选参数
--target_host <目标主机>目标主机名称。如果未指定主机，调度器将选择一个。
--force通过不验证调度器提供的目标主机来强制撤离。（受 API 版本 ‘2.29’ - ‘2.67’ 支持）
警告
这可能导致实际上无法将服务器撤离到指定的宿主机。建议要么不指定宿主机，让调度器选择一个，要么指定宿主机，而不使用
--force。--strict使用完全匹配的超visor 主机名强制撤离
nova host-evacuate-live¶
usage: nova host-evacuate-live [--target-host <target_host>] [--block-migrate]
[--max-servers <max_servers>] [--force]
[--strict]
<host>
将指定主机上的所有实例实时迁移到其他可用主机。
位置参数
<host>主机名称。要搜索的超visor 主机名（或模式）。
警告
如果只想从特定主机实时迁移，请使用完全限定域名。
可选参数
--target-host <目标主机>目标主机名称。如果未指定主机，调度器将选择一个。
--block-migrate启用块迁移。（默认=auto）（受 API 版本 ‘2.25’ - ‘2.latest’ 支持）
--max-servers <max_servers>同时实时迁移的最大服务器数量
--force通过不验证调度器提供的目标主机来强制实时迁移。（受 API 版本 ‘2.30’ - ‘2.67’ 支持）
警告
这可能导致实际上无法将服务器实时迁移到指定的宿主机。建议要么不指定宿主机，让调度器选择一个，要么指定宿主机，而不使用
--force。--strict实时撤离具有完全匹配的超visor 主机名
nova host-meta¶
usage: nova host-meta [--strict] <host> <action> <key=value> [<key=value> ...]
设置或删除主机上所有实例的元数据。
位置参数
<host>要搜索的超visor 主机名（或模式）。
警告
如果只想更新特定主机的元数据，请使用完全限定域名。
<action>操作：‘set’ 或 ‘delete’
<key=value>要设置或删除的元数据（在删除时仅需要键）。
可选参数
--strict将 host-meta 设置为具有完全匹配主机名的超visor
nova host-servers-migrate¶
usage: nova host-servers-migrate [--strict] <host>
将指定主机上的所有实例冷迁移到其他可用主机。
位置参数
<host>主机名称。要搜索的超visor 主机名（或模式）。
警告
如果只想从特定主机冷迁移，请使用完全限定域名。
可选参数
--strict使用完全匹配的超visor 主机名迁移主机
nova hypervisor-list¶
usage: nova hypervisor-list [--matching <hostname>] [--marker <marker>]
[--limit <limit>]
列出 hypervisor。（受 API 版本 ‘2.0’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
可选参数
--matching <主机名>列出与给定 <主机名> 匹配的超visor。如果使用 matching，则会忽略 limit 和 marker 选项。
--marker <marker>上一个页面的最后一个超visor；显示 “marker” 之后的超visor 列表。（受 API 版本 ‘2.33’ - ‘2.latest’ 支持）
--limit <limit>要显示的超visor 最大数量。如果 limit 大于 Nova API 的 ‘CONF.api.max_limit’ 选项，则将使用 ‘CONF.api.max_limit’ 代替。（受 API 版本 ‘2.33’ - ‘2.latest’ 支持）
nova hypervisor-servers¶
usage: nova hypervisor-servers <hostname>
列出属于特定超visor的服务器。
位置参数
<hostname>要搜索的超visor 主机名（或模式）。
nova hypervisor-show¶
usage: nova hypervisor-show [--wrap <integer>] <hypervisor>
显示指定超visor的详细信息。
位置参数
<hypervisor>超visor 的名称或 ID。从 microversion 2.53 开始，ID 必须是 UUID。
可选参数
--wrap <整数>将输出换行到指定的长度。默认值为 40 或 0 以禁用
nova hypervisor-stats¶
usage: nova hypervisor-stats
获取所有计算节点上的 hypervisor 统计信息。
nova hypervisor-uptime¶
usage: nova hypervisor-uptime <hypervisor>
显示指定超visor的运行时间。
位置参数
<hypervisor>超visor 的名称或 ID。从 microversion 2.53 开始，ID 必须是 UUID。
nova image-create¶
usage: nova image-create [--metadata <key=value>] [--show] [--poll]
<server> <name>
通过拍摄正在运行的服务器的快照来创建新镜像。
位置参数
<server>服务器的名称或 ID。
<name>快照的名称。
可选参数
--metadata <键=值>将任意键/值元数据记录到元数据服务器上的 /meta_data.json 文件中。可以多次指定。
--show打印镜像信息。
--poll报告快照进度并轮询直到镜像创建完成。
nova instance-action¶
usage: nova instance-action <server> <request_id>
显示一个操作。
位置参数
<server>要显示操作的服务器的名称或 UUID。只有 UUID 才能用于显示已删除服务器的操作。（受 API 版本 ‘2.21’ - ‘2.latest’ 支持）
<request_id>要获取的操作的请求 ID。
nova instance-action-list¶
usage: nova instance-action-list [--marker <marker>] [--limit <limit>]
[--changes-since <changes_since>]
[--changes-before <changes_before>]
<server>
列出服务器上的操作。
位置参数
<server>要列出操作的服务器名称或 UUID。只有 UUID 才能用于列出已删除服务器上的操作。（受 API 版本 ‘2.21’ - ‘2.latest’ 支持）
可选参数
--marker <marker>上一页的最后一个实例操作；显示 “marker” 之后的动作列表。（受 API 版本 ‘2.58’ - ‘2.latest’ 支持）
--limit <limit>要显示的实例操作的最大数量。请注意，服务器上有一个可配置的最大限制，并且使用的限制将是此处请求的限制与服务器中配置的限制之间的最小值。（受 API 版本 ‘2.58’ - ‘2.latest’ 支持）
--changes-since <changes_since>仅列出在某个时间点之后或等于某个时间点更改的实例操作。提供的时间应为 ISO 8061 格式的时间，例如 2016-03-04T06:27:59Z。（受 API 版本 ‘2.58’ - ‘2.latest’ 支持）
--changes-before <changes_before>仅列出在某个时间点之前或等于某个时间点更改的实例操作。提供的时间应为 ISO 8061 格式的时间，例如 2016-03-04T06:27:59Z。（受 API 版本 ‘2.66’ - ‘2.latest’ 支持）
nova instance-usage-audit-log¶
usage: nova instance-usage-audit-log [--before <before>]
列出/获取服务器使用情况审计。
可选参数
--before <before>按日期和时间过滤响应，该日期和时间早于要列出的使用审计。日期和时间戳格式如下：CCYY-MM-DD hh:mm:ss.NNNNNN 例如 2015-08-27 09:49:58 或 2015-08-27 09:49:58.123456。
nova interface-attach¶
usage: nova interface-attach [--port-id <port_id>] [--net-id <net_id>]
[--fixed-ip <fixed_ip>] [--tag <tag>]
<server>
将网络接口附加到服务器。
位置参数
<server>服务器的名称或 ID。
可选参数
--port-id <port_id>端口 ID。
--net-id <net_id>网络 ID
--fixed-ip <fixed_ip>请求的固定 IP。
--tag <tag>附加接口的标签。（受 API 版本 ‘2.49’ - ‘2.latest’ 支持）
nova interface-detach¶
usage: nova interface-detach <server> <port_id>
将网络接口从服务器分离。
位置参数
<server>服务器的名称或 ID。
<port_id>端口 ID。
nova interface-list¶
usage: nova interface-list <server>
列出附加到服务器的接口。
位置参数
<server>服务器的名称或 ID。
nova keypair-add¶
usage: nova keypair-add [--pub-key <pub-key>] [--key-type <key-type>]
[--user <user-id>]
<name>
创建用于服务器的新密钥对。
位置参数
<name>密钥名称。
可选参数
--pub-key <pub-key>公共 ssh 密钥的路径。
--key-type <key-type>密钥对类型。可以是 ssh 或 x509。（受 API 版本 ‘2.2’ - ‘2.latest’ 支持）
--user <user-id>要添加密钥对的用户 ID（仅限管理员）。（受 API 版本 ‘2.10’ - ‘2.latest’ 支持）
nova keypair-delete¶
usage: nova keypair-delete [--user <user-id>] <name>
删除按名称给定的密钥对。（受 API 版本 ‘2.0’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
位置参数
<name>要删除的密钥对名称。
可选参数
--user <user-id>密钥对所有者的 ID（仅限管理员）。
nova keypair-list¶
usage: nova keypair-list [--user <user-id>] [--marker <marker>]
[--limit <limit>]
打印用户的密钥对列表（受 API 版本 ‘2.0’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
可选参数
--user <user-id>列出指定用户 ID 的密钥对（仅限管理员）。
--marker <marker>上一页的最后一个密钥对；显示 “marker” 之后的密钥对列表。
--limit <limit>要显示的密钥对的最大数量。如果限制大于 Nova API 的 ‘CONF.api.max_limit’ 选项，则将使用 ‘CONF.api.max_limit’ 选项作为限制。
nova keypair-show¶
usage: nova keypair-show [--user <user-id>] <keypair>
显示给定密钥对的详细信息。（受 API 版本 ‘2.0’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
位置参数
<keypair>密钥对名称。
可选参数
--user <user-id>密钥对所有者的 ID（仅限管理员）。
nova limits¶
usage: nova limits [--tenant [<tenant>]] [--reserved]
打印速率和绝对限制。
可选参数
--tenant [<tenant>]显示单个租户的信息（仅限管理员）。
--reserved包含预留计数。
nova list¶
usage: nova list [--reservation-id <reservation-id>] [--ip <ip-regexp>]
[--ip6 <ip6-regexp>] [--name <name-regexp>]
[--status <status>] [--flavor <flavor>] [--image <image>]
[--host <hostname>] [--all-tenants [<0|1>]]
[--tenant [<tenant>]] [--user [<user>]] [--deleted]
[--fields <fields>] [--minimal]
[--sort <key>[:<direction>]] [--marker <marker>]
[--limit <limit>] [--availability-zone <availability_zone>]
[--key-name <key_name>] [--[no-]config-drive]
[--progress <progress>] [--vm-state <vm_state>]
[--task-state <task_state>] [--power-state <power_state>]
[--changes-since <changes_since>]
[--changes-before <changes_before>]
[--tags <tags>] [--tags-any <tags-any>]
[--not-tags <not-tags>] [--not-tags-any <not-tags-any>]
[--locked]
列出服务器。
请注意，从微版本 2.69 开始，在部署中的部分基础设施故障期间，此命令的输出可能会返回故障域中存在的服务器的部分结果。
可选参数
--reservation-id <reservation-id>仅返回与 reservation-id 匹配的服务器。
--ip <ip-regexp>使用正则表达式匹配 IP 地址进行搜索。
--ip6 <ip6-regexp>使用正则表达式匹配 IPv6 地址进行搜索。
--name <name-regexp>使用正则表达式匹配名称进行搜索。
--status <status>按服务器状态搜索。
--flavor <flavor>按风味名称或 ID 搜索。
--image <image>按镜像名称或 ID 搜索。
--host <hostname>按分配给它们的宿主机搜索服务器（仅限管理员）。
--all-tenants [<0|1>]显示所有租户的信息（仅限管理员）。
--tenant [<tenant>]显示单个租户的信息（仅限管理员）。
--user [<user>]显示单个用户的信息（仅限管理员，直到微版本 2.82）。
--deleted仅显示已删除的服务器（仅限管理员）。
--fields <fields>要显示的逗号分隔的字段列表。使用 show 命令查看可用的字段。
--minimal仅获取 UUID 和名称。
--sort <key>[:<direction>]逗号分隔的排序键和方向列表，格式为 <key>[:<asc|desc>]。如果未指定，则方向默认为降序。
--marker <marker>上一页的最后一个服务器 UUID；显示 “marker” 之后的服务器列表。
--limit <limit>要显示的服务器的最大数量。如果 limit == -1，将显示所有服务器。如果限制大于 Nova API 的 ‘CONF.api.max_limit’ 选项，则将使用 ‘CONF.api.max_limit’ 选项作为限制。
--availability-zone <availability_zone>根据其可用区显示服务器（仅限管理员，直到微版本 2.82）。
--key-name <key_name>根据其密钥对名称显示服务器（仅限管理员，直到微版本 2.82）。
--config-drive显示具有附加配置驱动器的服务器。它与 ‘–no-config-drive’ 互斥。（仅限管理员，直到微版本 2.82）。
--no-config-drive显示没有附加配置驱动器的服务器。它与 ‘–config-drive’ 互斥。（仅限管理员，直到微版本 2.82）。
--progress <progress>根据其进度值显示服务器（仅限管理员，直到微版本 2.82）。
--vm-state <vm_state>根据其 vm_state 值显示服务器（仅限管理员，直到微版本 2.82）。
--task-state <task_state>根据其 task_state 值显示服务器（仅限管理员，直到微版本 2.82）。
--power-state <power_state>根据其 power_state 值显示服务器（仅限管理员，直到微版本 2.82）。
--changes-since <changes_since>仅列出在某个时间点之后或等于某个时间点更改的服务器。提供的时间应为 ISO 8061 格式的时间，例如 2016-03-04T06:27:59Z 。
--changes-before <changes_before>仅列出在某个时间点之前或等于某个时间点更改的服务器。提供的时间应为 ISO 8061 格式的时间，例如 2016-03-05T06:27:59Z 。（受 API 版本 ‘2.66’ - ‘2.latest’ 支持）
--tags <标签>给定的标签必须全部存在于服务器中才能包含在列表结果中。在这种情况下，布尔表达式为 ‘t1 AND t2’。标签必须用逗号分隔：–tags <tag1,tag2>（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）
--tags-any <tags-any>如果存在给定的标签之一，服务器将包含在列表结果中。在这种情况下，布尔表达式为 ‘t1 OR t2’。标签必须用逗号分隔：–tags-any <tag1,tag2>（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）
--not-tags <not-tags>仅包含不具有给定标签的服务器。在这种情况下，布尔表达式为 ‘NOT(t1 AND t2)’。标签必须用逗号分隔：–not-tags <tag1,tag2>（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）
--not-tags-any <not-tags-any>仅包含不具有给定标签中至少一个标签的服务器。在这种情况下，布尔表达式为 ‘NOT(t1 OR t2)’。标签必须用逗号分隔：–not-tags-any <tag1,tag2>（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）
--locked <locked>根据其锁定值显示服务器。必须指定一个值；例如，‘true’ 将仅列出锁定的服务器，而 ‘false’ 将仅列出未锁定的服务器。（受 API 版本 ‘2.73’ - ‘2.latest’ 支持）
nova list-secgroup¶
usage: nova list-secgroup <server>
列出服务器的安全组。
位置参数
<server>服务器的名称或 ID。
nova live-migration¶
usage: nova live-migration [--block-migrate] [--force] <server> [<host>]
将正在运行的服务器迁移到新机器。
位置参数
<server>服务器的名称或 ID。
<host>目标主机名。如果未指定主机，则调度程序将选择一个。
可选参数
--block-migrate如果是 block_migration，则为 True。（默认=auto:live_migration）（受 API 版本 ‘2.25’ - ‘2.latest’ 支持）
--force通过不验证调度器提供的目标主机来强制实时迁移。（受 API 版本 ‘2.30’ - ‘2.67’ 支持）
警告
这可能会导致实际将服务器迁移到指定主机的失败。建议要么不指定主机，让调度程序选择一个，要么指定一个主机，而不要使用
--force。
nova live-migration-abort¶
usage: nova live-migration-abort <server> <migration>
中止正在进行中的实时迁移。（受 API 版本 ‘2.24’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
对于从 2.24 到 2.64 的微版本，迁移状态必须为 running；对于微版本 2.65 及更高版本，迁移状态也可以为 queued 和 preparing。
在版本 3.3.0 中添加。
位置参数
<server>服务器的名称或 ID。
<migration>迁移的 ID。
nova live-migration-force-complete¶
usage: nova live-migration-force-complete <server> <migration>
强制正在进行的实时迁移完成。（受 API 版本 ‘2.22’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
在版本 3.3.0 中添加。
位置参数
<server>服务器的名称或 ID。
<migration>迁移的 ID。
nova lock¶
usage: nova lock [--reason <reason>] <server>
锁定服务器。普通（非管理员）用户将无法对锁定的服务器执行操作。
位置参数
<server>服务器的名称或 ID。
可选参数
--reason <reason>锁定服务器的原因。（受 API 版本 ‘2.73’ - ‘2.latest’ 支持）
nova meta¶
usage: nova meta <server> <action> <key=value> [<key=value> ...]
设置或删除服务器上的元数据。
位置参数
<server>服务器的名称或 ID。
<action>操作：‘set’ 或 ‘delete’。
<key=value>要设置或删除的元数据（仅在删除时需要键）。
nova migrate¶
usage: nova migrate [--host <host>] [--poll] <server>
迁移服务器。调度器将选择新的宿主机。
位置参数
<server>服务器的名称或 ID。
可选参数
--host <host>目标主机名。（受 API 版本 ‘2.56’ - ‘2.latest’ 支持）
--poll报告服务器迁移进度，直到完成为止。
nova migration-list¶
usage: nova migration-list [--instance-uuid <instance_uuid>]
[--host <host>]
[--status <status>]
[--migration-type <migration_type>]
[--source-compute <source_compute>]
[--marker <marker>]
[--limit <limit>]
[--changes-since <changes_since>]
[--changes-before <changes_before>]
[--project-id <project_id>]
[--user-id <user_id>]
打印迁移列表。
示例
要查看从计算服务主机进行的撤离操作的列表
nova migration-list --migration-type evacuation --source-compute host.foo.bar
可选参数
--instance-uuid <instance_uuid>获取给定实例的迁移。
--host <host>获取给定源或目标主机的迁移。
--status <status>获取给定状态的迁移。
--migration-type <migration_type>按类型过滤迁移。有效值为
evacuation
live-migration
迁移
注意
这是一个冷迁移。
调整大小
--source-compute <source_compute>按源计算主机名过滤迁移。
--marker <marker>上一页的最后一个迁移；显示 “marker” 之后的迁移列表。请注意，marker 是迁移 UUID。（受 API 版本 ‘2.59’ - ‘2.latest’ 支持）
--limit <limit>要显示的迁移的最大数量。请注意，服务器上有一个可配置的最大限制，并且使用的限制将是此处请求的限制与服务器中配置的限制之间的最小值。（受 API 版本 ‘2.59’ - ‘2.latest’ 支持）
--changes-since <changes_since>仅列出在某个时间点之后或等于某个时间点更改的迁移。提供的时间应为 ISO 8061 格式的时间，例如 2016-03-04T06:27:59Z 。（受 API 版本 ‘2.59’ - ‘2.latest’ 支持）
--changes-before <changes_before>仅列出在某个时间点之前或等于某个时间点更改的迁移。提供的时间应为 ISO 8061 格式的时间，例如 2016-03-04T06:27:59Z 。（受 API 版本 ‘2.66’ - ‘2.latest’ 支持）
--project-id <project_id>按给定的项目 ID 过滤迁移。（受 API 版本 ‘2.80’ - ‘2.latest’ 支持）
--user-id <user_id>按给定的用户 ID 过滤迁移。（受 API 版本 ‘2.80’ - ‘2.latest’ 支持）
nova pause¶
usage: nova pause <server>
暂停服务器。
位置参数
<server>服务器的名称或 ID。
nova quota-class-show¶
usage: nova quota-class-show <class>
列出配额类别的配额。
位置参数
<class>要列出配额的配额类名称。
nova quota-class-update¶
usage: nova quota-class-update [--instances <instances>] [--cores <cores>]
[--ram <ram>]
[--metadata-items <metadata-items>]
[--key-pairs <key-pairs>]
[--server-groups <server-groups>]
[--server-group-members <server-group-members>]
<class>
更新配额类别的配额。（受 API 版本 ‘2.0’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
位置参数
<class>要设置配额的配额类名称。
可选参数
--instances <instances>“instances” 配额的新值。
--cores <cores>“cores” 配额的新值。
--ram <ram>“ram” 配额的新值。
--metadata-items <metadata-items>“metadata-items” 配额的新值。
--key-pairs <key-pairs>“key-pairs” 配额的新值。
--server-groups <server-groups>“server-groups” 配额的新值。
--server-group-members <server-group-members>“server-group-members”配额的新值。
nova quota-defaults¶
usage: nova quota-defaults [--tenant <tenant-id>]
列出租户的默认配额。
可选参数
--tenant <tenant-id>要列出默认配额的租户 ID。
nova quota-delete¶
usage: nova quota-delete --tenant <tenant-id> [--user <user-id>]
删除租户/用户的配额，使其配额将恢复到默认值。
可选参数
--tenant <tenant-id>要删除配额的租户 ID。
--user <user-id>要删除配额的用户 ID。
nova quota-show¶
usage: nova quota-show [--tenant <tenant-id>] [--user <user-id>] [--detail]
列出租户/用户的配额。
可选参数
--tenant <tenant-id>要列出配额的租户 ID。
--user <user-id>要列出配额的用户 ID。
--detail显示详细信息（限制、已预留、已使用）。
nova quota-update¶
usage: nova quota-update [--user <user-id>] [--instances <instances>]
[--cores <cores>] [--ram <ram>]
[--metadata-items <metadata-items>]
[--key-pairs <key-pairs>]
[--server-groups <server-groups>]
[--server-group-members <server-group-members>]
[--force]
<tenant-id>
更新租户/用户的配额。（受 API 版本 ‘2.0’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
位置参数
<tenant-id>要设置配额的租户 ID。
可选参数
--user <user-id>要设置配额的用户 ID。
--instances <instances>“instances” 配额的新值。
--cores <cores>“cores” 配额的新值。
--ram <ram>“ram” 配额的新值。
--metadata-items <metadata-items>“metadata-items” 配额的新值。
--key-pairs <key-pairs>“key-pairs” 配额的新值。
--server-groups <server-groups>“server-groups” 配额的新值。
--server-group-members <server-group-members>“server-group-members”配额的新值。
--force即使已使用和已预留的配额超过新配额，是否强制更新配额。
nova reboot¶
usage: nova reboot [--hard] [--poll] <server> [<server> ...]
重启服务器。
位置参数
<server>服务器的名称或 ID。
可选参数
--hard执行硬重启（而不是软重启）。注意：Ironic 目前不支持软重启；因此，裸机节点将始终执行硬重启，无论是否使用此选项。
--poll轮询直到重启完成。
nova rebuild¶
usage: nova rebuild [--rebuild-password <rebuild-password>] [--poll]
[--minimal] [--preserve-ephemeral] [--name <name>]
[--description <description>] [--meta <key=value>]
[--key-name <key-name>] [--key-unset]
[--user-data <user-data>] [--user-data-unset]
[--trusted-image-certificate-id <trusted-image-certificate-id>]
[--trusted-image-certificates-unset]
[--hostname <hostname>]
<server> <image>
关闭、重新镜像并重启服务器。
位置参数
<server>服务器的名称或 ID。
<image>新的镜像名称或 ID。
可选参数
--rebuild-password <rebuild-password>在重建的服务器上设置提供的管理员密码。
--poll报告服务器重建进度，直到完成。
--minimal在显示服务器时跳过 flavor/镜像查找。
--preserve-ephemeral在重建时保留默认的临时存储分区。
--name <name>新服务器的名称。
--description <description>服务器的新描述。（受 API 版本 ‘2.19’ - ‘2.latest’ 支持）
--meta <键=值>将任意键/值元数据记录到元数据服务器上的 /meta_data.json 文件中。可以多次指定。
--key-name <密钥名称>要设置为服务器的密钥对名称。不能与 ‘–key-unset’ 选项一起指定。（受 API 版本 ‘2.54’ - ‘2.latest’ 支持）
--key-unset取消设置服务器中的密钥对。不能与 ‘–key-name’ 选项一起指定。（受 API 版本 ‘2.54’ - ‘2.latest’ 支持）
--user-data <用户数据>要传递给元数据服务器的用户数据文件。（受 API 版本 ‘2.57’ - ‘2.latest’ 支持）
--user-data-unset取消设置服务器中的 user_data。不能与 ‘–user-data’ 选项一起指定。（受 API 版本 ‘2.57’ - ‘2.latest’ 支持）
--trusted-image-certificate-id <受信任镜像证书 ID>用于在镜像签名验证过程中验证证书的受信任镜像证书 ID。默认值为 env[OS_TRUSTED_IMAGE_CERTIFICATE_IDS]。可以通过多次指定来传递多个受信任镜像证书 ID。（受 API 版本 ‘2.63’ - ‘2.latest’ 支持）
--trusted-image-certificates-unset取消设置服务器中的 trusted_image_certificates。不能与
--trusted-image-certificate-id选项一起指定。（受 API 版本 ‘2.63’ - ‘2.latest’ 支持）--hostname <主机名>实例的新主机名。这只会更新存储在元数据服务器中的主机名：需要在客户机上运行的实用程序才能将这些更改传播到客户机。（受 API 版本 ‘2.90’ - ‘2.latest’ 支持）
nova refresh-network¶
usage: nova refresh-network <server>
刷新服务器网络信息。
位置参数
<server>要刷新网络缓存的服务器名称或 ID，从 neutron。（仅限管理员）
nova remove-secgroup¶
usage: nova remove-secgroup <server> <secgroup>
从服务器移除安全组。
位置参数
<server>服务器的名称或 ID。
<secgroup>安全组的名称。
nova rescue¶
usage: nova rescue [--password <password>] [--image <image>] <server>
将服务器重新启动到救援模式，从初始镜像或指定的镜像启动机器，并将当前启动磁盘作为辅助磁盘附加。
位置参数
<server>服务器的名称或 ID。
可选参数
--password <密码>要在救援环境中设置的管理员密码。
--image <image>要救援的镜像。
nova reset-network¶
usage: nova reset-network <server>
重置服务器的网络。
位置参数
<server>服务器的名称或 ID。
nova reset-state¶
usage: nova reset-state [--all-tenants] [--active] <server> [<server> ...]
重置服务器的状态。
位置参数
<server>服务器的名称或 ID。
可选参数
--all-tenants通过名称重置另一个租户中的服务器状态（仅限管理员）。
--active请求将服务器重置为“active”状态，而不是“error”状态（默认）。
nova resize¶
usage: nova resize [--poll] <server> <flavor>
调整服务器的大小。
位置参数
<server>服务器的名称或 ID。
<flavor>新的 flavor 名称或 ID。
可选参数
--poll报告服务器调整大小的进度，直到完成。
nova resize-confirm¶
usage: nova resize-confirm <server>
确认之前的调整大小操作。
位置参数
<server>服务器的名称或 ID。
nova resize-revert¶
usage: nova resize-revert <server>
撤销之前的调整大小（并返回到之前的 VM）。
位置参数
<server>服务器的名称或 ID。
nova restore¶
usage: nova restore <server>
恢复一个软删除的服务器。
位置参数
<server>服务器的名称或 ID。
nova resume¶
usage: nova resume <server>
恢复服务器。
位置参数
<server>服务器的名称或 ID。
nova server-group-create¶
usage: nova server-group-create [--rules <key=value>] <name> <policy>
创建具有指定细节的新服务器组。
位置参数
<name>服务器组名称。
<policy>服务器组的策略。
可选参数
--rule服务器组的策略规则。（受 API 版本 ‘2.64’ - ‘2.latest’ 支持）。当前，仅支持
anti-affinity策略的max_server_per_host规则。max_server_per_host规则允许指定可以驻留在同一计算主机上的反亲和组的成员数量。如果未指定，则来自同一反亲和组的只有一个成员可以驻留在给定主机上。
nova server-group-delete¶
usage: nova server-group-delete <id> [<id> ...]
删除特定的服务器组。
位置参数
<id>要删除的服务器组的唯一 ID。
nova server-group-get¶
usage: nova server-group-get <id>
获取特定的服务器组。
位置参数
<id>要获取的服务器组的唯一 ID。
nova server-group-list¶
usage: nova server-group-list [--limit <limit>] [--offset <offset>]
[--all-projects]
打印所有服务器组的列表。
可选参数
--limit <limit>要显示的服务器组的最大数量。如果 limit 大于 Nova API 的 ‘CONF.api.max_limit’ 选项，则将使用 ‘CONF.api.max_limit’ 代替。
--offset <offset>用于返回服务器组切片的组列表的偏移量。与 limit 一起使用。
--all-projects显示所有项目的服务器组（仅限管理员）。
nova server-migration-list¶
usage: nova server-migration-list <server>
获取指定服务器的迁移列表。（受 API 版本 ‘2.23’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
在版本 3.3.0 中添加。
位置参数
<server>服务器的名称或 ID。
nova server-migration-show¶
usage: nova server-migration-show <server> <migration>
获取指定服务器的迁移。（受 API 版本 ‘2.23’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
在版本 3.3.0 中添加。
位置参数
<server>服务器的名称或 ID。
<migration>迁移的 ID。
nova server-tag-add¶
usage: nova server-tag-add <server> <tag> [<tag> ...]
向服务器添加一个或多个标签。（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
在版本 4.1.0 中添加。
位置参数
<server>服务器的名称或 ID。
<tag>要添加的标签。
nova server-tag-delete¶
usage: nova server-tag-delete <server> <tag> [<tag> ...]
从服务器删除一个或多个标签。（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
在版本 4.1.0 中添加。
位置参数
<server>服务器的名称或 ID。
<tag>要删除的标签。
nova server-tag-delete-all¶
usage: nova server-tag-delete-all <server>
删除服务器上的所有标签。（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
在版本 4.1.0 中添加。
位置参数
<server>服务器的名称或 ID。
nova server-tag-list¶
usage: nova server-tag-list <server>
获取服务器上的标签列表。（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
在版本 4.1.0 中添加。
位置参数
<server>服务器的名称或 ID。
nova server-tag-set¶
usage: nova server-tag-set <server> <tags> [<tags> ...]
将标签列表设置为服务器。（受 API 版本 ‘2.26’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
在版本 4.1.0 中添加。
位置参数
<server>服务器的名称或 ID。
<tags>要设置的标签。
nova server-topology¶
usage: nova server-topology <server>
检索服务器 NUMA 拓扑信息。特定于主机的字段仅对具有管理员角色的用户可见。（受 API 版本 ‘2.78’ - ‘2.latest’ 支持）
在版本 15.1.0 中添加。
位置参数
<server>服务器的名称或 ID。
nova service-delete¶
usage: nova service-delete <id>
删除服务。
重要提示
如果删除 nova-compute 服务，请确保在删除使用此命令的服务之前，先停止物理主机上的实际 nova-compute 进程。否则，运行的服务可能会重新创建数据库中孤立的 compute_nodes 表记录。
位置参数
<id>服务的 UUID 作为 ID。（受 API 版本 ‘2.53’ - ‘2.latest’ 支持）
nova service-disable¶
usage: nova service-disable [--reason <reason>] <id>
禁用服务。
位置参数
<id>服务的 UUID 作为 ID。（受 API 版本 ‘2.53’ - ‘2.latest’ 支持）
可选参数
--reason <reason>禁用服务的理由。
nova service-enable¶
usage: nova service-enable <id>
启用服务。
位置参数
<id>服务的 UUID 作为 ID。（受 API 版本 ‘2.53’ - ‘2.latest’ 支持）
nova service-force-down¶
usage: nova service-force-down [--unset] <id>
强制服务进入 down 状态。（受 API 版本 ‘2.11’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
在版本 2.27.0 中添加。
位置参数
<id>服务的 UUID 作为 ID。（受 API 版本 ‘2.53’ - ‘2.latest’ 支持）
可选参数
--unset取消设置服务的 forced_down 状态。
nova service-list¶
usage: nova service-list [--host <hostname>] [--binary <binary>]
显示所有正在运行的服务的列表。按宿主机和二进制过滤。
请注意，从微版本 2.69 开始，在部署中的部分基础设施故障期间，此命令的输出可能会返回故障域中存在的服务的部分结果。
可选参数
--host <hostname>主机的名称。
--binary <binary>服务二进制文件。
nova set-password¶
usage: nova set-password <server>
更改服务器的管理员密码。
位置参数
<server>服务器的名称或 ID。
nova shelve¶
usage: nova shelve <server>
搁置服务器。
位置参数
<server>服务器的名称或 ID。
nova shelve-offload¶
usage: nova shelve-offload <server>
从计算节点移除搁置的服务器。
位置参数
<server>服务器的名称或 ID。
nova show¶
usage: nova show [--minimal] [--wrap <integer>] <server>
显示给定服务器的详细信息。
请注意，从微版本 2.69 开始，在部署中的部分基础设施故障期间，此命令的输出可能会返回故障域中存在的服务器的部分结果。
位置参数
<server>服务器的名称或 ID。
可选参数
--minimal在显示服务器时跳过 flavor/镜像查找。
--wrap <整数>将输出包装到指定的长度，或 0 以禁用。
nova ssh¶
usage: nova ssh [--port PORT] [--address-type ADDRESS_TYPE]
[--network <network>] [--ipv6] [--login <login>] [-i IDENTITY]
[--extra-opts EXTRA]
<server>
通过 SSH 连接到服务器。
位置参数
<server>服务器的名称或 ID。
可选参数
--port PORT可选标志，指示要使用的 ssh 端口。（默认=22）
--address-type ADDRESS_TYPE可选标志，指示要使用的 IP 类型。可能的值包括 fixed 和 floating（默认）。
--network <network>用于 ssh 的网络。
--ipv6可选标志，指示是否使用附加到服务器的 IPv6 地址。（默认使用 IPv4 地址）
--login <login>要使用的登录名。
-i IDENTITY, --identity IDENTITY私钥文件，与 ssh 命令的 -i 选项相同。
--extra-opts EXTRA要传递给 ssh 的额外选项。请参阅：man ssh。
nova start¶
usage: nova start [--all-tenants] <server> [<server> ...]
启动服务器。
位置参数
<server>服务器的名称或 ID。
可选参数
--all-tenants以名称方式启动另一个租户中的服务器（仅限管理员）。
nova stop¶
usage: nova stop [--all-tenants] <server> [<server> ...]
停止服务器。
位置参数
<server>服务器的名称或 ID。
可选参数
--all-tenants以名称方式停止另一个租户中的服务器（仅限管理员）。
nova suspend¶
usage: nova suspend <server>
暂停服务器。
位置参数
<server>服务器的名称或 ID。
nova trigger-crash-dump¶
usage: nova trigger-crash-dump <server>
触发实例中的崩溃转储。（受 API 版本 ‘2.17’ - ‘2.latest’ 支持）[提示：使用 ‘–os-compute-api-version’ 标志显示正确的版本帮助信息]
在版本 3.3.0 中添加。
位置参数
<server>服务器的名称或 ID。
nova unlock¶
usage: nova unlock <server>
解锁服务器。
位置参数
<server>服务器的名称或 ID。
nova unpause¶
usage: nova unpause <server>
取消暂停服务器。
位置参数
<server>服务器的名称或 ID。
nova unrescue¶
usage: nova unrescue <server>
从正常启动磁盘再次启动服务器。
位置参数
<server>服务器的名称或 ID。
nova unshelve¶
usage: nova unshelve [--availability-zone <availability_zone>] <server>
取消挂起服务器。
位置参数
<server>服务器的名称或 ID。
可选参数
--availability-zone <availability_zone>将
SHELVED_OFFLOADED服务器卸载到可用性区域的名称。（受 API 版本 ‘2.77’ - ‘2.latest’ 支持）
nova update¶
usage: nova update [--name <name>] [--description <description>]
[--hostname <hostname>]
<server>
更新服务器的属性。
位置参数
<server>服务器的名称（旧名称）或 ID。
可选参数
--name <name>服务器的新名称。
--description <description>服务器的新描述。如果等于空字符串（例如“”），则将删除服务器描述。（受 API 版本 ‘2.19’ - ‘2.latest’ 支持）
--hostname <主机名>实例的新主机名。这只会更新存储在元数据服务器中的主机名：需要在客户机上运行的实用程序才能将这些更改传播到客户机。（受 API 版本 ‘2.90’ - ‘2.latest’ 支持）
nova usage¶
usage: nova usage [--start <start>] [--end <end>] [--tenant <tenant-id>]
显示单个租户的使用情况数据。
可选参数
--start <start>使用范围开始日期，例如 2012-01-20。（默认：4 周前）
--end <end>使用范围结束日期，例如 2012-01-20。（默认：明天）
--tenant <tenant-id>要获取使用情况的租户 UUID。
nova usage-list¶
usage: nova usage-list [--start <start>] [--end <end>]
列出所有租户的使用情况数据。
可选参数
--start <start>使用范围开始日期，例如 2012-01-20。（默认：4 周前）
--end <end>使用范围结束日期，例如 2012-01-20。（默认：明天）
nova version-list¶
usage: nova version-list
列出所有 API 版本。
nova volume-attach¶
usage: nova volume-attach [--delete-on-termination] [--tag <tag>]
<server> <volume> [<device>]
将卷附加到服务器。
位置参数
<server>服务器的名称或 ID。
<volume>要附加的卷的 ID。
<device>设备名称，例如 /dev/vdb。使用“auto”进行自动分配（如果受支持）。Libvirt 驱动程序将使用默认设备名称。
可选参数
--tag <tag>附加卷的标签。（受 API 版本 ‘2.49’ - ‘2.latest’ 支持）
--delete-on-termination指定在销毁服务器时是否应删除附加的卷。默认情况下，在销毁服务器时不会删除附加的卷。（受 API 版本 ‘2.79’ - ‘2.latest’ 支持）
nova volume-attachments¶
usage: nova volume-attachments <server>
列出附加到服务器的所有卷。
位置参数
<server>服务器的名称或 ID。
nova volume-detach¶
usage: nova volume-detach <server> <volume>
从服务器分离卷。
位置参数
<server>服务器的名称或 ID。
<volume>要分离的卷的 ID。
nova volume-update¶
usage: nova volume-update [--[no-]delete-on-termination]
<server> <src_volume> <dest_volume>
更新服务器上的附件。将数据从附加的卷迁移到指定的可用卷，并交换到新的卷上的活动附件。
位置参数
<server>服务器的名称或 ID。
<src_volume>源（原始）卷的 ID。
<dest_volume>目标卷的 ID。
可选参数
--delete-on-termination指定在服务器销毁时应删除该卷。它与 ‘–no-delete-on-termination’ 互斥。（受 API 版本 ‘2.85’ - ‘2.latest’ 支持）
--no-delete-on-termination指定在服务器销毁时不应删除附加的卷。它与 ‘–delete-on-termination’ 互斥。（受 API 版本 ‘2.85’ - ‘2.latest’ 支持）
nova bash-completion¶
usage: nova bash-completion
将所有命令和选项打印到 stdout，以便 nova.bash_completion 脚本不必对其进行硬编码。
