Compute command-line client¶

nova usage¶

usage: nova [--version] [--debug] [--os-cache] [--timings]
            [--os-region-name <region-name>] [--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-type <name>]
            [--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-default-domain-id OS_DEFAULT_DOMAIN_ID]
            [--os-default-domain-name OS_DEFAULT_DOMAIN_NAME]
            [--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> ...

Subcommands:

absolute-limits

DEPRECATED, use limits instead.

add-fixed-ip

Add new IP address on a network to server.

add-floating-ip

DEPRECATED, 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

DEPRECATED, use aggregate-show instead.

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.

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-mks-console

Get a serial 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.

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. (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-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.

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-limits

DEPRECATED, 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-ip

DEPRECATED, use floating-ip-disassociate instead.

remove-secgroup

Remove a Security Group from a server.

rename

DEPRECATED, use update instead.

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-password

DEPRECATED, 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.

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]

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-create

DEPRECATED: Add a new volume.

volume-delete

DEPRECATED: Remove volume(s).

volume-detach

Detach a volume from a server.

volume-list

DEPRECATED: List all the volumes.

volume-show

DEPRECATED: Show details about a volume.

volume-snapshot-create

DEPRECATED: Add a new snapshot.

volume-snapshot-delete

DEPRECATED: Remove a snapshot.

volume-snapshot-list

DEPRECATED: List all the snapshots.

volume-snapshot-show

DEPRECATED: Show details about a snapshot.

volume-type-create

DEPRECATED: Create a new volume type.

volume-type-delete

DEPRECATED: Delete a specific volume type.

volume-type-list

DEPRECATED: 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-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.

migration-list

Print a list of migrations.

instance-action

Show an action.

instance-action-list

List actions on a server.

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

Create a tenant network.

tenant-network-delete

Delete a tenant network.

tenant-network-list

List tenant networks.

tenant-network-show

Show a tenant network.

host-servers-migrate

Cold migrate all instances off the specified host to other available hosts.

host-evacuate

Evacuate all instances from failed host.

host-meta

Set or Delete metadata on all instances of a host.

list-extensions

List all the os-api extensions that are available.

force-delete

Force delete a server.

restore

Restore a soft-deleted 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.

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-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].

--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].

--os-auth-type <name>, --os-auth-plugin <name>

Authentication type to use

nova add-fixed-ip¶

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.

nova add-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.

nova agent-create¶

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.

nova agent-delete¶

usage: nova agent-delete <id>

Delete existing agent build.

Positional arguments:

<id>

ID of the agent-build.

nova agent-list¶

usage: nova agent-list [--hypervisor <hypervisor>]

List all builds.

Optional arguments:

--hypervisor <hypervisor>

Type of hypervisor.

nova agent-modify¶

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.

nova aggregate-add-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.

nova aggregate-create¶

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).

nova aggregate-delete¶

usage: nova aggregate-delete <aggregate>

Delete the aggregate.

Positional arguments:

<aggregate>

Name or ID of aggregate to delete.

nova aggregate-list¶

usage: nova aggregate-list

Print a list of all aggregates.

nova aggregate-remove-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.

nova aggregate-set-metadata¶

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.

nova aggregate-show¶

usage: nova aggregate-show <aggregate>

Show details of the specified aggregate.

Positional arguments:

<aggregate>

Name or ID of aggregate.

nova aggregate-update¶

usage: 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-list¶

usage: nova availability-zone-list

List all the availability zones.

nova backup¶

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.

nova baremetal-interface-add¶

usage: 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-list¶

usage: nova baremetal-interface-list <node>

List network interfaces associated with a baremetal node.

Positional arguments:

<node>

ID of node

nova baremetal-interface-remove¶

usage: 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-create¶

usage: 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-delete¶

usage: 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-list¶

usage: nova baremetal-node-list

Print list of available baremetal nodes.

nova baremetal-node-show¶

usage: nova baremetal-node-show <node>

Show information about a baremetal node.

Positional arguments:

<node>

ID of node

nova boot¶

usage: nova boot [--flavor <flavor>] [--image <image>]
                 [--image-with <key=value>] [--boot-volume <volume_id>]
                 [--snapshot <snapshot_id>] [--min-count <number>]
                 [--max-count <number>] [--meta <key=value>]
                 [--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,net-name=network-name,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr,port-id=port-uuid>]
                 [--config-drive <value>] [--poll] [--admin-pass <value>]
                 [--access-ip-v4 <value>] [--access-ip-v6 <value>]
                 [--description <description>]
                 <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; 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).

