server

server

Compute v2

server add fixed ip

Add fixed IP address to server

openstack server add fixed ip
    [--fixed-ip-address <ip-address>]
    <server>
    <network>
--fixed-ip-address <ip-address>

Requested fixed IP address

server

Server to receive the fixed IP address (name or ID)

network

Network to allocate the fixed IP address from (name or ID)

This command is provided by the python-openstackclient plugin.

server add floating ip

Add floating IP address to server

openstack server add floating ip
    [--fixed-ip-address <ip-address>]
    <server>
    <ip-address>
--fixed-ip-address <ip-address>

Fixed IP address to associate with this floating IP address. The first server port containing the fixed IP address will be used

server

Server to receive the floating IP address (name or ID)

ip-address

Floating IP address to assign to the first available server port (IP only)

This command is provided by the python-openstackclient plugin.

server add network

Add network to server

openstack server add network <server> <network>
server

Server to add the network to (name or ID)

network

Network to add to the server (name or ID)

This command is provided by the python-openstackclient plugin.

server add port

Add port to server

openstack server add port <server> <port>
server

Server to add the port to (name or ID)

port

Port to add to the server (name or ID)

This command is provided by the python-openstackclient plugin.

server add security group

Add security group to server

openstack server add security group <server> <group>
server

Server (name or ID)

group

Security group to add (name or ID)

This command is provided by the python-openstackclient plugin.

server add volume

Add volume to server

openstack server add volume [--device <device>] <server> <volume>
--device <device>

Server internal device name for volume

server

Server (name or ID)

volume

Volume to add (name or ID)

This command is provided by the python-openstackclient plugin.

server create

Create a new server

openstack server create
    (--image <image> | --image-property <key=value> | --volume <volume>)
    --flavor <flavor>
    [--security-group <security-group>]
    [--key-name <key-name>]
    [--property <key=value>]
    [--file <dest-filename=source-filename>]
    [--user-data <user-data>]
    [--availability-zone <zone-name>]
    [--block-device-mapping <dev-name=mapping>]
    [--nic <net-id=net-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr,port-id=port-uuid,auto,none>]
    [--network <network>]
    [--port <port>]
    [--hint <key=value>]
    [--config-drive <config-drive-volume>|True]
    [--min <count>]
    [--max <count>]
    [--wait]
    <server-name>
--image <image>

Create server boot disk from this image (name or ID)

--image-property <key=value>

Image property to be matched

--volume <volume>

Create server using this volume as the boot disk (name or ID). This option automatically creates a block device mapping with a boot index of 0. On many hypervisors (libvirt/kvm for example) this will be device vda. Do not create a duplicate mapping using –block-device-mapping for this volume.

--flavor <flavor>

Create server with this flavor (name or ID)

--security-group <security-group>

Security group to assign to this server (name or ID) (repeat option to set multiple groups)

--key-name <key-name>

Keypair to inject into this server (optional extension)

--property <key=value>

Set a property on this server (repeat option to set multiple values)

--file <dest-filename=source-filename>

File to inject into image before boot (repeat option to set multiple files)

--user-data <user-data>

User data file to serve from the metadata server

--availability-zone <zone-name>

Select an availability zone for the server

--block-device-mapping <dev-name=mapping>

Create a block device on the server. Block device mapping in the format <dev-name>=<id>:<type>:<size(GB)>:<delete-on-terminate> <dev-name>: block device name, like: vdb, xvdc (required) <id>: UUID of the volume or snapshot (required) <type>: volume or snapshot; default: volume (optional) <size(GB)>: volume size if create from snapshot (optional) <delete-on-terminate>: true or false; default: false (optional) (optional extension)

--nic <net-id=net-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr,port-id=port-uuid,auto,none>

Create a NIC on the server. Specify option multiple times to create multiple NICs. Either net-id or port-id must be provided, but not both. net-id: attach NIC to network with this UUID, port-id: attach NIC to port with this UUID, v4-fixed-ip: IPv4 fixed address for NIC (optional), v6-fixed-ip: IPv6 fixed address for NIC (optional), none: (v2.37+) no network is attached, auto: (v2.37+) the compute service will automatically allocate a network. Specifying a –nic of auto or none cannot be used with any other –nic value.

--network <network>

Create a NIC on the server and connect it to network. Specify option multiple times to create multiple NICs. This is a wrapper for the ‘–nic net-id=<network>’ parameter that provides simple syntax for the standard use case of connecting a new server to a given network. For more advanced use cases, refer to the ‘–nic’ parameter.

--port <port>

Create a NIC on the server and connect it to port. Specify option multiple times to create multiple NICs. This is a wrapper for the ‘–nic port-id=<pord>’ parameter that provides simple syntax for the standard use case of connecting a new server to a given port. For more advanced use cases, refer to the ‘–nic’ parameter.

--hint <key=value>

Hints for the scheduler (optional extension)

--config-drive <config-drive-volume>|True

Use specified volume as the config drive, or ‘True’ to use an ephemeral drive

