Nova Command

The nova client is the command-line interface (CLI) for the OpenStack Compute API and its extensions.

For help on a specific nova command, enter:

$ nova help COMMAND

Nova Usage

[--timeout <seconds>] [--os-auth-token OS_AUTH_TOKEN]

[--os-username <auth-user-name>] [--os-password <auth-password>]

[--os-tenant-name <auth-tenant-name>]

[--os-tenant-id <auth-tenant-id>] [--os-auth-url <auth-url>]

[--os-region-name <region-name>] [--os-auth-system <auth-system>]

[--service-type <service-type>] [--service-name <service-name>]

[--volume-service-name <volume-service-name>]

[--endpoint-type <endpoint-type>]

[--os-compute-api-version <compute-api-ver>]

[--os-cacert <ca-certificate>] [--insecure]

[--bypass-url <bypass-url>]

<subcommand> ...

Subcommands

Command	Description
absolute-limits	Print a list of absolute limits for a user
add-floating-ip	DEPRECATED, use floating-ip-associate instead.
add-secgroup	Add a Security Group to a server.
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 password for a server.
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).
endpoints	Discover endpoints that get returned from the authenticate services.
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-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 for this tenant.
floating-ip-pool-list	List all floating ip pools.
get-password	Get password for a server.
get-vnc-console	Get a vnc console to a server.
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.
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.
list	List active servers.
list-secgroup	List Security Group(s) of a server.
lock	Lock a server.
meta	Set or Delete metadata on a server.
quota-show	List the quotas for a tenant/user.
rate-limits	Print a list of rate limits for a user
reboot	Reboot a server.
rebuild	Shutdown, re-image, and re-boot a server.
remove-floating-ip	DEPRECATED, use floating-ip-disassociate instead.
remove-secgroup	Remove a Security Group from a server.
rename	Rename a server.
rescue	Rescue a server.
resume	Resume a server.
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-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-rules	List rules for a security group.
secgroup-update	Update a security group.
shelve	Shelve a server.
show	Show details about the given server.
ssh	SSH into a server.
start	Start a server.
stop	Stop a server.
suspend	Suspend a server.
unlock	Unlock a server.
unpause	Unpause a server.
unrescue	Unrescue a server.
unshelve	Unshelve a server.
usage	Show usage data for a single tenant.
volume-attach	Attach a volume to a server.
volume-create	Add a new volume.
volume-delete	Remove volume(s).
volume-detach	Detach a volume from a server.
volume-list	List all the volumes.
volume-show	Show details about a volume.
volume-snapshot-create	Add a new snapshot.
volume-snapshot-delete	Remove a snapshot.
volume-snapshot-list	List all the snapshots.
volume-snapshot-show	Show details about a snapshot.
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.
force-delete	Force delete a server.
restore	Restore a soft-deleted server.
instance-action	Show an action.
instance-action-list	List actions on a server.
list-extensions	List all the os-api extensions that are available.

nova optional arguments

Command	Description
--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
--timeout <seconds>	Set HTTP call timeout (in seconds)
--os-auth-token OS_AUTH_TOKEN	Defaults to env[OS_AUTH_TOKEN]
--os-username <auth-user-name>	Defaults to env[OS_USERNAME].
--os-password <auth-password>	Defaults to env[OS_PASSWORD].
--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-auth-url <auth-url>	Defaults to env[OS_AUTH_URL].
--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]
--endpoint-type <endpoint-type>	Defaults to env[NOVA_ENDPOINT_TYPE] or publicURL.
--os-compute-api-version <compute-api-ver>	Accepts 1.1 or 3, defaults to env[OS_COMPUTE_API_VERSION].
--os-cacert <ca-certificate>	Specify a CA bundle file to use in verifying a TLS (https) server certificate. Defaults to env[OS_CACERT]
--insecure	Explicitly allow novaclient to perform "insecure" SSL (https) requests. The server's certificate will not be verified against any certificate authorities. This option should be used with caution.
--bypass-url <bypass-url>	Use this API endpoint instead of the Service Catalog