--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,net-name=network-name,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 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 (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.

--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’)

nova cell-capacities¶

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.

nova cell-show¶

usage: nova cell-show <cell-name>

Show details of a given cell.

Positional arguments:

<cell-name>

Name of the cell.

nova clear-password¶

usage: nova clear-password <server>

Clear the admin password for a server.

Positional arguments:

<server>

Name or ID of server.

nova cloudpipe-configure¶

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.

nova cloudpipe-create¶

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.

nova cloudpipe-list¶

usage: nova cloudpipe-list

Print a list of all cloudpipe instances.

nova console-log¶

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.

nova credentials¶

usage: 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 delete¶

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).

nova diagnostics¶

usage: nova diagnostics <server>

Retrieve server diagnostics.

Positional arguments:

<server>

Name or ID of server.

nova dns-create¶

usage: 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-domain¶

usage: 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-domain¶

usage: 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-delete¶

usage: nova dns-delete <domain> <name>

Delete the specified DNS entry.

Positional arguments:

<domain>

DNS domain.

<name>

DNS name.

nova dns-delete-domain¶

usage: nova dns-delete-domain <domain>

Delete the specified DNS domain.

Positional arguments:

<domain>

DNS domain.

nova dns-domains¶

usage: nova dns-domains

Print a list of available dns domains.

nova dns-list¶

usage: 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 endpoints¶

usage: nova endpoints

Discover endpoints that get returned from the authenticate services.

nova evacuate¶

usage: nova evacuate [--password <password>] <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.

nova fixed-ip-get¶

usage: nova fixed-ip-get <fixed_ip>

Retrieve info on a fixed IP.

Positional arguments:

<fixed_ip>

Fixed IP Address.

nova fixed-ip-reserve¶

usage: nova fixed-ip-reserve <fixed_ip>

Reserve a fixed IP.

Positional arguments:

<fixed_ip>

Fixed IP Address.

nova fixed-ip-unreserve¶

usage: nova fixed-ip-unreserve <fixed_ip>

Unreserve a fixed IP.

Positional arguments:

<fixed_ip>

Fixed IP Address.

nova flavor-access-add¶

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.

nova flavor-access-list¶

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.

nova flavor-access-remove¶

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.

nova flavor-create¶

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).

nova flavor-delete¶

usage: nova flavor-delete <flavor>

Delete a specific flavor

Positional arguments:

<flavor>

Name or ID of the flavor to delete.

nova flavor-key¶

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).

nova flavor-list¶

usage: nova flavor-list [--extra-specs] [--all] [--marker <marker>]
                        [--limit <limit>]

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”.

--limit <limit>

Maximum number of flavors to display. If limit == -1, all flavors will be displayed. If limit is bigger than ‘osapi_max_limit’ option of Nova API, limit ‘osapi_max_limit’ will be used instead.

nova flavor-show¶

usage: nova flavor-show <flavor>

Show details about the given flavor.

Positional arguments:

<flavor>

Name or ID of flavor.

nova floating-ip-associate¶

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.

nova floating-ip-bulk-create¶

usage: 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-delete¶

usage: 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-list¶

usage: nova floating-ip-bulk-list [--host <host>]

List all floating IPs (nova-network only).

Optional arguments:

--host <host>

Filter by host.

nova floating-ip-create¶

usage: 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-delete¶

usage: nova floating-ip-delete <address>

De-allocate a floating IP.

Positional arguments:

<address>

IP of Floating IP.

nova floating-ip-disassociate¶

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.

nova floating-ip-list¶

usage: nova floating-ip-list

List floating IPs.

nova floating-ip-pool-list¶

usage: nova floating-ip-pool-list

List all floating IP pools.

nova force-delete¶

usage: nova force-delete <server>

Force delete a server.

Positional arguments:

<server>

Name or ID of server.

nova get-mks-console¶

usage: nova get-mks-console <server>

Get a serial 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.

nova get-password¶

usage: 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-console¶

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”).

nova get-serial-console¶

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”.

nova get-spice-console¶

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”).

nova get-vnc-console¶

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”).

nova host-action¶

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.

nova host-describe¶

usage: nova host-describe <hostname>

Describe a specific host.