--min <count>

Minimum number of servers to launch (default=1)

--max <count>

Maximum number of servers to launch (default=1)

--wait

Wait for build to complete

server-name

New server name

This command is provided by the python-openstackclient plugin.

server delete

Delete server(s)

openstack server delete [--wait] <server> [<server> ...]
--wait

Wait for delete to complete

server

Server(s) to delete (name or ID)

This command is provided by the python-openstackclient plugin.

server dump create

Create a dump file in server(s)

Trigger crash dump in server(s) with features like kdump in Linux. It will create a dump file in the server(s) dumping the server(s)’ memory, and also crash the server(s). OSC sees the dump file (server dump) as a kind of resource.

openstack server dump create <server> [<server> ...]
server

Server(s) to create dump file (name or ID)

This command is provided by the python-openstackclient plugin.

server list

List servers

openstack server list
    [--sort-column SORT_COLUMN]
    [--reservation-id <reservation-id>]
    [--ip <ip-address-regex>]
    [--ip6 <ip-address-regex>]
    [--name <name-regex>]
    [--instance-name <server-name>]
    [--status <status>]
    [--flavor <flavor>]
    [--image <image>]
    [--host <hostname>]
    [--all-projects]
    [--project <project>]
    [--project-domain <project-domain>]
    [--user <user>]
    [--user-domain <user-domain>]
    [--long]
    [-n | --name-lookup-one-by-one]
    [--marker <server>]
    [--limit <num-servers>]
    [--deleted]
    [--changes-since <changes-since>]
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--reservation-id <reservation-id>

Only return instances that match the reservation

--ip <ip-address-regex>

Regular expression to match IP addresses

--ip6 <ip-address-regex>

Regular expression to match IPv6 addresses

--name <name-regex>

Regular expression to match names

--instance-name <server-name>

Regular expression to match instance 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 by hostname

--all-projects

Include all projects (admin only)

--project <project>

Search by project (admin only) (name or ID)

--project-domain <project-domain>

Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.

--user <user>

Search by user (admin only) (name or ID)

--user-domain <user-domain>

Domain the user belongs to (name or ID). This can be used in case collisions between user names exist.

--long

List additional fields in output

-n, --no-name-lookup

Skip flavor and image name lookup.Mutually exclusive with “–name-lookup-one-by-one” option.

--name-lookup-one-by-one

When looking up flavor and image names, look them upone by one as needed instead of all together (default). Mutually exclusive with “–no-name-lookup|-n” option.

--marker <server>

The last server of the previous page. Display list of servers after marker. Display all servers if not specified. (name or ID)

--limit <num-servers>

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

--deleted

Only display deleted servers (Admin only).

--changes-since <changes-since>

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

This command is provided by the python-openstackclient plugin.

server lock

Lock server(s). A non-admin user will not be able to execute actions

openstack server lock <server> [<server> ...]
server

Server(s) to lock (name or ID)

This command is provided by the python-openstackclient plugin.

server migrate

Migrate server to different host

openstack server migrate
    [--live <hostname>]
    [--shared-migration | --block-migration]
    [--disk-overcommit | --no-disk-overcommit]
    [--wait]
    <server>
--live <hostname>

Target hostname

--shared-migration

Perform a shared live migration (default)

--block-migration

Perform a block live migration

--disk-overcommit

Allow disk over-commit on the destination host

--no-disk-overcommit

Do not over-commit disk on the destination host (default)

--wait

Wait for migrate to complete

server

Server (name or ID)

This command is provided by the python-openstackclient plugin.

server pause

Pause server(s)

openstack server pause <server> [<server> ...]
server

Server(s) to pause (name or ID)

This command is provided by the python-openstackclient plugin.

server reboot

Perform a hard or soft server reboot

openstack server reboot [--hard | --soft] [--wait] <server>
--hard

Perform a hard reboot

--soft

Perform a soft reboot

--wait

Wait for reboot to complete

server

Server (name or ID)

This command is provided by the python-openstackclient plugin.

server rebuild

Rebuild server

openstack server rebuild
    [--image <image>]
    [--password <password>]
    [--wait]
    <server>
--image <image>

Recreate server from the specified image (name or ID). Defaults to the currently used one.

--password <password>

Set the password on the rebuilt instance

--wait

Wait for rebuild to complete

server

Server (name or ID)

This command is provided by the python-openstackclient plugin.

server remove fixed ip

Remove fixed IP address from server

openstack server remove fixed ip <server> <ip-address>
server

Server to remove the fixed IP address from (name or ID)

ip-address

Fixed IP address to remove from the server (IP only)

This command is provided by the python-openstackclient plugin.

server remove floating ip

Remove floating IP address from server

openstack server remove floating ip <server> <ip-address>
server

Server to remove the floating IP address from (name or ID)

ip-address

Floating IP address to remove from server (IP only)

This command is provided by the python-openstackclient plugin.

server remove network

Remove all ports of a network from server

openstack server remove network <server> <network>
server