nova absolute-limits command

usage: nova absolute-limits [--tenant [ <tenant> ]] [--reserved]

Print a list of absolute limits for a user

Optional arguments

Command	Description
--tenant [<tenant>]	Display information from single tenant (Admin only).
--reserved	Include reservations count.

nova add-secgroup command

usage: nova add-secgroup <server> <secgroup>

Add a Security Group to a server.

Positional arguments

Command	Description
<server>	Name or ID of server.
<secgroup>	Name of Security Group.

nova availability-zone-list command

usage: nova availability-zone-list

List all the availability zones.

nova backup command

usage: nova backup <server> <name> <backup-type> <rotation>

Backup a server by creating a 'backup' type snapshot.

Positional arguments

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

usage: nova boot [--flavor <flavor>] [--image <image>] [--image-with <key=value>] [--boot-volume <volume_id>] [--snapshot <snapshot_id>] [--num-instances <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,port-id=port-uuid>] [--config-drive <value>] [--poll] <name>

Boot a new server.

Positional arguments

Command	Description
<name>	Name for the new server

Optional arguments

Command	Description
--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>	Sapshot ID to boot from (will create a volume).
--num-instances <number>	boot multiple servers at a time (limited by quota).
--meta <key=value>	Record arbitrary key/value metadata to /meta.js on the new 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.
--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=image_id, snapshot_id or volume_id, source=source type (image, snapshot, volume or blank), dest=destination type of the block device (volume or local), bus=device's bus, device=name of the device (e.g. vda, xda, ...), size=size of the block device in GB, format=device will be formatted (e.g. swap, ext3, ntfs, ...), bootindex=integer used for ordering the boot disks, type=device type (e.g. disk, cdrom, ...) and shutdown=shutdown behaviour (either preserve or 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,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 (required if no port-id), v4 -fixed-ip: IPv4 fixed address for NIC (optional), port-id: attach NIC to port with this UUID (required if no net-id)
--config-drive <value>	Enable config drive
--poll	Blocks while server builds so progress can be reported.

nova clear-password command

usage: nova clear-password <server>

Clear password for a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova console-log command

usage: nova console-log [--length <length>] <server>

Get console log output of a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

Optional arguments

Command	Description
--length <length>	Length in lines to tail.

nova credentials command

usage: nova credentials [--wrap <integer>]

Show user credentials returned from auth.

Optional arguments

Command	Description
--wrap <integer>	wrap PKI tokens to a specified length, or 0 to disable

nova delete command

usage: nova delete <server> [<server> ...]

Immediately shut down and delete specified server(s).

Positional arguments

Command	Description
<server>	Name or ID of server(s).

nova endpoints command

usage: nova endpoints

Discover endpoints that get returned from the authenticate services.

nova flavor-list command

usage: nova flavor-list [--extra-specs] [--all]

Print a list of available 'flavors' (sizes of servers).

Optional arguments

Command	Description
--extra-specs	Get extra-specs of each flavor.
--all	Display all flavors (Admin only).

nova flavor-show command

usage: nova flavor-show <flavor>

Show details about the given flavor.

Positional arguments

Command	Description
<flavor>	Name or ID of flavor

nova floating-ip-associate command

usage: nova floating-ip-associate [--fixed-address <fixed_address>] <server> <address>

Associate a floating IP address to a server.

Positional arguments

Command	Description
<server>	Name or ID of server.
<address>	IP Address.

Optional arguments

Command	Description
--fixed-address <fixed_address>	Fixed IP Address to associate with.

nova floating-ip-create command

usage: nova floating-ip-create [<floating-ip-pool>]

Allocate a floating IP for the current tenant.

Positional arguments

Command	Description
<floating-ip-pool>	Name of Floating IP Pool. (Optional)

nova floating-ip-delete command

