Red Hat SummitChapter 13. Compute service (nova) command-line client
The nova client is the command-line interface (CLI) for the Compute service (nova) API and its extensions.
This chapter documents nova version 7.1.0.
For help on a specific nova command, enter:
nova help COMMAND
$ nova help COMMAND13.1. nova usage
Copy linkLink copied to clipboard!
Subcommands:
add-fixed-ip- Add new IP address on a network to server.
add-secgroup- Add a Security Group to a server.
agent-create- Create new agent build.
agent-delete- Delete existing agent build.
agent-list- List all builds.
agent-modify- Modify existing agent build.
aggregate-add-host- Add the host to the specified aggregate.
aggregate-create- Create a new aggregate with the specified details.
aggregate-delete- Delete the aggregate.
aggregate-list- Print a list of all aggregates.
aggregate-remove-host- Remove the specified host from the specified aggregate.
aggregate-set-metadata- Update the metadata associated with the aggregate.
aggregate-show- Show details of the specified aggregate.
aggregate-update- Update the aggregate’s name and optionally availability zone.
availability-zone-list- List all the availability zones.
backup- Backup a server by creating a 'backup' type snapshot.
boot- Boot a new server.
cell-capacities- Get cell capacities for all cells or a given cell.
cell-show- Show details of a given cell.
clear-password- Clear the admin password for a server from the metadata server. This action does not actually change the instance server password.
cloudpipe-configure- Update the VPN IP/port of a cloudpipe instance.
cloudpipe-create- Create a cloudpipe instance for the given project.
cloudpipe-list- Print a list of all cloudpipe instances.
console-log- Get console log output of a server.
delete- Immediately shut down and delete specified server(s).
diagnostics- Retrieve server diagnostics.
dns-create- DEPRECATED: Create a DNS entry for domain, name, and IP.
dns-create-private-domain- DEPRECATED: Create the specified DNS domain.
dns-create-public-domain- DEPRECATED: Create the specified DNS domain.
dns-delete- DEPRECATED: Delete the specified DNS entry.
dns-delete-domain- DEPRECATED: Delete the specified DNS domain.
dns-domains- DEPRECATED: Print a list of available dns domains.
dns-list- DEPRECATED: List current DNS entries for domain and IP or domain and name.
evacuate- Evacuate server from failed host.
fixed-ip-get- DEPRECATED: Retrieve info on a fixed IP.
fixed-ip-reserve- DEPRECATED: Reserve a fixed IP.
fixed-ip-unreserve- DEPRECATED: Unreserve a fixed IP.
flavor-access-add- Add flavor access for the given tenant.
flavor-access-list- Print access information about the given flavor.
flavor-access-remove- Remove flavor access for the given tenant.
flavor-create- Create a new flavor.
flavor-delete- Delete a specific flavor
flavor-key- Set or unset extra_spec for a flavor.
flavor-list- Print a list of available 'flavors' (sizes of servers).
flavor-show- Show details about the given flavor.
floating-ip-associate- Associate a floating IP address to a server.
floating-ip-bulk-create- DEPRECATED: Bulk create floating IPs by range (nova-network only).
floating-ip-bulk-delete- DEPRECATED: Bulk delete floating IPs by range (nova-network only).
floating-ip-bulk-list- DEPRECATED: List all floating IPs (nova-network only).
floating-ip-create- DEPRECATED: Allocate a floating IP for the current tenant.
floating-ip-delete- DEPRECATED: De-allocate a floating IP.
floating-ip-disassociate- Disassociate a floating IP address from a server.
floating-ip-list- DEPRECATED: List floating IPs.
floating-ip-pool-list- DEPRECATED: List all floating IP pools.
force-delete- Force delete a server.
get-mks-console- Get an MKS console to a server. (Supported by API versions '2.8' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
get-password- Get the admin password for a server. This operation calls the metadata service to query metadata information and does not read password information from the server itself.
get-rdp-console- Get a rdp console to a server.
get-serial-console- Get a serial console to a server.
get-spice-console- Get a spice console to a server.
get-vnc-console- Get a vnc console to a server.
host-action- Perform a power action on a host.
host-describe- Describe a specific host.
host-evacuate- Evacuate all instances from failed host.
host-evacuate-live- Live migrate all instances of the specified host to other available hosts.
host-list- List all hosts by service.
host-meta- Set or Delete metadata on all instances of a host.
host-servers-migrate- Cold migrate all instances off the specified host to other available hosts.
host-update- Update host settings.
hypervisor-list- List hypervisors. (Supported by API versions '2.0' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
hypervisor-servers- List servers belonging to specific hypervisors.
hypervisor-show- Display the details of the specified hypervisor.
hypervisor-stats- Get hypervisor statistics over all compute nodes.
hypervisor-uptime- Display the uptime of the specified hypervisor.
image-create- Create a new image by taking a snapshot of a running server.
image-delete- DEPRECATED: Delete specified image(s).
image-list- DEPRECATED: Print a list of available images to boot from.
image-meta- DEPRECATED: Set or delete metadata on an image.
image-show- DEPRECATED: Show details about the given image.
instance-action- Show an action.
instance-action-list- List actions on a server.
interface-attach- Attach a network interface to a server.
interface-detach- Detach a network interface from a server.
interface-list- List interfaces attached to a server.
keypair-add- Create a new key pair for use with servers.
keypair-delete- Delete keypair given by its name. (Supported by API versions '2.0' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
keypair-list- Print a list of keypairs for a user (Supported by API versions '2.0' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
keypair-show- Show details about the given keypair. (Supported by API versions '2.0' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
limits- Print rate and absolute limits.
list- List active servers.
list-extensions- List all the os-api extensions that are available.
list-secgroup- List Security Group(s) of a server.
live-migration- Migrate running server to a new machine.
live-migration-abort- Abort an on-going live migration. (Supported by API versions '2.24' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
live-migration-force-complete- Force on-going live migration to complete. (Supported by API versions '2.22' -'2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
lock- Lock a server. A normal (non-admin) user will not be able to execute actions on a locked server.
meta- Set or delete metadata on a server.
migrate- Migrate a server. The new host will be selected by the scheduler.
migration-list- Print a list of migrations.
network-associate-host- DEPRECATED: Associate host with network.
network-associate-project- DEPRECATED: Associate project with network.
network-create- DEPRECATED: Create a network.
network-delete- DEPRECATED: Delete network by label or id.
network-disassociate- DEPRECATED: Disassociate host and/or project from the given network.
network-list- DEPRECATED: Print a list of available networks.
network-show- DEPRECATED: Show details about the given network.
pause- Pause a server.
quota-class-show- List the quotas for a quota class.
quota-class-update- Update the quotas for a quota class. (Supported by API versions '2.0' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
quota-defaults- List the default quotas for a tenant.
quota-delete- Delete quota for a tenant/user so their quota will Revert back to default.
quota-show- List the quotas for a tenant/user.
quota-update- Update the quotas for a tenant/user. (Supported by API versions '2.0' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
reboot- Reboot a server.
rebuild- Shutdown, re-image, and re-boot a server.
refresh-network- Refresh server network information.
remove-fixed-ip- Remove an IP address from a server.
remove-secgroup- Remove a Security Group from a server.
rescue- Reboots a server into rescue mode, which starts the machine from either the initial image or a specified image, attaching the current boot disk as secondary.
reset-network- Reset network of a server.
reset-state- Reset the state of a server.
resize- Resize a server.
resize-confirm- Confirm a previous resize.
resize-revert- Revert a previous resize (and return to the previous VM).
restore- Restore a soft-deleted server.
resume- Resume a server.
scrub- DEPRECATED: Delete networks and security groups associated with a project.
secgroup-add-default-rule- DEPRECATED: Add a rule to the set of rules that will be added to the 'default' security group for new tenants (nova-network only).
secgroup-add-group-rule- DEPRECATED: Add a source group rule to a security group.
secgroup-add-rule- DEPRECATED: Add a rule to a security group.
secgroup-create- DEPRECATED: Create a security group.
secgroup-delete- DEPRECATED: Delete a security group.
secgroup-delete-default-rule- DEPRECATED: Delete a rule from the set of rules that will be added to the 'default' security group for new tenants (nova-network only).
secgroup-delete-group-rule- DEPRECATED: Delete a source group rule from a security group.
secgroup-delete-rule- DEPRECATED: Delete a rule from a security group.
secgroup-list- DEPRECATED: List security groups for the current tenant.
secgroup-list-default-rules- DEPRECATED: List rules that will be added to the 'default' security group for new tenants.
secgroup-list-rules- DEPRECATED: List rules for a security group.
secgroup-update- DEPRECATED: Update a security group.
server-group-create- Create a new server group with the specified details.
server-group-delete- Delete specific server group(s).
server-group-get- Get a specific server group.
server-group-list- Print a list of all server groups.
server-migration-list- Get the migrations list of specified server. (Supported by API versions '2.23' -'2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
server-migration-show- Get the migration of specified server. (Supported by API versions '2.23' -'2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
server-tag-add- Add one or more tags to a server. (Supported by API versions '2.26' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
server-tag-delete- Delete one or more tags from a server. (Supported by API versions '2.26' -'2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
server-tag-delete-all- Delete all tags from a server. (Supported by API versions '2.26' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
server-tag-list- Get list of tags from a server. (Supported by API versions '2.26' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
server-tag-set- Set list of tags to a server. (Supported by API versions '2.26' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
service-delete- Delete the service.
service-disable- Disable the service.
service-enable- Enable the service.
service-force-down- Force service to down. (Supported by API versions '2.11' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
service-list- Show a list of all running services. Filter by host & binary.
set-password- Change the admin password for a server.
shelve- Shelve a server.
shelve-offload- Remove a shelved server from the compute node.
show- Show details about the given server.
ssh- SSH into a server.
start- Start the server(s).
stop- Stop the server(s).
suspend- Suspend a server.
trigger-crash-dump- Trigger crash dump in an instance. (Supported by API versions '2.17' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
unlock- Unlock a server.
unpause- Unpause a server.
unrescue- Restart the server from normal boot disk again.
unshelve- Unshelve a server.
update- Update the name or the description for a server.
usage- Show usage data for a single tenant.
usage-list- List usage data for all tenants.
version-list- List all API versions.
virtual-interface-list- Show virtual interface info about the given server.
volume-attach- Attach a volume to a server.
volume-attachments- List all the volumes attached to a server.
volume-detach- Detach a volume from a server.
volume-update- Update volume attachment.
x509-create-cert- Create x509 cert for a user in tenant.
x509-get-root-cert- Fetch the x509 root cert.
bash-completion- Prints all of the commands and options to stdout so that the nova.bash_completion script doesn’t have to hard code them.
help- Display help about this program or one of its subcommands.
baremetal-interface-list- DEPRECATED: List network interfaces associated with a baremetal node.
baremetal-node-list- DEPRECATED: Print list of available baremetal nodes.
baremetal-node-show- DEPRECATED: Show information about a baremetal node.
net- DEPRECATED, use tenant-network-show instead.
net-create- DEPRECATED, use tenant-network-create instead.
net-delete- DEPRECATED, use tenant-network-delete instead.
net-list- DEPRECATED, use tenant-network-list instead.
tenant-network-create- DEPRECATED: Create a tenant network.
tenant-network-delete- DEPRECATED: Delete a tenant network.
tenant-network-list- DEPRECATED: List tenant networks.
tenant-network-show- DEPRECATED: Show a tenant network.
13.2. nova optional arguments
Copy linkLink copied to clipboard!
--version- show program’s version number and exit
--debug- Print debugging output.
--os-cache-
Use the auth token cache. Defaults to False if
env[OS_CACHE]is not set. --timings- Print call timing info.
--os-region-name <region-name>-
Defaults to
env[OS_REGION_NAME]. --service-type <service-type>- Defaults to compute for most actions.
--service-name <service-name>-
Defaults to
env[NOVA_SERVICE_NAME]. --os-endpoint-type <endpoint-type>-
Defaults to
env[NOVA_ENDPOINT_TYPE],env[OS_ENDPOINT_TYPE]or publicURL. --os-compute-api-version <compute-api-ver>-
Accepts X, X.Y (where X is major and Y is minor part) or "X.latest", defaults to
env[OS_COMPUTE_API_VERSION]. --endpoint-override <bypass-url>-
Use this API endpoint instead of the Service Catalog. Defaults to
env[NOVACLIENT_ENDPOINT_OVERRIDE]. --profile HMAC_KEY- HMAC key to use for encrypting context data for performance profiling of operation. This key should be the value of the HMAC key configured for the OSprofiler middleware in nova; it is specified in the Nova configuration file at "/etc/nova/nova.conf". Without the key, profiling will not be triggered even if OSprofiler is enabled on the server side.
--os-auth-type <name>, --os-auth-plugin <name>- Authentication type to use
13.2.1. nova add-fixed-ip
Copy linkLink copied to clipboard!
usage: nova add-fixed-ip <server> <network-id>
usage: nova add-fixed-ip <server> <network-id>Add new IP address on a network to server.
Positional arguments:
<server>- Name or ID of server.
<network-id>- Network ID.
13.2.2. nova add-secgroup
Copy linkLink copied to clipboard!
usage: nova add-secgroup <server> <secgroup>
usage: nova add-secgroup <server> <secgroup>Add a Security Group to a server.
Positional arguments:
<server>- Name or ID of server.
<secgroup>- Name or ID of Security Group.
13.2.3. nova agent-create
Copy linkLink copied to clipboard!
usage: nova agent-create <os> <architecture> <version> <url> <md5hash>
<hypervisor>
usage: nova agent-create <os> <architecture> <version> <url> <md5hash>
<hypervisor>Create new agent build.
Positional arguments:
<os>- Type of OS.
<architecture>- Type of architecture.
<version>- Version.
<url>- URL.
<md5hash>- MD5 hash.
<hypervisor>- Type of hypervisor.
13.2.4. nova agent-delete
Copy linkLink copied to clipboard!
usage: nova agent-delete <id>
usage: nova agent-delete <id>Delete existing agent build.
Positional arguments:
<id>- ID of the agent-build.
13.2.5. nova agent-list
Copy linkLink copied to clipboard!
usage: nova agent-list [--hypervisor <hypervisor>]
usage: nova agent-list [--hypervisor <hypervisor>]List all builds.
Optional arguments:
--hypervisor <hypervisor>- Type of hypervisor.
13.2.6. nova agent-modify
Copy linkLink copied to clipboard!
usage: nova agent-modify <id> <version> <url> <md5hash>
usage: nova agent-modify <id> <version> <url> <md5hash>Modify existing agent build.
Positional arguments:
<id>- ID of the agent-build.
<version>- Version.
<url>- URL
<md5hash>- MD5 hash.
13.2.7. nova aggregate-add-host
Copy linkLink copied to clipboard!
usage: nova aggregate-add-host <aggregate> <host>
usage: nova aggregate-add-host <aggregate> <host>Add the host to the specified aggregate.
Positional arguments:
<aggregate>- Name or ID of aggregate.
<host>- The host to add to the aggregate.
13.2.8. nova aggregate-create
Copy linkLink copied to clipboard!
usage: nova aggregate-create <name> [<availability-zone>]
usage: nova aggregate-create <name> [<availability-zone>]Create a new aggregate with the specified details.
Positional arguments:
<name>- Name of aggregate.
<availability-zone>- The availability zone of the aggregate (optional).
13.2.9. nova aggregate-delete
Copy linkLink copied to clipboard!
usage: nova aggregate-delete <aggregate>
usage: nova aggregate-delete <aggregate>Delete the aggregate.
Positional arguments:
<aggregate>- Name or ID of aggregate to delete.
13.2.10. nova aggregate-list
Copy linkLink copied to clipboard!
usage: nova aggregate-list
usage: nova aggregate-listPrint a list of all aggregates.
13.2.11. nova aggregate-remove-host
Copy linkLink copied to clipboard!
usage: nova aggregate-remove-host <aggregate> <host>
usage: nova aggregate-remove-host <aggregate> <host>Remove the specified host from the specified aggregate.
Positional arguments:
<aggregate>- Name or ID of aggregate.
<host>- The host to remove from the aggregate.
13.2.12. nova aggregate-set-metadata
Copy linkLink copied to clipboard!
usage: nova aggregate-set-metadata <aggregate> <key=value> [<key=value> ...]
usage: nova aggregate-set-metadata <aggregate> <key=value> [<key=value> ...]Update the metadata associated with the aggregate.
Positional arguments:
<aggregate>- Name or ID of aggregate to update.
<key=value>- Metadata to add/update to aggregate. Specify only the key to delete a metadata item.
13.2.13. nova aggregate-show
Copy linkLink copied to clipboard!
usage: nova aggregate-show <aggregate>
usage: nova aggregate-show <aggregate>Show details of the specified aggregate.
Positional arguments:
<aggregate>- Name or ID of aggregate.
13.2.14. nova aggregate-update
Copy linkLink copied to clipboard!
usage: nova aggregate-update [--name NAME]
[--availability-zone <availability-zone>]
<aggregate>
usage: nova aggregate-update [--name NAME]
[--availability-zone <availability-zone>]
<aggregate>Update the aggregate’s name and optionally availability zone.
Positional arguments:
<aggregate>- Name or ID of aggregate to update.
Optional arguments:
--name NAME- Name of aggregate.
--availability-zone <availability-zone>- The availability zone of the aggregate.
13.2.15. nova availability-zone-list
Copy linkLink copied to clipboard!
usage: nova availability-zone-list
usage: nova availability-zone-listList all the availability zones.
13.2.16. nova backup
Copy linkLink copied to clipboard!
usage: nova backup <server> <name> <backup-type> <rotation>
usage: nova backup <server> <name> <backup-type> <rotation>Backup a server by creating a 'backup' type snapshot.
Positional arguments:
<server>- Name or ID of server.
<name>- Name of the backup image.
<backup-type>- The backup type, like "daily" or "weekly".
<rotation>- Int parameter representing how many backups to keep around.
13.2.17. nova boot
Copy linkLink copied to clipboard!
Boot a new server.
Positional arguments:
<name>- Name for the new server.
Optional arguments:
--flavor <flavor>- Name or ID of flavor (see 'nova flavor-list').
--image <image>- Name or ID of image (see 'glance image-list').
--image-with <key=value>- Image metadata property (see 'glance image-show').
--boot-volume <volume_id>- Volume ID to boot from.
--snapshot <snapshot_id>- Snapshot ID to boot from (will create a volume).
--min-count <number>- Boot at least <number> servers (limited by quota).
--max-count <number>- Boot up to <number> servers (limited by quota).
--meta <key=value>- Record arbitrary key/value metadata to /meta_data.json on the metadata server. Can be specified multiple times.
--file <dst-path=src-path>- Store arbitrary files from <src-path> locally to <dst-path> on the new server. Limited by the injected_files quota value.
--key-name <key-name>- Key name of keypair that should be created earlier with the command keypair-add.
--user-data <user-data>- user data file to pass to be exposed by the metadata server.
--availability-zone <availability-zone>- The availability zone for server placement.
--security-groups <security-groups>- Comma separated list of security group names.
--block-device-mapping <dev-name=mapping>- Block device mapping in the format <dev-name>=<id>:<type>:<size(GB)>:<delete-on-terminate>.
--block-device- key1=value1[,key2=value2…] Block device mapping with the keys: id=UUID (image_id, snapshot_id or volume_id only if using source image, snapshot or volume) source=source type (image, snapshot, volume or blank), dest=destination type of the block device (volume or local), bus=device’s bus (e.g. uml, lxc, virtio, …; if omitted, hypervisor driver chooses a suitable default, honoured only if device type is supplied) type=device type (e.g. disk, cdrom, …; defaults to 'disk') device=name of the device (e.g. vda, xda, …; tag=device metadata tag (optional) if omitted, hypervisor driver chooses suitable device depending on selected bus; note the libvirt driver always uses default device names), size=size of the block device in MB(for swap) and in GB(for other formats) (if omitted, hypervisor driver calculates size), format=device will be formatted (e.g. swap, ntfs, …; optional), bootindex=integer used for ordering the boot disks (for image backed instances it is equal to 0, for others need to be specified) and shutdown=shutdown behaviour (either preserve or remove, for local destination set to remove). (Supported by API versions '2.32' -'2.latest')
--swap <swap_size>- Create and attach a local swap block device of <swap_size> MB.
--ephemeral- size=<size>[,format=<format>] Create and attach a local ephemeral block device of <size> GB and format it to <format>.
--hint <key=value>- Send arbitrary key/value pairs to the scheduler for custom use.
--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>- Create a NIC on the server. Specify option multiple times to create multiple nics unless using the special 'auto' or 'none' values. auto: automatically allocate network resources if none are available. This cannot be specified with any other nic value and cannot be specified multiple times. none: do not attach a NIC at all. This cannot be specified with any other nic value and cannot be specified multiple times. net-id: attach NIC to network with a specific UUID. net-name: attach NIC to network with this name (either port-id or net-id or net-name must be provided), v4-fixed-ip: IPv4 fixed address for NIC (optional), v6-fixed-ip: IPv6 fixed address for NIC (optional), port-id: attach NIC to port with this UUID tag: interface metadata tag (optional) (either port-id or net-id must be provided). (Supported by API versions '2.37' - '2.latest')
--config-drive <value>- Enable config drive.
--poll- Report the new server boot progress until it completes.
--admin-pass <value>- Admin password for the instance.
--access-ip-v4 <value>- Alternative access IPv4 of the instance.
--access-ip-v6 <value>- Alternative access IPv6 of the instance.
--description <description>- Description for the server. (Supported by API versions '2.19' - '2.latest')
13.2.18. nova cell-capacities
Copy linkLink copied to clipboard!
usage: nova cell-capacities [--cell <cell-name>]
usage: nova cell-capacities [--cell <cell-name>]Get cell capacities for all cells or a given cell.
Optional arguments:
--cell <cell-name>- Name of the cell to get the capacities.
13.2.19. nova cell-show
Copy linkLink copied to clipboard!
usage: nova cell-show <cell-name>
usage: nova cell-show <cell-name>Show details of a given cell.
Positional arguments:
<cell-name>- Name of the cell.
13.2.20. nova clear-password
Copy linkLink copied to clipboard!
usage: nova clear-password <server>
usage: nova clear-password <server>Clear the admin password for a server from the metadata server. This action does not actually change the instance server password.
Positional arguments:
<server>- Name or ID of server.
13.2.21. nova cloudpipe-configure
Copy linkLink copied to clipboard!
usage: nova cloudpipe-configure <ip address> <port>
usage: nova cloudpipe-configure <ip address> <port>Update the VPN IP/port of a cloudpipe instance.
Positional arguments:
<ip address>- New IP Address.
<port>- New Port.
13.2.22. nova cloudpipe-create
Copy linkLink copied to clipboard!
usage: nova cloudpipe-create <project_id>
usage: nova cloudpipe-create <project_id>Create a cloudpipe instance for the given project.
Positional arguments:
<project_id>- UUID of the project to create the cloudpipe for.
13.2.23. nova cloudpipe-list
Copy linkLink copied to clipboard!
usage: nova cloudpipe-list
usage: nova cloudpipe-listPrint a list of all cloudpipe instances.
13.2.24. nova console-log
Copy linkLink copied to clipboard!
usage: nova console-log [--length <length>] <server>
usage: nova console-log [--length <length>] <server>Get console log output of a server.
Positional arguments:
<server>- Name or ID of server.
Optional arguments:
--length <length>- Length in lines to tail.
13.2.25. nova delete
Copy linkLink copied to clipboard!
usage: nova delete [--all-tenants] <server> [<server> ...]
usage: nova delete [--all-tenants] <server> [<server> ...]Immediately shut down and delete specified server(s).
Positional arguments:
<server>- Name or ID of server(s).
Optional arguments:
--all-tenants- Delete server(s) in another tenant by name (Admin only).
13.2.26. nova diagnostics
Copy linkLink copied to clipboard!
usage: nova diagnostics <server>
usage: nova diagnostics <server>Retrieve server diagnostics.
Positional arguments:
<server>- Name or ID of server.
13.2.27. nova evacuate
Copy linkLink copied to clipboard!
usage: nova evacuate [--password <password>] [--force] <server> [<host>]
usage: nova evacuate [--password <password>] [--force] <server> [<host>]Evacuate server from failed host.
Positional arguments:
<server>- Name or ID of server.
<host>- Name or ID of the target host. If no host is specified, the scheduler will choose one.
Optional arguments:
--password <password>- Set the provided admin password on the evacuated server. Not applicable if the server is on shared storage.
--force- Force to not verify the scheduler if a host is provided. (Supported by API versions '2.29' -'2.latest')
13.2.28. nova flavor-access-add
Copy linkLink copied to clipboard!
usage: nova flavor-access-add <flavor> <tenant_id>
usage: nova flavor-access-add <flavor> <tenant_id>Add flavor access for the given tenant.
Positional arguments:
<flavor>- Flavor name or ID to add access for the given tenant.
<tenant_id>- Tenant ID to add flavor access for.
13.2.29. nova flavor-access-list
Copy linkLink copied to clipboard!
usage: nova flavor-access-list [--flavor <flavor>] [--tenant <tenant_id>]
usage: nova flavor-access-list [--flavor <flavor>] [--tenant <tenant_id>]Print access information about the given flavor.
Optional arguments:
--flavor <flavor>- Filter results by flavor name or ID.
--tenant <tenant_id>- Filter results by tenant ID. (Deprecated; this option is not supported, and will be removed in version 5.0.0.)
13.2.30. nova flavor-access-remove
Copy linkLink copied to clipboard!
usage: nova flavor-access-remove <flavor> <tenant_id>
usage: nova flavor-access-remove <flavor> <tenant_id>Remove flavor access for the given tenant.
Positional arguments:
<flavor>- Flavor name or ID to remove access for the given tenant.
<tenant_id>- Tenant ID to remove flavor access for.
13.2.31. nova flavor-create
Copy linkLink copied to clipboard!
usage: nova flavor-create [--ephemeral <ephemeral>] [--swap <swap>]
[--rxtx-factor <factor>] [--is-public <is-public>]
<name> <id> <ram> <disk> <vcpus>
usage: nova flavor-create [--ephemeral <ephemeral>] [--swap <swap>]
[--rxtx-factor <factor>] [--is-public <is-public>]
<name> <id> <ram> <disk> <vcpus>Create a new flavor.
Positional arguments:
<name>- Unique name of the new flavor.
<id>- Unique ID of the new flavor. Specifying 'auto' will generated a UUID for the ID.
<ram>- Memory size in MB.
<disk>- Disk size in GB.
<vcpus>- Number of vcpus
Optional arguments:
--ephemeral <ephemeral>- Ephemeral space size in GB (default 0).
--swap <swap>- Swap space size in MB (default 0).
--rxtx-factor <factor>- RX/TX factor (default 1).
--is-public <is-public>- Make flavor accessible to the public (default true).
13.2.32. nova flavor-delete
Copy linkLink copied to clipboard!
usage: nova flavor-delete <flavor>
usage: nova flavor-delete <flavor>Delete a specific flavor
Positional arguments:
<flavor>- Name or ID of the flavor to delete.
13.2.33. nova flavor-key
Copy linkLink copied to clipboard!
usage: nova flavor-key <flavor> <action> <key=value> [<key=value> ...]
usage: nova flavor-key <flavor> <action> <key=value> [<key=value> ...]Set or unset extra_spec for a flavor.
Positional arguments:
<flavor>- Name or ID of flavor.
<action>- Actions: 'set' or 'unset'.
<key=value>- Extra_specs to set/unset (only key is necessary on unset).
13.2.34. nova flavor-list
Copy linkLink copied to clipboard!
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>]
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>]Print a list of available 'flavors' (sizes of servers).
Optional arguments:
--extra-specs- Get extra-specs of each flavor.
--all- Display all flavors (Admin only).
--marker <marker>- The last flavor ID of the previous page; displays list of flavors after "marker".
--min-disk <min-disk>- Filters the flavors by a minimum disk space, in GiB.
--min-ram <min-ram>- Filters the flavors by a minimum RAM, in MB.
--limit <limit>- Maximum number of flavors to display. If limit is bigger than 'CONF.api.max_limit' option of Nova API, limit 'CONF.api.max_limit' will be used instead.
--sort-key <sort-key>- Flavors list sort key.
--sort-dir <sort-dir>- Flavors list sort direction.
13.2.35. nova flavor-show
Copy linkLink copied to clipboard!
usage: nova flavor-show <flavor>
usage: nova flavor-show <flavor>Show details about the given flavor.
Positional arguments:
<flavor>- Name or ID of flavor.
13.2.36. nova floating-ip-associate
Copy linkLink copied to clipboard!
usage: nova floating-ip-associate [--fixed-address <fixed_address>]
<server> <address>
usage: nova floating-ip-associate [--fixed-address <fixed_address>]
<server> <address>Associate a floating IP address to a server.
Positional arguments:
<server>- Name or ID of server.
<address>- IP Address.
Optional arguments:
--fixed-address <fixed_address>- Fixed IP Address to associate with.
13.2.37. nova floating-ip-disassociate
Copy linkLink copied to clipboard!
usage: nova floating-ip-disassociate <server> <address>
usage: nova floating-ip-disassociate <server> <address>Disassociate a floating IP address from a server.
Positional arguments:
<server>- Name or ID of server.
<address>- IP Address.
13.2.38. nova force-delete
Copy linkLink copied to clipboard!
usage: nova force-delete <server>
usage: nova force-delete <server>Force delete a server.
Positional arguments:
<server>- Name or ID of server.
13.2.39. nova get-mks-console
Copy linkLink copied to clipboard!
usage: nova get-mks-console <server>
usage: nova get-mks-console <server>Get an MKS console to a server. (Supported by API versions '2.8' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<server>- Name or ID of server.
13.2.40. nova get-password
Copy linkLink copied to clipboard!
usage: nova get-password <server> [<private-key>]
usage: nova get-password <server> [<private-key>]Get the admin password for a server. This operation calls the metadata service to query metadata information and does not read password information from the server itself.
Positional arguments:
<server>- Name or ID of server.
<private-key>- Private key (used locally to decrypt password) (Optional). When specified, the command displays the clear (decrypted) VM password. When not specified, the ciphered VM password is displayed.
13.2.41. nova get-rdp-console
Copy linkLink copied to clipboard!
usage: nova get-rdp-console <server> <console-type>
usage: nova get-rdp-console <server> <console-type>Get a rdp console to a server.
Positional arguments:
<server>- Name or ID of server.
<console-type>- Type of rdp console ("rdp-html5").
13.2.42. nova get-serial-console
Copy linkLink copied to clipboard!
usage: nova get-serial-console [--console-type CONSOLE_TYPE] <server>
usage: nova get-serial-console [--console-type CONSOLE_TYPE] <server>Get a serial console to a server.
Positional arguments:
<server>- Name or ID of server.
Optional arguments:
--console-type CONSOLE_TYPE- Type of serial console, default="serial".
13.2.43. nova get-spice-console
Copy linkLink copied to clipboard!
usage: nova get-spice-console <server> <console-type>
usage: nova get-spice-console <server> <console-type>Get a spice console to a server.
Positional arguments:
<server>- Name or ID of server.
<console-type>- Type of spice console ("spice-html5").
13.2.44. nova get-vnc-console
Copy linkLink copied to clipboard!
usage: nova get-vnc-console <server> <console-type>
usage: nova get-vnc-console <server> <console-type>Get a vnc console to a server.
Positional arguments:
<server>- Name or ID of server.
<console-type>- Type of vnc console ("novnc" or "xvpvnc").
13.2.45. nova host-action
Copy linkLink copied to clipboard!
usage: nova host-action [--action <action>] <hostname>
usage: nova host-action [--action <action>] <hostname>Perform a power action on a host.
Positional arguments:
<hostname>- Name of host.
Optional arguments:
--action <action>- A power action: startup, reboot, or shutdown.
13.2.46. nova host-describe
Copy linkLink copied to clipboard!
usage: nova host-describe <hostname>
usage: nova host-describe <hostname>Describe a specific host.
Positional arguments:
<hostname>- Name of host.
13.2.47. nova host-evacuate
Copy linkLink copied to clipboard!
usage: nova host-evacuate [--target_host <target_host>] [--force] <host>
usage: nova host-evacuate [--target_host <target_host>] [--force] <host>Evacuate all instances from failed host.
Positional arguments:
<host>- Name of host.
Optional arguments:
--target_host <target_host>- Name of target host. If no host is specified the scheduler will select a target.
--force- Force to not verify the scheduler if a host is provided. (Supported by API versions '2.29' -'2.latest')
13.2.48. nova host-evacuate-live
Copy linkLink copied to clipboard!
usage: nova host-evacuate-live [--target-host <target_host>] [--block-migrate]
[--max-servers <max_servers>] [--force]
<host>
usage: nova host-evacuate-live [--target-host <target_host>] [--block-migrate]
[--max-servers <max_servers>] [--force]
<host>Live migrate all instances of the specified host to other available hosts.
Positional arguments:
<host>- Name of host.
Optional arguments:
--target-host <target_host>- Name of target host.
--block-migrate- Enable block migration. (Default=auto) (Supported by API versions '2.25' - '2.latest')
--max-servers <max_servers>- Maximum number of servers to live migrate simultaneously
--force- Force to not verify the scheduler if a host is provided. (Supported by API versions '2.30' -'2.latest')
13.2.49. nova host-list
Copy linkLink copied to clipboard!
usage: nova host-list [--zone <zone>]
usage: nova host-list [--zone <zone>]List all hosts by service.
Optional arguments:
--zone <zone>- Filters the list, returning only those hosts in the availability zone <zone>.
13.2.50. nova host-meta
Copy linkLink copied to clipboard!
usage: nova host-meta <host> <action> <key=value> [<key=value> ...]
usage: nova host-meta <host> <action> <key=value> [<key=value> ...]Set or Delete metadata on all instances of a host.
Positional arguments:
<host>- Name of host.
<action>- Actions: 'set' or 'delete'
<key=value>- Metadata to set or delete (only key is necessary on delete)
13.2.51. nova host-servers-migrate
Copy linkLink copied to clipboard!
usage: nova host-servers-migrate <host>
usage: nova host-servers-migrate <host>Cold migrate all instances off the specified host to other available hosts.
Positional arguments:
<host>- Name of host.
13.2.52. nova host-update
Copy linkLink copied to clipboard!
usage: nova host-update [--status <enable|disable>]
[--maintenance <enable|disable>]
<hostname>
usage: nova host-update [--status <enable|disable>]
[--maintenance <enable|disable>]
<hostname>Update host settings.
Positional arguments:
<hostname>- Name of host.
Optional arguments:
--status <enable|disable>- Either enable or disable a host.
--maintenance <enable|disable>- Either put or resume host to/from maintenance.
13.2.53. nova hypervisor-list
Copy linkLink copied to clipboard!
usage: nova hypervisor-list [--matching <hostname>] [--marker <marker>]
[--limit <limit>]
usage: nova hypervisor-list [--matching <hostname>] [--marker <marker>]
[--limit <limit>]List hypervisors. (Supported by API versions '2.0' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Optional arguments:
--matching <hostname>- List hypervisors matching the given <hostname>. If matching is used limit and marker options will be ignored.
--marker <marker>- The last hypervisor of the previous page; displays list of hypervisors after "marker".
--limit <limit>- Maximum number of hypervisors to display. If limit is bigger than 'CONF.api.max_limit' option of Nova API, limit 'CONF.api.max_limit' will be used instead.
13.2.54. nova hypervisor-servers
Copy linkLink copied to clipboard!
usage: nova hypervisor-servers <hostname>
usage: nova hypervisor-servers <hostname>List servers belonging to specific hypervisors.
Positional arguments:
<hostname>- The hypervisor hostname (or pattern) to search for.
13.2.55. nova hypervisor-show
Copy linkLink copied to clipboard!
usage: nova hypervisor-show [--wrap <integer>] <hypervisor>
usage: nova hypervisor-show [--wrap <integer>] <hypervisor>Display the details of the specified hypervisor.
Positional arguments:
<hypervisor>- Name or ID of the hypervisor to show the details of.
Optional arguments:
--wrap <integer>- Wrap the output to a specified length. Default is 40 or 0 to disable
13.2.56. nova hypervisor-stats
Copy linkLink copied to clipboard!
usage: nova hypervisor-stats
usage: nova hypervisor-statsGet hypervisor statistics over all compute nodes.
Warning
When using Red Hat Ceph as a back end for ephemeral storage, the Compute service does not calculate the amount of available storage correctly. Specifically, Compute simply adds up the amount of available storage without factoring in replication. This results in grossly overstated available storage, which in turn could cause unexpected storage oversubscription.
To determine the correct ephemeral storage capacity, query the Ceph service directly instead. For more information, see BZ#1332165.
13.2.57. nova hypervisor-uptime
Copy linkLink copied to clipboard!
usage: nova hypervisor-uptime <hypervisor>
usage: nova hypervisor-uptime <hypervisor>Display the uptime of the specified hypervisor.
Positional arguments:
<hypervisor>- Name or ID of the hypervisor to show the uptime of.
13.2.58. nova image-create
Copy linkLink copied to clipboard!
usage: nova image-create [--metadata <key=value>] [--show] [--poll]
<server> <name>
usage: nova image-create [--metadata <key=value>] [--show] [--poll]
<server> <name>Create a new image by taking a snapshot of a running server.
Note
Images created by nova image-create are only usable by nova itself (and not glance).
Positional arguments:
<server>- Name or ID of server.
<name>- Name of snapshot.
Optional arguments:
--metadata <key=value>- Record arbitrary key/value metadata to /meta_data.json on the metadata server. Can be specified multiple times.
--show- Print image info.
--poll- Report the snapshot progress and poll until image creation is complete.
13.2.59. nova instance-action
Copy linkLink copied to clipboard!
usage: nova instance-action <server> <request_id>
usage: nova instance-action <server> <request_id>Show an action.
Positional arguments:
<server>- Name or UUID of the server to show actions for. Only UUID can be used to show actions for a deleted server. (Supported by API versions '2.21' - '2.latest')
<request_id>- Request ID of the action to get.
13.2.60. nova instance-action-list
Copy linkLink copied to clipboard!
usage: nova instance-action-list <server>
usage: nova instance-action-list <server>List actions on a server.
Positional arguments:
<server>- Name or UUID of the server to list actions for. Only UUID can be used to list actions on a deleted server. (Supported by API versions '2.21' - '2.latest')
13.2.61. nova interface-attach
Copy linkLink copied to clipboard!
usage: nova interface-attach [--port-id <port_id>] [--net-id <net_id>]
[--fixed-ip <fixed_ip>]
<server>
usage: nova interface-attach [--port-id <port_id>] [--net-id <net_id>]
[--fixed-ip <fixed_ip>]
<server>Attach a network interface to a server.
Positional arguments:
<server>- Name or ID of server.
Optional arguments:
--port-id <port_id>- Port ID.
--net-id <net_id>- Network ID
--fixed-ip <fixed_ip>- Requested fixed IP.
13.2.62. nova interface-detach
Copy linkLink copied to clipboard!
usage: nova interface-detach <server> <port_id>
usage: nova interface-detach <server> <port_id>Detach a network interface from a server.
Positional arguments:
<server>- Name or ID of server.
<port_id>- Port ID.
13.2.63. nova interface-list
Copy linkLink copied to clipboard!
usage: nova interface-list <server>
usage: nova interface-list <server>List interfaces attached to a server.
Positional arguments:
<server>- Name or ID of server.
13.2.64. nova keypair-add
Copy linkLink copied to clipboard!
usage: nova keypair-add [--pub-key <pub-key>] [--key-type <key-type>]
[--user <user-id>]
<name>
usage: nova keypair-add [--pub-key <pub-key>] [--key-type <key-type>]
[--user <user-id>]
<name>Create a new key pair for use with servers.
Positional arguments:
<name>- Name of key.
Optional arguments:
--pub-key <pub-key>- Path to a public ssh key.
--key-type <key-type>- Keypair type. Can be ssh or x509. (Supported by API versions '2.2' - '2.latest')
--user <user-id>- ID of user to whom to add key-pair (Admin only). (Supported by API versions '2.10' - '2.latest')
13.2.65. nova keypair-delete
Copy linkLink copied to clipboard!
usage: nova keypair-delete [--user <user-id>] <name>
usage: nova keypair-delete [--user <user-id>] <name>Delete keypair given by its name. (Supported by API versions '2.0' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<name>- Keypair name to delete.
Optional arguments:
--user <user-id>- ID of key-pair owner (Admin only).
13.2.66. nova keypair-list
Copy linkLink copied to clipboard!
usage: nova keypair-list [--user <user-id>] [--marker <marker>]
[--limit <limit>]
usage: nova keypair-list [--user <user-id>] [--marker <marker>]
[--limit <limit>]Print a list of keypairs for a user (Supported by API versions '2.0' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Optional arguments:
--user <user-id>- List key-pairs of specified user ID (Admin only).
--marker <marker>- The last keypair of the previous page; displays list of keypairs after "marker".
--limit <limit>- Maximum number of keypairs to display. If limit is bigger than 'CONF.api.max_limit' option of Nova API, limit 'CONF.api.max_limit' will be used instead.
13.2.67. nova keypair-show
Copy linkLink copied to clipboard!
usage: nova keypair-show [--user <user-id>] <keypair>
usage: nova keypair-show [--user <user-id>] <keypair>Show details about the given keypair. (Supported by API versions '2.0' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<keypair>- Name of keypair.
Optional arguments:
--user <user-id>- ID of key-pair owner (Admin only).
13.2.68. nova limits
Copy linkLink copied to clipboard!
usage: nova limits [--tenant [<tenant>]] [--reserved]
usage: nova limits [--tenant [<tenant>]] [--reserved]Print rate and absolute limits.
Optional arguments:
--tenant [<tenant>]- Display information from single tenant (Admin only).
--reserved- Include reservations count.
13.2.69. nova list
Copy linkLink copied to clipboard!
List active servers.
Optional arguments:
--reservation-id <reservation-id>- Only return servers that match reservation-id.
--ip <ip-regexp>- Search with regular expression match by IP address.
--ip6 <ip6-regexp>- Search with regular expression match by IPv6 address.
--name <name-regexp>- Search with regular expression match by name.
--instance-name <name-regexp>- Search with regular expression match by server name.
--status <status>- Search by server status.
--flavor <flavor>- Search by flavor name or ID.
--image <image>- Search by image name or ID.
--host <hostname>- Search servers by hostname to which they are assigned (Admin only).
--all-tenants [<0|1>]- Display information from all tenants (Admin only).
--tenant [<tenant>]- Display information from single tenant (Admin only).
--user [<user>]- Display information from single user (Admin only).
--deleted- Only display deleted servers (Admin only).
--fields <fields>- Comma-separated list of fields to display. Use the show command to see which fields are available.
--minimal- Get only UUID and name.
--sort <key>[:<direction>]- Comma-separated list of sort keys and directions in the form of <key>[:<asc|desc>]. The direction defaults to descending if not specified.
--marker <marker>- The last server UUID of the previous page; displays list of servers after "marker".
--limit <limit>- Maximum number of servers to display. If limit == -1, all servers will be displayed. If limit is bigger than 'CONF.api.max_limit' option of Nova API, limit 'CONF.api.max_limit' will be used instead.
--changes-since <changes_since>- List only servers changed after a certain point of time.The provided time should be an ISO 8061 formatted time.ex 2016-03-04T06:27:59Z .
--tags <tags>The given tags must all be present for a server to be included in the list result. Boolean expression in this case is 't1 AND t2'. Tags must be separated by commas: --tags <tag1,tag2> (Supported by API versions '2.26'
- '2.latest')
--tags-any <tags-any>If one of the given tags is present the server will be included in the list result. Boolean expression in this case is 't1 OR t2'. Tags must be separated by commas: --tags-any <tag1,tag2> (Supported by API versions '2.26'
- '2.latest')
--not-tags <not-tags>- Only the servers that do not have any of the given tags will be included in the list results. Boolean expression in this case is 'NOT(t1 AND t2)'. Tags must be separated by commas: --not-tags <tag1,tag2> (Supported by API versions '2.26' - '2.latest')
--not-tags-any <not-tags-any>- Only the servers that do not have at least one of the given tags will be included in the list result. Boolean expression in this case is 'NOT(t1 OR t2)'. Tags must be separated by commas: --not-tags-any <tag1,tag2> (Supported by API versions '2.26' - '2.latest')
13.2.70. nova list-extensions
Copy linkLink copied to clipboard!
usage: nova list-extensions
usage: nova list-extensionsList all the os-api extensions that are available.
13.2.71. nova list-secgroup
Copy linkLink copied to clipboard!
usage: nova list-secgroup <server>
usage: nova list-secgroup <server>List Security Group(s) of a server.
Positional arguments:
<server>- Name or ID of server.
13.2.72. nova live-migration
Copy linkLink copied to clipboard!
usage: nova live-migration [--block-migrate] [--force] <server> [<host>]
usage: nova live-migration [--block-migrate] [--force] <server> [<host>]Migrate running server to a new machine.
Positional arguments:
<server>- Name or ID of server.
<host>- Destination host name.
Optional arguments:
--block-migrate- True in case of block_migration. (Default=auto:live_migration) (Supported by API versions '2.25' - '2.latest')
--force- Force to not verify the scheduler if a host is provided. (Supported by API versions '2.30' - '2.latest')
13.2.73. nova live-migration-abort
Copy linkLink copied to clipboard!
usage: nova live-migration-abort <server> <migration>
usage: nova live-migration-abort <server> <migration>Abort an on-going live migration. (Supported by API versions '2.24' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<server>- Name or ID of server.
<migration>- ID of migration.
13.2.74. nova live-migration-force-complete
Copy linkLink copied to clipboard!
usage: nova live-migration-force-complete <server> <migration>
usage: nova live-migration-force-complete <server> <migration>Force on-going live migration to complete. (Supported by API versions '2.22' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<server>- Name or ID of server.
<migration>- ID of migration.
13.2.75. nova lock
Copy linkLink copied to clipboard!
usage: nova lock <server>
usage: nova lock <server>Lock a server. A normal (non-admin) user will not be able to execute actions on a locked server.
Positional arguments:
<server>- Name or ID of server.
13.2.76. nova meta
Copy linkLink copied to clipboard!
usage: nova meta <server> <action> <key=value> [<key=value> ...]
usage: nova meta <server> <action> <key=value> [<key=value> ...]Set or delete metadata on a server.
Positional arguments:
<server>- Name or ID of server.
<action>- Actions: 'set' or 'delete'.
<key=value>- Metadata to set or delete (only key is necessary on delete).
13.2.77. nova migrate
Copy linkLink copied to clipboard!
usage: nova migrate [--poll] <server>
usage: nova migrate [--poll] <server>Migrate a server. The new host will be selected by the scheduler.
Positional arguments:
<server>- Name or ID of server.
Optional arguments:
--poll- Report the server migration progress until it completes.
13.2.78. nova migration-list
Copy linkLink copied to clipboard!
usage: nova migration-list [--host <host>] [--status <status>]
[--cell_name <cell_name>]
usage: nova migration-list [--host <host>] [--status <status>]
[--cell_name <cell_name>]Print a list of migrations.
Optional arguments:
--host <host>- Fetch migrations for the given host.
--status <status>- Fetch migrations for the given status.
--cell_name <cell_name>- Fetch migrations for the given cell_name.
13.2.79. nova pause
Copy linkLink copied to clipboard!
usage: nova pause <server>
usage: nova pause <server>Pause a server.
Positional arguments:
<server>- Name or ID of server.
13.2.80. nova quota-class-show
Copy linkLink copied to clipboard!
usage: nova quota-class-show <class>
usage: nova quota-class-show <class>List the quotas for a quota class.
Positional arguments:
<class>- Name of quota class to list the quotas for.
13.2.81. nova quota-class-update
Copy linkLink copied to clipboard!
Update the quotas for a quota class. (Supported by API versions '2.0' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<class>- Name of quota class to set the quotas for.
Optional arguments:
--instances <instances>- New value for the "instances" quota.
--cores <cores>- New value for the "cores" quota.
--ram <ram>- New value for the "ram" quota.
--metadata-items <metadata-items>- New value for the "metadata-items" quota.
--injected-files <injected-files>- New value for the "injected-files" quota.
--injected-file-content-bytes <injected-file-content-bytes>- New value for the "injected-file-content-bytes" quota.
--injected-file-path-bytes <injected-file-path-bytes>- New value for the "injected-file-path-bytes" quota.
--key-pairs <key-pairs>- New value for the "key-pairs" quota.
--server-groups <server-groups>- New value for the "server-groups" quota.
--server-group-members <server-group-members>- New value for the "server-group-members" quota.
13.2.82. nova quota-defaults
Copy linkLink copied to clipboard!
usage: nova quota-defaults [--tenant <tenant-id>]
usage: nova quota-defaults [--tenant <tenant-id>]List the default quotas for a tenant.
Optional arguments:
--tenant <tenant-id>- ID of tenant to list the default quotas for.
13.2.83. nova quota-delete
Copy linkLink copied to clipboard!
usage: nova quota-delete --tenant <tenant-id> [--user <user-id>]
usage: nova quota-delete --tenant <tenant-id> [--user <user-id>]Delete quota for a tenant/user so their quota will Revert back to default.
Optional arguments:
--tenant <tenant-id>- ID of tenant to delete quota for.
--user <user-id>- ID of user to delete quota for.
13.2.84. nova quota-show
Copy linkLink copied to clipboard!
usage: nova quota-show [--tenant <tenant-id>] [--user <user-id>] [--detail]
usage: nova quota-show [--tenant <tenant-id>] [--user <user-id>] [--detail]List the quotas for a tenant/user.
Optional arguments:
--tenant <tenant-id>- ID of tenant to list the quotas for.
--user <user-id>- ID of user to list the quotas for.
--detail- Show detailed info (limit, reserved, in-use).
13.2.85. nova quota-update
Copy linkLink copied to clipboard!
Update the quotas for a tenant/user. (Supported by API versions '2.0' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<tenant-id>- ID of tenant to set the quotas for.
Optional arguments:
--user <user-id>- ID of user to set the quotas for.
--instances <instances>- New value for the "instances" quota.
--cores <cores>- New value for the "cores" quota.
--ram <ram>- New value for the "ram" quota.
--metadata-items <metadata-items>- New value for the "metadata-items" quota.
--injected-files <injected-files>- New value for the "injected-files" quota.
--injected-file-content-bytes <injected-file-content-bytes>- New value for the "injected-file-content-bytes" quota.
--injected-file-path-bytes <injected-file-path-bytes>- New value for the "injected-file-path-bytes" quota.
--key-pairs <key-pairs>- New value for the "key-pairs" quota.
--server-groups <server-groups>- New value for the "server-groups" quota.
--server-group-members <server-group-members>- New value for the "server-group-members" quota.
--force- Whether force update the quota even if the already used and reserved exceeds the new quota.
13.2.86. nova reboot
Copy linkLink copied to clipboard!
usage: nova reboot [--hard] [--poll] <server> [<server> ...]
usage: nova reboot [--hard] [--poll] <server> [<server> ...]Reboot a server.
Positional arguments:
<server>- Name or ID of server(s).
Optional arguments:
--hard- Perform a hard reboot (instead of a soft one). Note: Ironic does not currently support soft reboot; consequently, bare metal nodes will always do a hard reboot, regardless of the use of this option.
--poll- Poll until reboot is complete.
13.2.87. nova rebuild
Copy linkLink copied to clipboard!
usage: nova rebuild [--rebuild-password <rebuild-password>] [--poll]
[--minimal] [--preserve-ephemeral] [--name <name>]
[--description <description>] [--meta <key=value>]
[--file <dst-path=src-path>]
<server> <image>
usage: nova rebuild [--rebuild-password <rebuild-password>] [--poll]
[--minimal] [--preserve-ephemeral] [--name <name>]
[--description <description>] [--meta <key=value>]
[--file <dst-path=src-path>]
<server> <image>Shutdown, re-image, and re-boot a server.
Positional arguments:
<server>- Name or ID of server.
<image>- Name or ID of new image.
Optional arguments:
--rebuild-password <rebuild-password>- Set the provided admin password on the rebuilt server.
--poll- Report the server rebuild progress until it completes.
--minimal- Skips flavor/image lookups when showing servers.
--preserve-ephemeral- Preserve the default ephemeral storage partition on rebuild.
--name <name>- Name for the new server.
--description <description>- New description for the server. (Supported by API versions '2.19' - '2.latest')
--meta <key=value>- Record arbitrary key/value metadata to /meta_data.json on the metadata server. Can be specified multiple times.
--file <dst-path=src-path>- Store arbitrary files from <src-path> locally to <dst-path> on the new server. You may store up to 5 files.
13.2.88. nova refresh-network
Copy linkLink copied to clipboard!
usage: nova refresh-network <server>
usage: nova refresh-network <server>Refresh server network information.
Positional arguments:
<server>- Name or ID of a server for which the network cache should be refreshed from neutron (Admin only).
13.2.89. nova remove-fixed-ip
Copy linkLink copied to clipboard!
usage: nova remove-fixed-ip <server> <address>
usage: nova remove-fixed-ip <server> <address>Remove an IP address from a server.
Positional arguments:
<server>- Name or ID of server.
<address>- IP Address.
13.2.90. nova remove-secgroup
Copy linkLink copied to clipboard!
usage: nova remove-secgroup <server> <secgroup>
usage: nova remove-secgroup <server> <secgroup>Remove a Security Group from a server.
Positional arguments:
<server>- Name or ID of server.
<secgroup>- Name of Security Group.
13.2.91. nova rescue
Copy linkLink copied to clipboard!
usage: nova rescue [--password <password>] [--image <image>] <server>
usage: nova rescue [--password <password>] [--image <image>] <server>Reboots a server into rescue mode, which starts the machine from either the initial image or a specified image, attaching the current boot disk as secondary.
Positional arguments:
<server>- Name or ID of server.
Optional arguments:
--password <password>- The admin password to be set in the rescue environment.
--image <image>- The image to rescue with.
13.2.92. nova reset-network
Copy linkLink copied to clipboard!
usage: nova reset-network <server>
usage: nova reset-network <server>Reset network of a server.
Positional arguments:
<server>- Name or ID of server.
13.2.93. nova reset-state
Copy linkLink copied to clipboard!
usage: nova reset-state [--all-tenants] [--active] <server> [<server> ...]
usage: nova reset-state [--all-tenants] [--active] <server> [<server> ...]Reset the state of a server.
Positional arguments:
<server>- Name or ID of server(s).
Optional arguments:
--all-tenants- Reset state server(s) in another tenant by name (Admin only).
--active- Request the server be reset to "active" state instead of "error" state (the default).
13.2.94. nova resize
Copy linkLink copied to clipboard!
usage: nova resize [--poll] <server> <flavor>
usage: nova resize [--poll] <server> <flavor>Resize a server.
Positional arguments:
<server>- Name or ID of server.
<flavor>- Name or ID of new flavor.
Optional arguments:
--poll- Report the server resize progress until it completes.
13.2.95. nova resize-confirm
Copy linkLink copied to clipboard!
usage: nova resize-confirm <server>
usage: nova resize-confirm <server>Confirm a previous resize.
Positional arguments:
<server>- Name or ID of server.
13.2.96. nova resize-revert
Copy linkLink copied to clipboard!
usage: nova resize-revert <server>
usage: nova resize-revert <server>Revert a previous resize (and return to the previous VM).
Positional arguments:
<server>- Name or ID of server.
13.2.97. nova restore
Copy linkLink copied to clipboard!
usage: nova restore <server>
usage: nova restore <server>Restore a soft-deleted server.
Positional arguments:
<server>- Name or ID of server.
13.2.98. nova resume
Copy linkLink copied to clipboard!
usage: nova resume <server>
usage: nova resume <server>Resume a server.
Positional arguments:
<server>- Name or ID of server.
13.2.99. nova server-group-create
Copy linkLink copied to clipboard!
usage: nova server-group-create <name> <policy> [<policy> ...]
usage: nova server-group-create <name> <policy> [<policy> ...]Create a new server group with the specified details.
Positional arguments:
<name>- Server group name.
<policy>- Policies for the server groups.
13.2.100. nova server-group-delete
Copy linkLink copied to clipboard!
usage: nova server-group-delete <id> [<id> ...]
usage: nova server-group-delete <id> [<id> ...]Delete specific server group(s).
Positional arguments:
<id>- Unique ID(s) of the server group to delete.
13.2.101. nova server-group-get
Copy linkLink copied to clipboard!
usage: nova server-group-get <id>
usage: nova server-group-get <id>Get a specific server group.
Positional arguments:
<id>- Unique ID of the server group to get.
13.2.102. nova server-group-list
Copy linkLink copied to clipboard!
usage: nova server-group-list [--limit <limit>] [--offset <offset>]
[--all-projects]
usage: nova server-group-list [--limit <limit>] [--offset <offset>]
[--all-projects]Print a list of all server groups.
Optional arguments:
--limit <limit>- Maximum number of server groups to display. If limit is bigger than 'CONF.api.max_limit' option of Nova API, limit 'CONF.api.max_limit' will be used instead.
--offset <offset>- The offset of groups list to display; use with limit to return a slice of server groups.
--all-projects- Display server groups from all projects (Admin only).
13.2.103. nova server-migration-list
Copy linkLink copied to clipboard!
usage: nova server-migration-list <server>
usage: nova server-migration-list <server>Get the migrations list of specified server. (Supported by API versions '2.23' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<server>- Name or ID of server.
13.2.104. nova server-migration-show
Copy linkLink copied to clipboard!
usage: nova server-migration-show <server> <migration>
usage: nova server-migration-show <server> <migration>Get the migration of specified server. (Supported by API versions '2.23' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<server>- Name or ID of server.
<migration>- ID of migration.
13.2.105. nova server-tag-add
Copy linkLink copied to clipboard!
usage: nova server-tag-add <server> <tag> [<tag> ...]
usage: nova server-tag-add <server> <tag> [<tag> ...]Add one or more tags to a server. (Supported by API versions '2.26' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<server>- Name or ID of server.
<tag>- Tag(s) to add.
13.2.106. nova server-tag-delete
Copy linkLink copied to clipboard!
usage: nova server-tag-delete <server> <tag> [<tag> ...]
usage: nova server-tag-delete <server> <tag> [<tag> ...]Delete one or more tags from a server. (Supported by API versions '2.26' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<server>- Name or ID of server.
<tag>- Tag(s) to delete.
13.2.107. nova server-tag-delete-all
Copy linkLink copied to clipboard!
usage: nova server-tag-delete-all <server>
usage: nova server-tag-delete-all <server>Delete all tags from a server. (Supported by API versions '2.26' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<server>- Name or ID of server.
13.2.108. nova server-tag-list
Copy linkLink copied to clipboard!
usage: nova server-tag-list <server>
usage: nova server-tag-list <server>Get list of tags from a server. (Supported by API versions '2.26' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<server>- Name or ID of server.
13.2.109. nova server-tag-set
Copy linkLink copied to clipboard!
usage: nova server-tag-set <server> <tags> [<tags> ...]
usage: nova server-tag-set <server> <tags> [<tags> ...]Set list of tags to a server. (Supported by API versions '2.26' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<server>- Name or ID of server.
<tags>- Tag(s) to set.
13.2.110. nova service-delete
Copy linkLink copied to clipboard!
usage: nova service-delete <id>
usage: nova service-delete <id>Delete the service.
Positional arguments:
<id>- ID of service.
13.2.111. nova service-disable
Copy linkLink copied to clipboard!
usage: nova service-disable [--reason <reason>] <hostname> <binary>
usage: nova service-disable [--reason <reason>] <hostname> <binary>Disable the service.
Positional arguments:
<hostname>- Name of host.
<binary>- Service binary.
Optional arguments:
--reason <reason>- Reason for disabling service.
13.2.112. nova service-enable
Copy linkLink copied to clipboard!
usage: nova service-enable <hostname> <binary>
usage: nova service-enable <hostname> <binary>Enable the service.
Positional arguments:
<hostname>- Name of host.
<binary>- Service binary.
13.2.113. nova service-force-down
Copy linkLink copied to clipboard!
usage: nova service-force-down [--unset] <hostname> <binary>
usage: nova service-force-down [--unset] <hostname> <binary>Force service to down. (Supported by API versions '2.11' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<hostname>- Name of host.
<binary>- Service binary.
Optional arguments:
--unset- Unset the force state down of service.
13.2.114. nova service-list
Copy linkLink copied to clipboard!
usage: nova service-list [--host <hostname>] [--binary <binary>]
usage: nova service-list [--host <hostname>] [--binary <binary>]Show a list of all running services. Filter by host & binary.
Optional arguments:
--host <hostname>- Name of host.
--binary <binary>- Service binary.
13.2.115. nova set-password
Copy linkLink copied to clipboard!
usage: nova set-password <server>
usage: nova set-password <server>Change the admin password for a server.
Positional arguments:
<server>- Name or ID of server.
13.2.116. nova shelve
Copy linkLink copied to clipboard!
usage: nova shelve <server>
usage: nova shelve <server>Shelve a server.
Positional arguments:
<server>- Name or ID of server.
13.2.117. nova shelve-offload
Copy linkLink copied to clipboard!
usage: nova shelve-offload <server>
usage: nova shelve-offload <server>Remove a shelved server from the compute node.
Positional arguments:
<server>- Name or ID of server.
13.2.118. nova show
Copy linkLink copied to clipboard!
usage: nova show [--minimal] [--wrap <integer>] <server>
usage: nova show [--minimal] [--wrap <integer>] <server>Show details about the given server.
Positional arguments:
<server>- Name or ID of server.
Optional arguments:
--minimal- Skips flavor/image lookups when showing servers.
--wrap <integer>- Wrap the output to a specified length, or 0 to disable.
13.2.119. nova ssh
Copy linkLink copied to clipboard!
usage: nova ssh [--port PORT] [--address-type ADDRESS_TYPE]
[--network <network>] [--ipv6] [--login <login>] [-i IDENTITY]
[--extra-opts EXTRA]
<server>
usage: nova ssh [--port PORT] [--address-type ADDRESS_TYPE]
[--network <network>] [--ipv6] [--login <login>] [-i IDENTITY]
[--extra-opts EXTRA]
<server>SSH into a server.
Positional arguments:
<server>- Name or ID of server.
Optional arguments:
--port PORT- Optional flag to indicate which port to use for ssh. (Default=22)
--address-type ADDRESS_TYPE- Optional flag to indicate which IP type to use. Possible values includes fixed and floating (the Default).
--network <network>- Network to use for the ssh.
--ipv6- Optional flag to indicate whether to use an IPv6 address attached to a server. (Defaults to IPv4 address)
--login <login>- Login to use.
-i IDENTITY, --identity IDENTITY- Private key file, same as the -i option to the ssh command.
--extra-opts EXTRA- Extra options to pass to ssh. see: man ssh.
13.2.120. nova start
Copy linkLink copied to clipboard!
usage: nova start [--all-tenants] <server> [<server> ...]
usage: nova start [--all-tenants] <server> [<server> ...]Start the server(s).
Positional arguments:
<server>- Name or ID of server(s).
Optional arguments:
--all-tenants- Start server(s) in another tenant by name (Admin only).
13.2.121. nova stop
Copy linkLink copied to clipboard!
usage: nova stop [--all-tenants] <server> [<server> ...]
usage: nova stop [--all-tenants] <server> [<server> ...]Stop the server(s).
Positional arguments:
<server>- Name or ID of server(s).
Optional arguments:
--all-tenants- Stop server(s) in another tenant by name (Admin only).
13.2.122. nova suspend
Copy linkLink copied to clipboard!
usage: nova suspend <server>
usage: nova suspend <server>Suspend a server.
Positional arguments:
<server>- Name or ID of server.
13.2.123. nova trigger-crash-dump
Copy linkLink copied to clipboard!
usage: nova trigger-crash-dump <server>
usage: nova trigger-crash-dump <server>Trigger crash dump in an instance. (Supported by API versions '2.17' - '2.latest') [hint: use '--os-compute-api-version' flag to show help message for proper version]
Positional arguments:
<server>- Name or ID of server.
13.2.124. nova unlock
Copy linkLink copied to clipboard!
usage: nova unlock <server>
usage: nova unlock <server>Unlock a server.
Positional arguments:
<server>- Name or ID of server.
13.2.125. nova unpause
Copy linkLink copied to clipboard!
usage: nova unpause <server>
usage: nova unpause <server>Unpause a server.
Positional arguments:
<server>- Name or ID of server.
13.2.126. nova unrescue
Copy linkLink copied to clipboard!
usage: nova unrescue <server>
usage: nova unrescue <server>Restart the server from normal boot disk again.
Positional arguments:
<server>- Name or ID of server.
13.2.127. nova unshelve
Copy linkLink copied to clipboard!
usage: nova unshelve <server>
usage: nova unshelve <server>Unshelve a server.
Positional arguments:
<server>- Name or ID of server.
13.2.128. nova update
Copy linkLink copied to clipboard!
usage: nova update [--name <name>] [--description <description>] <server>
usage: nova update [--name <name>] [--description <description>] <server>Update the name or the description for a server.
Positional arguments:
<server>- Name (old name) or ID of server.
Optional arguments:
--name <name>- New name for the server.
--description <description>- New description for the server. If it equals to empty string (i.g. ""), the server description will be removed. (Supported by API versions '2.19' - '2.latest')
13.2.129. nova usage
Copy linkLink copied to clipboard!
usage: nova usage [--start <start>] [--end <end>] [--tenant <tenant-id>]
usage: nova usage [--start <start>] [--end <end>] [--tenant <tenant-id>]Show usage data for a single tenant.
Optional arguments:
--start <start>- Usage range start date ex 2012-01-20. (default: 4 weeks ago)
--end <end>- Usage range end date, ex 2012-01-20. (default: tomorrow)
--tenant <tenant-id>- UUID of tenant to get usage for.
13.2.130. nova usage-list
Copy linkLink copied to clipboard!
usage: nova usage-list [--start <start>] [--end <end>]
usage: nova usage-list [--start <start>] [--end <end>]List usage data for all tenants.
Optional arguments:
--start <start>- Usage range start date ex 2012-01-20. (default: 4 weeks ago)
--end <end>- Usage range end date, ex 2012-01-20. (default: tomorrow)
13.2.131. nova version-list
Copy linkLink copied to clipboard!
usage: nova version-list
usage: nova version-listList all API versions.
13.2.132. nova virtual-interface-list
Copy linkLink copied to clipboard!
usage: nova virtual-interface-list <server>
usage: nova virtual-interface-list <server>Show virtual interface info about the given server.
Positional arguments:
<server>- ID of server.
13.2.133. nova volume-attach
Copy linkLink copied to clipboard!
usage: nova volume-attach <server> <volume> [<device>]
usage: nova volume-attach <server> <volume> [<device>]Attach a volume to a server.
Positional arguments:
<server>- Name or ID of server.
<volume>- ID of the volume to attach.
<device>- Name of the device e.g. /dev/vdb. Use "auto" for autoassign (if supported). Libvirt driver will use default device name.
13.2.134. nova volume-attachments
Copy linkLink copied to clipboard!
usage: nova volume-attachments <server>
usage: nova volume-attachments <server>List all the volumes attached to a server.
Positional arguments:
<server>- Name or ID of server.
13.2.135. nova volume-detach
Copy linkLink copied to clipboard!
usage: nova volume-detach <server> <volume>
usage: nova volume-detach <server> <volume>Detach a volume from a server.
Positional arguments:
<server>- Name or ID of server.
<volume>- ID of the volume to detach.
13.2.136. nova volume-update
Copy linkLink copied to clipboard!
usage: nova volume-update <server> <attachment> <volume>
usage: nova volume-update <server> <attachment> <volume>Update volume attachment.
Positional arguments:
<server>- Name or ID of server.
<attachment>- Attachment ID of the volume.
<volume>- ID of the volume to attach.
13.2.137. nova x509-create-cert
Copy linkLink copied to clipboard!
usage: nova x509-create-cert [<private-key-filename>] [<x509-cert-filename>]
usage: nova x509-create-cert [<private-key-filename>] [<x509-cert-filename>]Create x509 cert for a user in tenant.
Positional arguments:
<private-key-filename>- Filename for the private key. [Default: pk.pem]
<x509-cert-filename>- Filename for the X.509 certificate. [Default: cert.pem]
13.2.138. nova x509-get-root-cert
Copy linkLink copied to clipboard!
usage: nova x509-get-root-cert [<filename>]
usage: nova x509-get-root-cert [<filename>]Fetch the x509 root cert.
Positional arguments:
<filename>- Filename to write the x509 root cert.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}