Server to remove the port from (name or ID)

network

Network to remove from the server (name or ID)

This command is provided by the python-openstackclient plugin.

server remove port

Remove port from server

openstack server remove port <server> <port>
server

Server to remove the port from (name or ID)

port

Port to remove from the server (name or ID)

This command is provided by the python-openstackclient plugin.

server remove security group

Remove security group from server

openstack server remove security group <server> <group>
server

Name or ID of server to use

group

Name or ID of security group to remove from server

This command is provided by the python-openstackclient plugin.

server remove volume

Remove volume from server

openstack server remove volume <server> <volume>
server

Server (name or ID)

volume

Volume to remove (name or ID)

This command is provided by the python-openstackclient plugin.

server rescue

Put server in rescue mode

openstack server rescue
    [--image <image>]
    [--password <password>]
    <server>
--image <image>

Image (name or ID) to use for the rescue mode. Defaults to the currently used one.

--password <password>

Set the password on the rescued instance

server

Server (name or ID)

This command is provided by the python-openstackclient plugin.

server resize

Scale server to a new flavor.

A resize operation is implemented by creating a new server and copying the contents of the original disk into a new one. It is also a two-step process for the user: the first is to perform the resize, the second is to either confirm (verify) success and release the old server, or to declare a revert to release the new server and restart the old one.

openstack server resize
    [--flavor <flavor> | --confirm | --revert]
    [--wait]
    <server>
--flavor <flavor>

Resize server to specified flavor

--confirm

Confirm server resize is complete

--revert

Restore server state before resize

--wait

Wait for resize to complete

server

Server (name or ID)

This command is provided by the python-openstackclient plugin.

server restore

Restore server(s)

openstack server restore <server> [<server> ...]
server

Server(s) to restore (name or ID)

This command is provided by the python-openstackclient plugin.

server resume

Resume server(s)

openstack server resume <server> [<server> ...]
server

Server(s) to resume (name or ID)

This command is provided by the python-openstackclient plugin.

server set

Set server properties

openstack server set
    [--name <new-name>]
    [--root-password]
    [--property <key=value>]
    [--state <state>]
    <server>
--name <new-name>

New server name

--root-password

Set new root password (interactive only)

--property <key=value>

Property to add/change for this server (repeat option to set multiple properties)

--state <state>

New server state (valid value: active, error)

server

Server (name or ID)

This command is provided by the python-openstackclient plugin.

server shelve

Shelve server(s)

openstack server shelve <server> [<server> ...]
server

Server(s) to shelve (name or ID)

This command is provided by the python-openstackclient plugin.

server show

Show server details. Specify --os-compute-api-version 2.47 or higher to see the embedded flavor information for the server.

openstack server show [--diagnostics] <server>
--diagnostics

Display server diagnostics information

server

Server (name or ID)

This command is provided by the python-openstackclient plugin.

server ssh

SSH to server

openstack server ssh
    [--login <login-name>]
    [--port <port>]
    [--identity <keyfile>]
    [--option <config-options>]
    [-4 | -6]
    [--public | --private | --address-type <address-type>]
    <server>
--login <login-name>

Login name (ssh -l option)

--port <port>

Destination port (ssh -p option)

--identity <keyfile>

Private key file (ssh -i option)

--option <config-options>

Options in ssh_config(5) format (ssh -o option)

-4

Use only IPv4 addresses

-6

Use only IPv6 addresses

--public

Use public IP address

--private

Use private IP address

--address-type <address-type>

Use other IP address (public, private, etc)

server

Server (name or ID)

This command is provided by the python-openstackclient plugin.

server start

Start server(s).

openstack server start <server> [<server> ...]
server

Server(s) to start (name or ID)

This command is provided by the python-openstackclient plugin.

server stop

Stop server(s).

openstack server stop <server> [<server> ...]
server

Server(s) to stop (name or ID)

This command is provided by the python-openstackclient plugin.

server suspend

Suspend server(s)

openstack server suspend <server> [<server> ...]
server

Server(s) to suspend (name or ID)

This command is provided by the python-openstackclient plugin.

server unlock

Unlock server(s)

openstack server unlock <server> [<server> ...]
server

Server(s) to unlock (name or ID)

This command is provided by the python-openstackclient plugin.

server unpause

Unpause server(s)

openstack server unpause <server> [<server> ...]
server

Server(s) to unpause (name or ID)

This command is provided by the python-openstackclient plugin.

server unrescue

Restore server from rescue mode

openstack server unrescue <server>
server

Server (name or ID)

This command is provided by the python-openstackclient plugin.

server unset

Unset server properties

openstack server unset [--property <key>] <server>
--property <key>

Property key to remove from server (repeat option to remove multiple values)

server

Server (name or ID)

This command is provided by the python-openstackclient plugin.

server unshelve

Unshelve server(s)

openstack server unshelve <server> [<server> ...]
server

Server(s) to unshelve (name or ID)

This command is provided by the python-openstackclient plugin.

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.