usage: nova floating-ip-delete <address>

De-allocate a floating IP.

Positional arguments

Command	Description
<address>	IP of Floating Ip.

nova floating-ip-disassociate command

usage: nova floating-ip-disassociate <server> <address>

Disassociate a floating IP address from a server.

Positional arguments

Command	Description
<server>	Name or ID of server.
<address>	IP Address.

nova floating-ip-list command

usage: nova floating-ip-list

List floating ips for this tenant.

nova floating-ip-pool-list command

usage: nova floating-ip-pool-list

List all floating ip pools.

nova force-delete command

usage: nova force-delete <server>

Force delete a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova get-password command

usage: nova get-password <server> [<private-key>]

Get password for a server.

Positional arguments

Command	Description
<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-vnc-console command

usage: nova get-vnc-console <server> <console-type>

Get a vnc console to a server.

Positional arguments

Command	Description
<server>	Name or ID of server.
<console-type>	Type of vnc console ("novnc" or "xvpvnc").

nova image-create command

usage: nova image-create [--show] [--poll] <server> <name>

Create a new image by taking a snapshot of a running server.

Positional arguments

Command	Description
<server>	Name or ID of server.
<name>	Name of snapshot.

Optional arguments

Command	Description
--show	Print image info.
--poll	Blocks while server snapshots so progress can be reported.

nova image-delete command

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

Delete specified image(s).

Positional arguments

Command	Description
<image>	Name or ID of image(s).

nova image-list command

usage: nova image-list [--limit <limit>]

Print a list of available images to boot from.

Optional arguments

Command	Description
--limit <limit>	number of images to return per request

nova image-meta command

usage: nova image-meta <image> <action> <key=value> [<key=value> ...]

Set or Delete metadata on an image.

Positional arguments

Command	Description
<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 command

usage: nova image-show <image>

Show details about the given image.

Positional arguments

Command	Description
<image>	Name or ID of image

nova instance-action command

usage: nova instance-action <server> <request_id>

Show an action.

Positional arguments

Command	Description
<server>	Name or UUID of the server to show an action for.
<request_id>	Request ID of the action to get.

nova instance-action-list command

usage: nova instance-action-list <server>

List actions on a server.

Positional arguments

Command	Description
<server>	Name or UUID of the server to list actions for.

nova keypair-add command

usage: nova keypair-add [--pub-key <pub-key>] <name>

Create a new key pair for use with servers.

Positional arguments

Command	Description
<name>	Name of key.

Optional arguments

Command	Description
--pub-key <pub-key>	Path to a public ssh key.

nova keypair-delete command

usage: nova keypair-delete <name>

Delete keypair given by its name.

Positional arguments

Command	Description
<name>	Keypair name to delete.

nova keypair-list command

usage: nova keypair-list

Print a list of keypairs for a user

nova keypair-show command

usage: nova keypair-show <keypair>

Show details about the given keypair.

Positional arguments

Command	Description
<keypair>	Name or ID of keypair

nova list command

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>]] [--deleted] [--fields <fields>] [--minimal]

List active servers.

Optional arguments

Command	Description
--reservation-id <reservation-id>	Only return servers that match reservation-id.
--ip <ip-regexp>	Search with regular expression match by IP address (Admin only).
--ip6 <ip6-regexp>	Search with regular expression match by IPv6 address (Admin only).
--name <name-regexp>	Search with regular expression match by name
--instance-name <name-regexp>	Search with regular expression match by server name (Admin only).
--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).
--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.

nova list-extensions command

usage: nova list-extensions

List all the os-api extensions that are available.

nova list-secgroup command

usage: nova list-secgroup <server>

List Security Group(s) of a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova lock command

usage: nova lock <server>

Lock a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova meta command

usage: nova meta <server> <action> <key=value> [<key=value> ...]

Set or Delete metadata on a server.

Positional arguments

Command	Description
<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 quota-show command