Positional arguments:

<hostname>

Name of host.

nova host-evacuate¶

usage: 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-live¶

usage: nova host-evacuate-live [--target-host <target_host>] [--block-migrate]
                               [--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. (Default=auto) (Supported by API versions ‘2.25’ - ‘2.latest’)

--max-servers <max_servers>

Maximum number of servers to live migrate simultaneously

nova host-list¶

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>.

nova host-meta¶

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)

nova host-servers-migrate¶

usage: nova host-servers-migrate <host>

Cold migrate all instances off the specified host to other available hosts.

Positional arguments:

<host>

Name of host.

nova host-update¶

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.

nova hypervisor-list¶

usage: nova hypervisor-list [--matching <hostname>]

List hypervisors.

Optional arguments:

--matching <hostname>

List hypervisors matching the given <hostname>.

nova hypervisor-servers¶

usage: nova hypervisor-servers <hostname>

List servers belonging to specific hypervisors.

Positional arguments:

<hostname>

The hypervisor hostname (or pattern) to search for.

nova hypervisor-show¶

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

nova hypervisor-stats¶

usage: nova hypervisor-stats

Get hypervisor statistics over all compute nodes.

nova hypervisor-uptime¶

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.

nova image-create¶

usage: nova image-create [--metadata <key=value>] [--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:

--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.

nova image-delete¶

usage: nova image-delete <image> [<image> ...]

Delete specified image(s).

Positional arguments:

<image>

Name or ID of image(s).

nova image-list¶

usage: 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-meta¶

usage: 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-show¶

usage: nova image-show <image>

Show details about the given image.

Positional arguments:

<image>

Name or ID of image.

nova instance-action¶

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.

nova instance-action-list¶

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’)

nova interface-attach¶

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.

nova interface-detach¶

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.

nova interface-list¶

usage: nova interface-list <server>

List interfaces attached to a server.

Positional arguments:

<server>

Name or ID of server.

nova keypair-add¶

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’)

nova keypair-delete¶

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).

nova keypair-list¶

usage: nova keypair-list [--user <user-id>]

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).

nova keypair-show¶

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).

nova limits¶

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.

nova list¶

usage: 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>] [--changes-since <changes_since>]

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.

--changes-since <changes_since>

List only servers changed after a certain point of time.The provided time should be an ISO 8061 formated time.ex 2016-03-04T06:27:59Z .

nova list-extensions¶

usage: nova list-extensions

List all the os-api extensions that are available.

nova list-secgroup¶

usage: nova list-secgroup <server>

List Security Group(s) of a server.

Positional arguments:

<server>

Name or ID of server.

nova live-migration¶

usage: nova live-migration [--block-migrate] <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’)

nova live-migration-abort¶

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.

nova live-migration-force-complete¶

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.

nova lock¶

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.

nova meta¶

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).

nova migrate¶

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.

nova migration-list¶

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.

nova network-associate-host¶

usage: nova network-associate-host <network> <host>

Associate host with network.

Positional arguments:

<network>

UUID of network.

<host>

Name of host

nova network-associate-project¶

usage: nova network-associate-project <network>

Associate project with network.

Positional arguments:

<network>

UUID of network.

nova network-create¶

usage: 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-delete¶

usage: nova network-delete <network>

Delete network by label or id.

Positional arguments:

<network>

UUID or label of network.

nova network-disassociate¶

usage: 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-list¶

usage: 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-show¶

usage: nova network-show <network>

Show details about the given network.

Positional arguments:

<network>

UUID or label of network.

nova pause¶

usage: nova pause <server>

Pause a server.

Positional arguments:

<server>

Name or ID of server.

nova quota-class-show¶

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.

nova quota-class-update¶

usage: 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-defaults¶

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.

nova quota-delete¶

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.

nova quota-show¶

usage: 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-update¶

usage: 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 reboot¶

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).

--poll

Poll until reboot is complete.

nova rebuild¶

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.

nova refresh-network¶

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).

nova remove-fixed-ip¶

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.

nova remove-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.

nova rescue¶

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.

nova reset-network¶

usage: nova reset-network <server>

Reset network of a server.

Positional arguments:

<server>

Name or ID of server.

nova reset-state¶

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).

nova resize¶

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.

nova resize-confirm¶

usage: nova resize-confirm <server>

Confirm a previous resize.

Positional arguments:

<server>

Name or ID of server.

