Compute command-line clientThe nova client is the command-line
interface (CLI) for the OpenStack Compute API and its extensions.
This chapter documents nova version
2.31.0.
For help on a specific nova
command, enter:
$novaCOMMANDnova usageusage: nova [--version] [--debug] [--os-cache] [--timings]
[--os-auth-token OS_AUTH_TOKEN]
[--os-tenant-name <auth-tenant-name>]
[--os-tenant-id <auth-tenant-id>] [--os-region-name <region-name>]
[--os-auth-system <auth-system>] [--service-type <service-type>]
[--service-name <service-name>]
[--volume-service-name <volume-service-name>]
[--os-endpoint-type <endpoint-type>]
[--os-compute-api-version <compute-api-ver>]
[--bypass-url <bypass-url>] [--insecure]
[--os-cacert <ca-certificate>] [--os-cert <certificate>]
[--os-key <key>] [--timeout <seconds>] [--os-auth-url OS_AUTH_URL]
[--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-user-id OS_USER_ID]
[--os-user-name OS_USERNAME]
[--os-user-domain-id OS_USER_DOMAIN_ID]
[--os-user-domain-name OS_USER_DOMAIN_NAME]
[--os-password OS_PASSWORD]
<subcommand> ...Subcommandsabsolute-limitsDEPRECATED, use limits instead.
add-fixed-ip
Add new IP address on a network to server.
add-floating-ipDEPRECATED, use floating-ip-associate instead.
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-details
Show details of the specified 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-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.
clear-password
Clear the admin password for a server.
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.
credentials
Show user credentials returned from auth.
delete
Immediately shut down and delete specified
server(s).
diagnostics
Retrieve server diagnostics.
dns-create
Create a DNS entry for domain, name, and IP.
dns-create-private-domain
Create the specified DNS domain.
dns-create-public-domain
Create the specified DNS domain.
dns-delete
Delete the specified DNS entry.
dns-delete-domain
Delete the specified DNS domain.
dns-domains
Print a list of available dns domains.
dns-list
List current DNS entries for domain and IP or
domain and name.
endpoints
Discover endpoints that get returned from the
authenticate services.
evacuate
Evacuate server from failed host.
fixed-ip-get
Retrieve info on a fixed IP.
fixed-ip-reserve
Reserve a fixed IP.
fixed-ip-unreserve
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
Bulk create floating IPs by range (nova-
network only).
floating-ip-bulk-delete
Bulk delete floating IPs by range (nova-
network only).
floating-ip-bulk-list
List all floating IPs (nova-network only).
floating-ip-create
Allocate a floating IP for the current tenant.
floating-ip-delete
De-allocate a floating IP.
floating-ip-disassociate
Disassociate a floating IP address from a
server.
floating-ip-list
List floating IPs.
floating-ip-pool-list
List all floating IP pools.
get-password
Get the admin password for a server.
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-list
List all hosts by service.
host-update
Update host settings.
hypervisor-list
List hypervisors.
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
Delete specified image(s).
image-list
Print a list of available images to boot from.
image-meta
Set or Delete metadata on an image.
image-show
Show details about the given image.
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.
keypair-list
Print a list of keypairs for a user
keypair-show
Show details about the given keypair.
limits
Print rate and absolute limits.
list
List active servers.
list-secgroup
List Security Group(s) of a server.
live-migration
Migrate running server to a new machine.
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.
network-associate-host
Associate host with network.
network-associate-project
Associate project with network.
network-create
Create a network.
network-delete
Delete network by label or id.
network-disassociate
Disassociate host and/or project from the
given network.
network-list
Print a list of available networks.
network-show
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.
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.
rate-limitsDEPRECATED, use limits instead.
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-floating-ipDEPRECATED, use floating-ip-disassociate
instead.
remove-secgroup
Remove a Security Group from a server.
rename
Rename 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).
resume
Resume a server.
root-passwordDEPRECATED, use set-password instead.
scrub
Delete networks and security groups associated
with a project.
secgroup-add-default-rule
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
Add a source group rule to a security group.
secgroup-add-rule
Add a rule to a security group.
secgroup-create
Create a security group.
secgroup-delete
Delete a security group.
secgroup-delete-default-rule
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
Delete a source group rule from a security
group.
secgroup-delete-rule
Delete a rule from a security group.
secgroup-list
List security groups for the current tenant.
secgroup-list-default-rules
List rules that will be added to the 'default'
security group for new tenants.
secgroup-list-rules
List rules for a security group.
secgroup-update
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.
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')
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.
unlock
Unlock a server.
unpause
Unpause a server.
unrescue
Restart the server from normal boot disk
again.
unshelve
Unshelve a server.
usage
Show usage data for a single tenant.
usage-list
List usage data for all tenants.
version-list
List all API versions.
volume-attach
Attach a volume to a server.
volume-createDEPRECATED: Add a new volume.
volume-deleteDEPRECATED: Remove volume(s).
volume-detach
Detach a volume from a server.
volume-listDEPRECATED: List all the volumes.
volume-showDEPRECATED: Show details about a volume.
volume-snapshot-createDEPRECATED: Add a new snapshot.
volume-snapshot-deleteDEPRECATED: Remove a snapshot.
volume-snapshot-listDEPRECATED: List all the snapshots.
volume-snapshot-showDEPRECATED: Show details about a snapshot.
volume-type-createDEPRECATED: Create a new volume type.
volume-type-deleteDEPRECATED: Delete a specific volume type.
volume-type-listDEPRECATED: Print a list of available 'volume
types'.
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.
host-evacuate
Evacuate all instances from failed host.
netDEPRECATED, Use tenant-network-show instead.
net-createDEPRECATED, use tenant-network-create instead.
net-deleteDEPRECATED, use tenant-network-delete instead.
net-listDEPRECATED, use tenant-network-list instead.
tenant-network-create
Create a tenant network.
tenant-network-delete
Delete a tenant network.
tenant-network-list
List tenant networks.
tenant-network-show
Show a tenant network.
migration-list
Print a list of migrations.
list-extensions
List all the os-api extensions that are
available.
host-meta
Set or Delete metadata on all instances of a
host.
instance-action
Show an action.
instance-action-list
List actions on a server.
baremetal-interface-add
Add a network interface to a baremetal node.
baremetal-interface-list
List network interfaces associated with a
baremetal node.
baremetal-interface-remove
Remove a network interface from a baremetal
node.
baremetal-node-create
Create a baremetal node.
baremetal-node-delete
Remove a baremetal node and any associated
interfaces.
baremetal-node-list
Print list of available baremetal nodes.
baremetal-node-show
Show information about a baremetal node.
force-delete
Force delete a server.
restore
Restore a soft-deleted server.
host-evacuate-live
Live migrate all instances of the specified
host to other available hosts.
cell-capacities
Get cell capacities for all cells or a given
cell.
cell-show
Show details of a given cell.
host-servers-migrate
Migrate all instances of the specified host to
other available hosts.
nova optional arguments--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-auth-token OS_AUTH_TOKEN
Defaults to env[OS_AUTH_TOKEN].
--os-tenant-name <auth-tenant-name>
Defaults to env[OS_TENANT_NAME].
--os-tenant-id <auth-tenant-id>
Defaults to env[OS_TENANT_ID].
--os-region-name <region-name>
Defaults to env[OS_REGION_NAME].
--os-auth-system <auth-system>
Defaults to env[OS_AUTH_SYSTEM].
--service-type <service-type>
Defaults to compute for most actions.
--service-name <service-name>
Defaults to env[NOVA_SERVICE_NAME].
--volume-service-name <volume-service-name>
Defaults to env[NOVA_VOLUME_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].
--bypass-url <bypass-url>
Use this API endpoint instead of the Service
Catalog. Defaults to
env[NOVACLIENT_BYPASS_URL].
--insecure
Explicitly allow client to perform "insecure"
TLS (https) requests. The server's certificate
will not be verified against any certificate
authorities. This option should be used with
caution.
--os-cacert <ca-certificate>
Specify a CA bundle file to use in verifying a
TLS (https) server certificate. Defaults to
env[OS_CACERT].
--os-cert <certificate>
Defaults to env[OS_CERT].
--os-key <key>
Defaults to env[OS_KEY].
--timeout <seconds>
Set request timeout (in seconds).
--os-auth-url OS_AUTH_URL
Authentication URL
--os-domain-id OS_DOMAIN_ID
Domain ID to scope to
--os-domain-name OS_DOMAIN_NAME
Domain name to scope to
--os-project-id OS_PROJECT_ID
Project ID to scope to
--os-project-name OS_PROJECT_NAME
Project name to scope to
--os-project-domain-id OS_PROJECT_DOMAIN_ID
Domain ID containing project
--os-project-domain-name OS_PROJECT_DOMAIN_NAME
Domain name containing project
--os-trust-id OS_TRUST_ID
Trust ID
--os-user-id OS_USER_ID
User ID
--os-user-name OS_USERNAME, --os-username OS_USERNAME
Username
--os-user-domain-id OS_USER_DOMAIN_ID
User's domain id
--os-user-domain-name OS_USER_DOMAIN_NAME
User's domain name
--os-password OS_PASSWORD
User's password
nova add-fixed-ipusage: 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.
nova add-secgroupusage: nova add-secgroup <server> <secgroup>
Add a Security Group to a server.
Positional arguments<server>
Name or ID of server.
<secgroup>
Name of Security Group.
nova agent-createusage: 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.
nova agent-deleteusage: nova agent-delete <id>
Delete existing agent build.
Positional arguments<id>
ID of the agent-build.
nova agent-listusage: nova agent-list [--hypervisor <hypervisor>]
List all builds.
Optional arguments--hypervisor <hypervisor>
Type of hypervisor.
nova agent-modifyusage: 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.
nova aggregate-add-hostusage: 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.
nova aggregate-createusage: 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).
nova aggregate-deleteusage: nova aggregate-delete <aggregate>
Delete the aggregate.
Positional arguments<aggregate>
Name or ID of aggregate to delete.
nova aggregate-detailsusage: nova aggregate-details <aggregate>
Show details of the specified aggregate.
Positional arguments<aggregate>
Name or ID of aggregate.
nova aggregate-listusage: nova aggregate-list
Print a list of all aggregates.
nova aggregate-remove-hostusage: 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.
nova aggregate-set-metadatausage: 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.
nova aggregate-updateusage: nova aggregate-update <aggregate> <name> [<availability-zone>]
Update the aggregate's name and optionally availability zone.
Positional arguments<aggregate>
Name or ID of aggregate to update.
<name>
Name of aggregate.
<availability-zone>
The availability zone of the aggregate.
nova availability-zone-listusage: nova availability-zone-list
List all the availability zones.
nova backupusage: 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.
nova baremetal-interface-addusage: nova baremetal-interface-add [--datapath_id <datapath_id>]
[--port_no <port_no>]
<node> <address>
Add a network interface to a baremetal node.
Positional arguments<node>
ID of node
<address>
MAC address of interface
Optional arguments--datapath_id <datapath_id>
OpenFlow Datapath ID of interface
--port_no <port_no>
OpenFlow port number of interface
nova baremetal-interface-listusage: nova baremetal-interface-list <node>
List network interfaces associated with a baremetal node.
Positional arguments<node>
ID of node
nova baremetal-interface-removeusage: nova baremetal-interface-remove <node> <address>
Remove a network interface from a baremetal node.
Positional arguments<node>
ID of node
<address>
MAC address of interface
nova baremetal-node-createusage: nova baremetal-node-create [--pm_address <pm_address>]
[--pm_user <pm_user>]
[--pm_password <pm_password>]
[--terminal_port <terminal_port>]
<service_host> <cpus> <memory_mb> <local_gb>
<prov_mac_address>
Create a baremetal node.
Positional arguments<service_host>
Name of nova compute host which will control
this baremetal node
<cpus>
Number of CPUs in the node
<memory_mb>
Megabytes of RAM in the node
<local_gb>
Gigabytes of local storage in the node
<prov_mac_address>
MAC address to provision the node
Optional arguments--pm_address <pm_address>
Power management IP for the node
--pm_user <pm_user>
Username for the node's power management
--pm_password <pm_password>
Password for the node's power management
--terminal_port <terminal_port>
ShellInABox port?
nova baremetal-node-deleteusage: nova baremetal-node-delete <node>
Remove a baremetal node and any associated interfaces.
Positional arguments<node>
ID of the node to delete.
nova baremetal-node-listusage: nova baremetal-node-list
Print list of available baremetal nodes.
nova baremetal-node-showusage: nova baremetal-node-show <node>
Show information about a baremetal node.
Positional arguments<node>
ID of node
nova bootusage: 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>]
[--file <dst-path=src-path>] [--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 <net-id=net-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr,port-id=port-uuid>]
[--config-drive <value>] [--poll] [--admin-pass <value>]
<name>
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 'nova image-list').
--image-with <key=value>
Image metadata property (see 'nova 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, ...; if omitted, hypervisor
driver chooses suitable device depending on
selected bus), 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).
--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 <net-id=net-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr,port-id=port-uuid>
Create a NIC on the server. Specify option
multiple times to create multiple NICs. net-
id: attach NIC to network with this UUID
(either port-id or net-id 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 (either port-id or net-id
must be provided).
--config-drive <value>
Enable config drive.
--poll
Report the new server boot progress until it
completes.
--admin-pass <value>
Admin password for the instance.
nova cell-capacitiesusage: 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.
nova cell-showusage: nova cell-show <cell-name>
Show details of a given cell.
Positional arguments<cell-name>
Name of the cell.
nova clear-passwordusage: nova clear-password <server>
Clear the admin password for a server.
Positional arguments<server>
Name or ID of server.
nova cloudpipe-configureusage: 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.
nova cloudpipe-createusage: 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.
nova cloudpipe-listusage: nova cloudpipe-list
Print a list of all cloudpipe instances.
nova console-logusage: 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.
nova credentialsusage: nova credentials [--wrap <integer>]
Show user credentials returned from auth.
Optional arguments--wrap <integer>
Wrap PKI tokens to a specified length, or 0 to disable.
nova deleteusage: 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).
nova diagnosticsusage: nova diagnostics <server>
Retrieve server diagnostics.
Positional arguments<server>
Name or ID of server.
nova dns-createusage: nova dns-create [--type <type>] <ip> <name> <domain>
Create a DNS entry for domain, name, and IP.
Positional arguments<ip>
IP address.
<name>
DNS name.
<domain>
DNS domain.
Optional arguments--type <type>
DNS type (e.g. "A")
nova dns-create-private-domainusage: nova dns-create-private-domain
[--availability-zone <availability-zone>]
<domain>
Create the specified DNS domain.
Positional arguments<domain>
DNS domain.
Optional arguments--availability-zone <availability-zone>
Limit access to this domain to servers in the
specified availability zone.
nova dns-create-public-domainusage: nova dns-create-public-domain [--project <project>] <domain>
Create the specified DNS domain.
Positional arguments<domain>
DNS domain.
Optional arguments--project <project>
Limit access to this domain to users of the specified
project.
nova dns-deleteusage: nova dns-delete <domain> <name>
Delete the specified DNS entry.
Positional arguments<domain>
DNS domain.
<name>
DNS name.
nova dns-delete-domainusage: nova dns-delete-domain <domain>
Delete the specified DNS domain.
Positional arguments<domain>
DNS domain.
nova dns-domainsusage: nova dns-domains
Print a list of available dns domains.
nova dns-listusage: nova dns-list [--ip <ip>] [--name <name>] <domain>
List current DNS entries for domain and IP or domain and name.
Positional arguments<domain>
DNS domain.
Optional arguments--ip <ip>
IP address.
--name <name>
DNS name.
nova endpointsusage: nova endpoints
Discover endpoints that get returned from the authenticate services.
nova evacuateusage: nova evacuate [--password <password>] [--on-shared-storage]
<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 with on-shared-storage flag.
--on-shared-storage
Specifies whether server files are located on shared
storage.
nova fixed-ip-getusage: nova fixed-ip-get <fixed_ip>
Retrieve info on a fixed IP.
Positional arguments<fixed_ip>
Fixed IP Address.
nova fixed-ip-reserveusage: nova fixed-ip-reserve <fixed_ip>
Reserve a fixed IP.
Positional arguments<fixed_ip>
Fixed IP Address.
nova fixed-ip-unreserveusage: nova fixed-ip-unreserve <fixed_ip>
Unreserve a fixed IP.
Positional arguments<fixed_ip>
Fixed IP Address.
nova flavor-access-addusage: 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.
nova flavor-access-listusage: 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.
nova flavor-access-removeusage: 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.
nova flavor-createusage: 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>
Name of the new flavor.
<id>
Unique ID (integer or UUID) for the new flavor. If
specifying 'auto', a UUID will be generated as 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).
nova flavor-deleteusage: nova flavor-delete <flavor>
Delete a specific flavor
Positional arguments<flavor>
Name or ID of the flavor to delete.
nova flavor-keyusage: 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).
nova flavor-listusage: nova flavor-list [--extra-specs] [--all]
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).
nova flavor-showusage: nova flavor-show <flavor>
Show details about the given flavor.
Positional arguments<flavor>
Name or ID of flavor.
nova floating-ip-associateusage: 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.
nova floating-ip-bulk-createusage: nova floating-ip-bulk-create [--pool <pool>] [--interface <interface>]
<range>
Bulk create floating IPs by range (nova-network only).
Positional arguments<range>
Address range to create.
Optional arguments--pool <pool>
Pool for new Floating IPs.
--interface <interface>
Interface for new Floating IPs.
nova floating-ip-bulk-deleteusage: nova floating-ip-bulk-delete <range>
Bulk delete floating IPs by range (nova-network only).
Positional arguments<range>
Address range to delete.
nova floating-ip-bulk-listusage: nova floating-ip-bulk-list [--host <host>]
List all floating IPs (nova-network only).
Optional arguments--host <host>
Filter by host.
nova floating-ip-createusage: nova floating-ip-create [<floating-ip-pool>]
Allocate a floating IP for the current tenant.
Positional arguments<floating-ip-pool>
Name of Floating IP Pool. (Optional)
nova floating-ip-deleteusage: nova floating-ip-delete <address>
De-allocate a floating IP.
Positional arguments<address>
IP of Floating IP.
nova floating-ip-disassociateusage: 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.
nova floating-ip-listusage: nova floating-ip-list
List floating IPs.
nova floating-ip-pool-listusage: nova floating-ip-pool-list
List all floating IP pools.
nova force-deleteusage: nova force-delete <server>
Force delete a server.
Positional arguments<server>
Name or ID of server.
nova get-passwordusage: nova get-password <server> [<private-key>]
Get the admin password for a server.
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.
nova get-rdp-consoleusage: 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").
nova get-serial-consoleusage: 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".
nova get-spice-consoleusage: 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").
nova get-vnc-consoleusage: 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").
nova host-actionusage: 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.
nova host-describeusage: nova host-describe <hostname>
Describe a specific host.
Positional arguments<hostname>
Name of host.
nova host-evacuateusage: nova host-evacuate [--target_host <target_host>] [--on-shared-storage]
<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.
--on-shared-storage
Specifies whether all instances files are on
shared storage
nova host-evacuate-liveusage: nova host-evacuate-live [--target-host <target_host>] [--block-migrate]
[--disk-over-commit]
[--max-servers <max_servers>]
<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.
--disk-over-commit
Enable disk overcommit.
--max-servers <max_servers>
Maximum number of servers to live migrate
simultaneously
nova host-listusage: 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>.
nova host-metausage: 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)
nova host-servers-migrateusage: nova host-servers-migrate <host>
Migrate all instances of the specified host to other available hosts.
Positional arguments<host>
Name of host.
nova host-updateusage: 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.
nova hypervisor-listusage: nova hypervisor-list [--matching <hostname>]
List hypervisors.
Optional arguments--matching <hostname>
List hypervisors matching the given <hostname>.
nova hypervisor-serversusage: nova hypervisor-servers <hostname>
List servers belonging to specific hypervisors.
Positional arguments<hostname>
The hypervisor hostname (or pattern) to search for.
nova hypervisor-showusage: 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
nova hypervisor-statsusage: nova hypervisor-stats
Get hypervisor statistics over all compute nodes.
nova hypervisor-uptimeusage: 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.
nova image-createusage: nova image-create [--show] [--poll] <server> <name>
Create a new image by taking a snapshot of a running server.
Positional arguments<server>
Name or ID of server.
<name>
Name of snapshot.
Optional arguments--show
Print image info.
--poll
Report the snapshot progress and poll until image creation is
complete.
nova image-deleteusage: nova image-delete <image> [<image> ...]
Delete specified image(s).
Positional arguments<image>
Name or ID of image(s).
nova image-listusage: nova image-list [--limit <limit>]
Print a list of available images to boot from.
Optional arguments--limit <limit>
Number of images to return per request.
nova image-metausage: nova image-meta <image> <action> <key=value> [<key=value> ...]
Set or Delete metadata on an image.
Positional arguments<image>
Name or ID of image.
<action>
Actions: 'set' or 'delete'.
<key=value>
Metadata to add/update or delete (only key is necessary on
delete).
nova image-showusage: nova image-show <image>
Show details about the given image.
Positional arguments<image>
Name or ID of image.
nova instance-actionusage: nova instance-action <server> <request_id>
Show an action.
Positional arguments<server>
Name or UUID of the server to show an action for.
<request_id>
Request ID of the action to get.
nova instance-action-listusage: nova instance-action-list <server>
List actions on a server.
Positional arguments<server>
Name or UUID of the server to list actions for.
nova interface-attachusage: 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.
nova interface-detachusage: 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.
nova interface-listusage: nova interface-list <server>
List interfaces attached to a server.
Positional arguments<server>
Name or ID of server.
nova keypair-addusage: nova keypair-add [--pub-key <pub-key>] [--key-type <key-type>] <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')
nova keypair-deleteusage: nova keypair-delete <name>
Delete keypair given by its name.
Positional arguments<name>
Keypair name to delete.
nova keypair-listusage: nova keypair-list
Print a list of keypairs for a user
nova keypair-showusage: nova keypair-show <keypair>
Show details about the given keypair.
Positional arguments<keypair>
Name of keypair.
nova limitsusage: 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.
nova listusage: nova list [--reservation-id <reservation-id>] [--ip <ip-regexp>]
[--ip6 <ip6-regexp>] [--name <name-regexp>]
[--instance-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>]
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 'osapi_max_limit' option of
Nova API, limit 'osapi_max_limit' will be used
instead.
nova list-extensionsusage: nova list-extensions
List all the os-api extensions that are available.
nova list-secgroupusage: nova list-secgroup <server>
List Security Group(s) of a server.
Positional arguments<server>
Name or ID of server.
nova live-migrationusage: nova live-migration [--block-migrate] [--disk-over-commit]
<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=False:live_migration)
--disk-over-commit
Allow overcommit. (Default=False)
nova lockusage: 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.
nova metausage: 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).
nova migrateusage: 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.
nova migration-listusage: 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.
nova network-associate-hostusage: nova network-associate-host <network> <host>
Associate host with network.
Positional arguments<network>
UUID of network.
<host>
Name of host
nova network-associate-projectusage: nova network-associate-project <network>
Associate project with network.
Positional arguments<network>
UUID of network.
nova network-createusage: nova network-create [--fixed-range-v4 <x.x.x.x/yy>]
[--fixed-range-v6 CIDR_V6] [--vlan <vlan id>]
[--vlan-start <vlan start>] [--vpn <vpn start>]
[--gateway GATEWAY] [--gateway-v6 GATEWAY_V6]
[--bridge <bridge>]
[--bridge-interface <bridge interface>]
[--multi-host <'T'|'F'>] [--dns1 <DNS Address>]
[--dns2 <DNS Address>] [--uuid <network uuid>]
[--fixed-cidr <x.x.x.x/yy>]
[--project-id <project id>] [--priority <number>]
[--mtu MTU] [--enable-dhcp <'T'|'F'>]
[--dhcp-server DHCP_SERVER]
[--share-address <'T'|'F'>]
[--allowed-start ALLOWED_START]
[--allowed-end ALLOWED_END]
<network_label>
Create a network.
Positional arguments<network_label>
Label for network
Optional arguments--fixed-range-v4 <x.x.x.x/yy>
IPv4 subnet (ex: 10.0.0.0/8)
--fixed-range-v6
CIDR_V6 IPv6 subnet (ex: fe80::/64
--vlan <vlan id>
The vlan ID to be assigned to the project.
--vlan-start <vlan start>
First vlan ID to be assigned to the project.
Subsequent vlan IDs will be assigned
incrementally.
--vpn <vpn start>
vpn start
--gateway GATEWAY
gateway
--gateway-v6
GATEWAY_V6 IPv6 gateway
--bridge <bridge>
VIFs on this network are connected to this
bridge.
--bridge-interface <bridge interface>
The bridge is connected to this interface.
--multi-host <'T'|'F'>
Multi host
--dns1 <DNS Address>
First DNS.
--dns2 <DNS Address>
Second DNS.
--uuid <network uuid>
Network UUID.
--fixed-cidr <x.x.x.x/yy>
IPv4 subnet for fixed IPs (ex: 10.20.0.0/16).
--project-id <project id>
Project ID.
--priority <number>
Network interface priority.
--mtu MTU
MTU for network.
--enable-dhcp <'T'|'F'>
Enable DHCP.
--dhcp-server DHCP_SERVER
DHCP-server address (defaults to gateway
address)
--share-address <'T'|'F'>
Share address
--allowed-start ALLOWED_START
Start of allowed addresses for instances.
--allowed-end ALLOWED_END
End of allowed addresses for instances.
nova network-deleteusage: nova network-delete <network>
Delete network by label or id.
Positional arguments<network>
UUID or label of network.
nova network-disassociateusage: nova network-disassociate [--host-only [<0|1>]]
[--project-only [<0|1>]]
<network>
Disassociate host and/or project from the given network.
Positional arguments<network>
UUID of network.
Optional arguments--host-only [<0|1>]--project-only [<0|1>]nova network-listusage: nova network-list [--fields <fields>]
Print a list of available networks.
Optional arguments--fields <fields>
Comma-separated list of fields to display. Use the show
command to see which fields are available.
nova network-showusage: nova network-show <network>
Show details about the given network.
Positional arguments<network>
UUID or label of network.
nova pauseusage: nova pause <server>
Pause a server.
Positional arguments<server>
Name or ID of server.
nova quota-class-showusage: nova quota-class-show <class>
List the quotas for a quota class.
Positional arguments<class>
Name of quota class to list the quotas for.
nova quota-class-updateusage: nova quota-class-update [--instances <instances>] [--cores <cores>]
[--ram <ram>] [--floating-ips <floating-ips>]
[--fixed-ips <fixed-ips>]
[--metadata-items <metadata-items>]
[--injected-files <injected-files>]
[--injected-file-content-bytes <injected-file-content-bytes>]
[--injected-file-path-bytes <injected-file-path-bytes>]
[--key-pairs <key-pairs>]
[--security-groups <security-groups>]
[--security-group-rules <security-group-rules>]
[--server-groups <server-groups>]
[--server-group-members <server-group-members>]
<class>
Update the quotas for a quota class.
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.
--floating-ips <floating-ips>
New value for the "floating-ips" quota.
--fixed-ips <fixed-ips>
New value for the "fixed-ips" 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.
--security-groups <security-groups>
New value for the "security-groups" quota.
--security-group-rules <security-group-rules>
New value for the "security-group-rules"
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.
nova quota-defaultsusage: 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.
nova quota-deleteusage: 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.
nova quota-showusage: nova quota-show [--tenant <tenant-id>] [--user <user-id>]
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.
nova quota-updateusage: nova quota-update [--user <user-id>] [--instances <instances>]
[--cores <cores>] [--ram <ram>]
[--floating-ips <floating-ips>]
[--fixed-ips <fixed-ips>]
[--metadata-items <metadata-items>]
[--injected-files <injected-files>]
[--injected-file-content-bytes <injected-file-content-bytes>]
[--injected-file-path-bytes <injected-file-path-bytes>]
[--key-pairs <key-pairs>]
[--security-groups <security-groups>]
[--security-group-rules <security-group-rules>]
[--server-groups <server-groups>]
[--server-group-members <server-group-members>]
[--force]
<tenant-id>
Update the quotas for a tenant/user.
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.
--floating-ips <floating-ips>
New value for the "floating-ips" quota.
--fixed-ips <fixed-ips>
New value for the "fixed-ips" 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.
--security-groups <security-groups>
New value for the "security-groups" quota.
--security-group-rules <security-group-rules>
New value for the "security-group-rules"
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.
nova rebootusage: 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).
--poll
Poll until reboot is complete.
nova rebuildusage: nova rebuild [--rebuild-password <rebuild-password>] [--poll]
[--minimal] [--preserve-ephemeral] [--name <name>]
[--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.
--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.
nova refresh-networkusage: 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).
nova remove-fixed-ipusage: nova remove-fixed-ip <server> <address>
Remove an IP address from a server.
Positional arguments<server>
Name or ID of server.
<address>
IP Address.
nova remove-secgroupusage: 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.
nova renameusage: nova rename <server> <name>
Rename a server.
Positional arguments<server>
Name (old name) or ID of server.
<name>
New name for the server.
nova rescueusage: 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.
nova reset-networkusage: nova reset-network <server>
Reset network of a server.
Positional arguments<server>
Name or ID of server.
nova reset-stateusage: nova reset-state [--active] <server> [<server> ...]
Reset the state of a server.
Positional arguments<server>
Name or ID of server(s).
Optional arguments--active
Request the server be reset to "active" state instead of "error"
state (the default).
nova resizeusage: 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.
nova resize-confirmusage: nova resize-confirm <server>
Confirm a previous resize.
Positional arguments<server>
Name or ID of server.
nova resize-revertusage: nova resize-revert <server>
Revert a previous resize (and return to the previous VM).
Positional arguments<server>
Name or ID of server.
nova restoreusage: nova restore <server>
Restore a soft-deleted server.
Positional arguments<server>
Name or ID of server.
nova resumeusage: nova resume <server>
Resume a server.
Positional arguments<server>
Name or ID of server.
nova scrubusage: nova scrub <project_id>
Delete networks and security groups associated with a project.
Positional arguments<project_id>
The ID of the project.
nova secgroup-add-default-ruleusage: nova secgroup-add-default-rule <ip-proto> <from-port> <to-port> <cidr>
Add a rule to the set of rules that will be added to the 'default' security
group for new tenants (nova-network only).
Positional arguments<ip-proto>
IP protocol (icmp, tcp, udp).
<from-port>
Port at start of range.
<to-port>
Port at end of range.
<cidr>
CIDR for address range.
nova secgroup-add-group-ruleusage: nova secgroup-add-group-rule <secgroup> <source-group> <ip-proto>
<from-port> <to-port>
Add a source group rule to a security group.
Positional arguments<secgroup>
ID or name of security group.
<source-group>
ID or name of source group.
<ip-proto>
IP protocol (icmp, tcp, udp).
<from-port>
Port at start of range.
<to-port>
Port at end of range.
nova secgroup-add-ruleusage: nova secgroup-add-rule <secgroup> <ip-proto> <from-port> <to-port>
<cidr>
Add a rule to a security group.
Positional arguments<secgroup>
ID or name of security group.
<ip-proto>
IP protocol (icmp, tcp, udp).
<from-port>
Port at start of range.
<to-port>
Port at end of range.
<cidr>
CIDR for address range.
nova secgroup-createusage: nova secgroup-create <name> <description>
Create a security group.
Positional arguments<name>
Name of security group.
<description>
Description of security group.
nova secgroup-deleteusage: nova secgroup-delete <secgroup>
Delete a security group.
Positional arguments<secgroup>
ID or name of security group.
nova secgroup-delete-default-ruleusage: nova secgroup-delete-default-rule <ip-proto> <from-port> <to-port>
<cidr>
Delete a rule from the set of rules that will be added to the 'default'
security group for new tenants (nova-network only).
Positional arguments<ip-proto>
IP protocol (icmp, tcp, udp).
<from-port>
Port at start of range.
<to-port>
Port at end of range.
<cidr>
CIDR for address range.
nova secgroup-delete-group-ruleusage: nova secgroup-delete-group-rule <secgroup> <source-group> <ip-proto>
<from-port> <to-port>
Delete a source group rule from a security group.
Positional arguments<secgroup>
ID or name of security group.
<source-group>
ID or name of source group.
<ip-proto>
IP protocol (icmp, tcp, udp).
<from-port>
Port at start of range.
<to-port>
Port at end of range.
nova secgroup-delete-ruleusage: nova secgroup-delete-rule <secgroup> <ip-proto> <from-port> <to-port>
<cidr>
Delete a rule from a security group.
Positional arguments<secgroup>
ID or name of security group.
<ip-proto>
IP protocol (icmp, tcp, udp).
<from-port>
Port at start of range.
<to-port>
Port at end of range.
<cidr>
CIDR for address range.
nova secgroup-listusage: nova secgroup-list [--all-tenants [<0|1>]]
List security groups for the current tenant.
Optional arguments--all-tenants [<0|1>]
Display information from all tenants (Admin only).
nova secgroup-list-default-rulesusage: nova secgroup-list-default-rules
List rules that will be added to the 'default' security group for new tenants.
nova secgroup-list-rulesusage: nova secgroup-list-rules <secgroup>
List rules for a security group.
Positional arguments<secgroup>
ID or name of security group.
nova secgroup-updateusage: nova secgroup-update <secgroup> <name> <description>
Update a security group.
Positional arguments<secgroup>
ID or name of security group.
<name>
Name of security group.
<description>
Description of security group.
nova server-group-createusage: 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. ("affinity" or "anti-affinity")
nova server-group-deleteusage: nova server-group-delete <id> [<id> ...]
Delete specific server group(s).
Positional arguments<id>
Unique ID(s) of the server group to delete.
nova server-group-getusage: nova server-group-get <id>
Get a specific server group.
Positional arguments<id>
Unique ID of the server group to get.
nova server-group-listusage: nova server-group-list [--all-projects]
Print a list of all server groups.
Optional arguments--all-projects
Display server groups from all projects (Admin only).
nova service-deleteusage: nova service-delete <id>
Delete the service.
Positional arguments<id>
ID of service.
nova service-disableusage: 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.
nova service-enableusage: nova service-enable <hostname> <binary>
Enable the service.
Positional arguments<hostname>
Name of host.
<binary>
Service binary.
nova service-force-downusage: nova service-force-down [--unset] <hostname> <binary>
Force service to down. (Supported by API versions '2.11' - '2.latest')
Positional arguments<hostname>
Name of host.
<binary>
Service binary.
Optional arguments--unset
Unset the force state down of service.
nova service-listusage: 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.
nova set-passwordusage: nova set-password <server>
Change the admin password for a server.
Positional arguments<server>
Name or ID of server.
nova shelveusage: nova shelve <server>
Shelve a server.
Positional arguments<server>
Name or ID of server.
nova shelve-offloadusage: nova shelve-offload <server>
Remove a shelved server from the compute node.
Positional arguments<server>
Name or ID of server.
nova showusage: nova show [--minimal] <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.
nova sshusage: 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.
nova startusage: nova start <server> [<server> ...]
Start the server(s).
Positional arguments<server>
Name or ID of server(s).
nova stopusage: nova stop <server> [<server> ...]
Stop the server(s).
Positional arguments<server>
Name or ID of server(s).
nova suspendusage: nova suspend <server>
Suspend a server.
Positional arguments<server>
Name or ID of server.
nova tenant-network-createusage: nova tenant-network-create <network_label> <cidr>
Create a tenant network.
Positional arguments<network_label>
Network label (ex. my_new_network)
<cidr>
IP block to allocate from (ex. 172.16.0.0/24 or
2001:DB8::/64)
nova tenant-network-deleteusage: nova tenant-network-delete <network_id>
Delete a tenant network.
Positional arguments<network_id>
ID of network
nova tenant-network-listusage: nova tenant-network-list
List tenant networks.
nova tenant-network-showusage: nova tenant-network-show <network_id>
Show a tenant network.
Positional arguments<network_id>
ID of network
nova unlockusage: nova unlock <server>
Unlock a server.
Positional arguments<server>
Name or ID of server.
nova unpauseusage: nova unpause <server>
Unpause a server.
Positional arguments<server>
Name or ID of server.
nova unrescueusage: nova unrescue <server>
Restart the server from normal boot disk again.
Positional arguments<server>
Name or ID of server.
nova unshelveusage: nova unshelve <server>
Unshelve a server.
Positional arguments<server>
Name or ID of server.
nova usageusage: 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.
nova usage-listusage: 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)
nova version-listusage: nova version-list
List all API versions.
nova volume-attachusage: 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)
nova volume-detachusage: 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.
nova volume-updateusage: 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.
nova x509-create-certusage: 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]
nova x509-get-root-certusage: nova x509-get-root-cert [<filename>]
Fetch the x509 root cert.
Positional arguments<filename>
Filename to write the x509 root cert.