usage: nova quota-show [--tenant <tenant-id>] [--user <user-id>]

List the quotas for a tenant/user.

Optional arguments

Command	Description
--tenant <tenant-id> ID	of tenant to list the quotas for.
--user <user-id> ID	of user to list the quotas for.

nova rate-limits command

usage: nova rate-limits

Print a list of rate limits for a user

nova reboot command

usage: nova reboot [--hard] [--poll] <server>

Reboot a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

Optional arguments

Command	Description
--hard	Perform a hard reboot (instead of a soft one).
--poll	Blocks while server is rebooting.

nova rebuild command

usage: nova rebuild [--rebuild-password <rebuild-password>] [--poll] [--minimal] [--preserve-ephemeral] <server> <image>

Shutdown, re-image, and re-boot a server.

Positional arguments

Command	Description
<server>	Name or ID of server.
<image>	Name or ID of new image.

Optional arguments

Command	Description
--rebuild-password <rebuild-password>	Set the provided password on the rebuild server.
--poll	Blocks while server rebuilds so progress can be reported.
--minimal	Skips flavor/image lookups when showing servers
--preserve-ephemeral	Preserve the default ephemeral storage partition on rebuild.

nova remove-secgroup command

usage: nova remove-secgroup <server> <secgroup>

Remove a Security Group from a server.

Positional arguments

Command	Description
<server>	Name or ID of server.
<secgroup>	Name of Security Group.

nova rename command

usage: nova rename <server> <name>

Rename a server.

Positional arguments

Command	Description
<server>	Name (old name) or ID of server.
<name>	New name for the server.

nova rescue command

usage: nova rescue <server>

Rescue a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova restore command

usage: nova restore <server>

Restore a soft-deleted server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova resume command

usage: nova resume <server>

Resume a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova secgroup-add-group-rule command

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

Command	Description
<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 command

usage: nova secgroup-add-rule <secgroup> <ip-proto> <from-port> <to-port> <cidr>

Add a rule to a security group.

Positional arguments

Command	Description
<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 command

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

Create a security group.

Positional arguments

Command	Description
<name>	Name of security group.
<description>	Description of security group.

nova secgroup-delete command

usage: nova secgroup-delete <secgroup>

Delete a security group.

Positional arguments

Command	Description
<secgroup>	ID or name of security group.

nova secgroup-delete-group-rule command

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

Command	Description
<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 command

usage: nova secgroup-delete-rule <secgroup> <ip-proto> <from-port> <to-port> <cidr>

Delete a rule from a security group.

Positional arguments

Command	Description
<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 command

usage: nova secgroup-list [--all-tenants [<0|1>]]

List security groups for the current tenant.

Optional arguments

Command	Description
--all-tenants [<0\|1>]	Display information from all tenants (Admin only).

nova secgroup-list-rules command

usage: nova secgroup-list-rules <secgroup>

List rules for a security group.

Positional arguments

Command	Description
<secgroup>	ID or name of security group.

nova secgroup-update command

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

Update a security group.

Positional arguments

Command	Description
<secgroup>	ID or name of security group.
<name>	Name of security group.
<description>	Description of security group.

nova shelve command

usage: nova shelve <server>

Shelve a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova show command

usage: nova show [--minimal] <server>

Show details about the given server.

Positional arguments

Command	Description
<server>	Name or ID of server.

Optional arguments

Command	Description
--minimal	Skips flavor/image lookups when showing servers

nova ssh command

usage: nova ssh [--port PORT] [--private] [--ipv6] [--login <login>] [-i IDENTITY] [--extra-opts EXTRA] <server>

SSH into a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

Optional arguments

Command	Description
--port PORT	Optional flag to indicate which port to use for ssh. (Default=22)
--private	Optional flag to indicate whether to only use private address attached to an instance. (Default=False). If no public address is found try private address
--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 command

usage: nova start <server>

Start a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova stop command