nova resize-revert¶

usage: nova resize-revert <server>

Revert a previous resize (and return to the previous VM).

Positional arguments:

<server>

Name or ID of server.

nova restore¶

usage: nova restore <server>

Restore a soft-deleted server.

Positional arguments:

<server>

Name or ID of server.

nova resume¶

usage: nova resume <server>

Resume a server.

Positional arguments:

<server>

Name or ID of server.

nova scrub¶

usage: 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-rule¶

usage: 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-rule¶

usage: 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-rule¶

usage: 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-create¶

usage: nova secgroup-create <name> <description>

Create a security group.

Positional arguments:

<name>

Name of security group.

<description>

Description of security group.

nova secgroup-delete¶

usage: nova secgroup-delete <secgroup>

Delete a security group.

Positional arguments:

<secgroup>

ID or name of security group.

nova secgroup-delete-default-rule¶

usage: 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-rule¶

usage: 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-rule¶

usage: 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-list¶

usage: 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-rules¶

usage: nova secgroup-list-default-rules

List rules that will be added to the ‘default’ security group for new tenants.

nova secgroup-list-rules¶

usage: nova secgroup-list-rules <secgroup>

List rules for a security group.

Positional arguments:

<secgroup>

ID or name of security group.

nova secgroup-update¶

usage: 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-create¶

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.

nova server-group-delete¶

usage: 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-get¶

usage: nova server-group-get <id>

Get a specific server group.

Positional arguments:

<id>

Unique ID of the server group to get.

nova server-group-list¶

usage: 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 server-migration-list¶

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.

nova server-migration-show¶

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.

nova service-delete¶

usage: nova service-delete <id>

Delete the service.

Positional arguments:

<id>

ID of service.

nova service-disable¶

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.

nova service-enable¶

usage: nova service-enable <hostname> <binary>

Enable the service.

Positional arguments:

<hostname>

Name of host.

<binary>

Service binary.

nova service-force-down¶

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.

nova service-list¶

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.

nova set-password¶

usage: nova set-password <server>

Change the admin password for a server.

Positional arguments:

<server>

Name or ID of server.

nova shelve¶

usage: nova shelve <server>

Shelve a server.

Positional arguments:

<server>

Name or ID of server.

nova shelve-offload¶

usage: nova shelve-offload <server>

Remove a shelved server from the compute node.

Positional arguments:

<server>

Name or ID of server.

nova show¶

usage: 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 ssh¶

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.

nova start¶

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).

nova stop¶

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).

nova suspend¶

usage: nova suspend <server>

Suspend a server.

Positional arguments:

<server>

Name or ID of server.

nova tenant-network-create¶

usage: 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-delete¶

usage: nova tenant-network-delete <network_id>

Delete a tenant network.

Positional arguments:

<network_id>

ID of network

nova tenant-network-list¶

usage: nova tenant-network-list

List tenant networks.

nova tenant-network-show¶

usage: nova tenant-network-show <network_id>

Show a tenant network.

Positional arguments:

<network_id>

ID of network

nova trigger-crash-dump¶

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.

nova unlock¶

usage: nova unlock <server>

Unlock a server.

Positional arguments:

<server>

Name or ID of server.

nova unpause¶

usage: nova unpause <server>

Unpause a server.

Positional arguments:

<server>

Name or ID of server.

nova unrescue¶

usage: nova unrescue <server>

Restart the server from normal boot disk again.

Positional arguments:

<server>

Name or ID of server.

nova unshelve¶

usage: nova unshelve <server>

Unshelve a server.

Positional arguments:

<server>

Name or ID of server.

nova update¶

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’)

nova usage¶

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.

nova usage-list¶

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)

nova version-list¶

usage: nova version-list

List all API versions.

nova virtual-interface-list¶

usage: nova virtual-interface-list <server>

Show virtual interface info about the given server.

Positional arguments:

<server>

ID of server.

nova volume-attach¶

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.

nova volume-attachments¶

usage: nova volume-attachments <server>

List all the volumes attached to a server.

Positional arguments:

<server>

Name or ID of server.

nova volume-detach¶

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.

nova volume-update¶

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.

nova x509-create-cert¶

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]

nova x509-get-root-cert¶

usage: nova x509-get-root-cert [<filename>]

Fetch the x509 root cert.

Positional arguments:

<filename>

Filename to write the x509 root cert.