usage: nova stop <server>

Stop a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova suspend command

usage: nova suspend <server>

Suspend a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova unlock command

usage: nova unlock <server>

Unlock a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova unpause command

usage: nova unpause <server>

Unpause a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova unrescue command

usage: nova unrescue <server>

Unrescue a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova unshelve command

usage: nova unshelve <server>

Unshelve a server.

Positional arguments

Command	Description
<server>	Name or ID of server.

nova usage command

usage: nova usage [--start <start>] [--end <end>] [--tenant <tenant-id>]

Show usage data for a single tenant.

Optional arguments

Command	Description
--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	or name of tenant to get usage for.

nova volume-attach command

usage: nova volume-attach <server> <volume> [<device>]

Attach a volume to a server.

Positional arguments

Command	Description
<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-create command

usage: nova volume-create [--snapshot-id <snapshot-id>] [--image-id <image-id>] [--display-name <display-name>] [--display-description <display-description>] [--volume-type <volume-type>] [--availability-zone <availability-zone>] <size>

Add a new volume.

Positional arguments

Command	Description
<size>	Size of volume in GB

Optional arguments

Command	Description
--snapshot-id <snapshot-id>	Optional snapshot id to create the volume from. (Default=None)
--image-id <image-id>	Optional image id to create the volume from. (Default=None)
--display-name <display-name>	Optional volume name. (Default=None)
--display-description <display-description>	Optional volume description. (Default=None)
--volume-type <volume-type>	Optional volume type. (Default=None)
--availability-zone <availability-zone>	Optional Availability Zone for volume. (Default=None)

nova volume-delete command

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

Remove volume(s).

Positional arguments

Command	Description
<volume>	Name or ID of the volume(s) to delete.

nova volume-detach command

usage: nova volume-detach <server> <volume>

Detach a volume from a server.

Positional arguments

Command	Description
<server>	Name or ID of server.
<volume>	Attachment ID of the volume.

nova volume-list command

usage: nova volume-list [--all-tenants [<0|1>]]

List all the volumes.

Optional arguments

Command	Description
--all-tenants [<0\|1>]	Display information from all tenants (Admin only).

nova volume-show command

usage: nova volume-show <volume>

Show details about a volume.

Positional arguments

Command	Description
<volume>	Name or ID of the volume.

nova volume-snapshot-create command

usage: nova volume-snapshot-create [--force <True|False>] [--display-name <display-name>] [--display-description <display-description>] <volume-id>

Add a new snapshot.

Positional arguments

Command	Description
<volume-id>	ID of the volume to snapshot

Optional arguments

Command	Description
--force <True\|False>	Optional flag to indicate whether to snapshot a volume even if its attached to a server. (Default=False)
--display-name <display-name>	Optional snapshot name. (Default=None)
--display-description <display-description>	Optional snapshot description. (Default=None)

nova volume-snapshot-delete command

usage: nova volume-snapshot-delete <snapshot>

Remove a snapshot.

Positional arguments

Command	Description
<snapshot>	Name or ID of the snapshot to delete.

nova volume-snapshot-list command

usage: nova volume-snapshot-list

List all the snapshots.

nova volume-snapshot-show command

usage: nova volume-snapshot-show <snapshot>

Show details about a snapshot.

Positional arguments

Command	Description
<snapshot>	Name or ID of the snapshot.

nova volume-update command

usage: nova volume-update <server> <volume> <volume>

Update volume attachment.

Positional arguments

Command	Description
<server>	Name or ID of server.
<volume>	Attachment ID of the volume.
<volume>	ID of the volume to attach.

nova x509-create-cert command

usage: nova x509-create-cert [<private-key-filename>] [<x509-cert-filename>]

Create x509 cert for a user in tenant.

Positional arguments

Command	Description
<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 command

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

Fetch the x509 root cert.

Positional arguments

Command	Description
<filename>	Filename to write the x509 root cert.