Skip to content

Latest commit

 

History

History
544 lines (367 loc) · 9.84 KB

File metadata and controls

544 lines (367 loc) · 9.84 KB

server

server add security group

Add security group to server

os server add security group
    <server>
    <group>
:option:`<server>`
Server (name or ID)
:option:`<group>`
Security group to add (name or ID)

server add volume

Add volume to server

os server add volume
    [--device <device>]
    <server>
    <volume>
:option:`--device` <device>
Server internal device name for volume
:option:`<server>`
Server (name or ID)
:option:`<volume>`
Volume to add (name or ID)

server create

Create a new server

os server create
    --image <image> | --volume <volume>
    --flavor <flavor>
    [--security-group <security-group-list> [...] ]
    [--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> [...] ]
    [--hint <key=value> [...] ]
    [--config-drive <value>|True ]
    [--min <count>]
    [--max <count>]
    [--wait]
    <server-name>
:option:`--image` <image>
Create server from this image
:option:`--volume` <volume>
Create server from this volume
:option:`--flavor` <flavor>
Create server with this flavor
:option:`--security-group` <security-group-name>
Security group to assign to this server (repeat for multiple groups)
:option:`--key-name` <key-name>
Keypair to inject into this server (optional extension)
:option:`--property` <key=value>
Set a property on this server (repeat for multiple values)
:option:`--file` <dest-filename=source-filename>
File to inject into image before boot (repeat for multiple files)
:option:`--user-data` <user-data>
User data file to serve from the metadata server
:option:`--availability-zone` <zone-name>
Select an availability zone for the server
:option:`--block-device-mapping` <dev-name=mapping>
Map block devices; map is <id>:<type>:<size(GB)>:<delete_on_terminate> (optional extension)
:option:`--nic` <nic-config-string>
Specify NIC configuration (optional extension)
:option:`--hint` <key=value>
Hints for the scheduler (optional extension)
:option:`--config-drive` <config-drive-volume>|True
Use specified volume as the config drive, or 'True' to use an ephemeral drive
:option:`--min` <count>
Minimum number of servers to launch (default=1)
:option:`--max` <count>
Maximum number of servers to launch (default=1)
:option:`--wait`
Wait for build to complete
:option:`<server-name>`
New server name

server delete

Delete server(s)

os server delete
    <server> [<server> ...]
:option:`<server>`
Server to delete (name or ID)

server list

List servers

os server list
    [--reservation-id <reservation-id>]
    [--ip <ip-address-regex>]
    [--ip6 <ip6-address-regex>]
    [--name <name-regex>]
    [--instance-name <instance-name-regex>]
    [--status <status>]
    [--flavor <flavor>]
    [--image <image>]
    [--host <hostname>]
    [--all-projects]
    [--long]
:option:`--reservation-id` <reservation-id>
Only return instances that match the reservation
:option:`--ip` <ip-address-regex>
Regular expression to match IP addresses
:option:`--ip6` <ip-address-regex>
Regular expression to match IPv6 addresses
:option:`--name` <name-regex>
Regular expression to match names
:option:`--instance-name` <server-name-regex>
Regular expression to match instance name (admin only)
:option:`--status` <status>
Search by server status
:option:`--flavor` <flavor>
Search by flavor ID
:option:`--image` <image>
Search by image ID
:option:`--host` <hostname>
Search by hostname
:option:`--all-projects`
Include all projects (admin only)
:option:`--long`
List additional fields in output

server lock

Lock server

os server lock
    <server>
:option:`<server>`
Server (name or ID)

server migrate

Migrate server to different host

os server migrate
    --live <host>
    [--shared-migration | --block-migration]
    [--disk-overcommit | --no-disk-overcommit]
    [--wait]
    <server>
:option:`--live` <hostname>
Target hostname
:option:`--shared-migration`
Perform a shared live migration (default)
:option:`--block-migration`
Perform a block live migration
:option:`--disk-overcommit`
Allow disk over-commit on the destination host
:option:`--no-disk-overcommit`
Do not over-commit disk on the destination host (default)
:option:`--wait`
Wait for resize to complete
:option:`<server>`
Server to migrate (name or ID)

server pause

Pause server

os server pause
    <server>
:option:`<server>`
Server (name or ID)

server reboot

Perform a hard or soft server reboot

os server reboot
    [--hard | --soft]
    [--wait]
    <server>
:option:`--hard`
Perform a hard reboot
:option:`--soft`
Perform a soft reboot
:option:`--wait`
Wait for reboot to complete
:option:`<server>`
Server (name or ID)

server rebuild

Rebuild server

os server rebuild
    --image <image>
    [--password <password>]
    [--wait]
    <server>
:option:`--image` <image>
Recreate server from this image
:option:`--password` <password>
Set the password on the rebuilt instance
:option:`--wait`
Wait for rebuild to complete
:option:`<server>`
Server (name or ID)

server remove security group

Remove security group from server

os server remove security group
    <server>
    <group>
:option:`<server>`
Name or ID of server to use
:option:`<group>`
Name or ID of security group to remove from server

server remove volume

Remove volume from server

os server remove volume
    <server>
    <volume>
:option:`<server>`
Server (name or ID)
:option:`<volume>`
Volume to remove (name or ID)

server rescue

Put server in rescue mode

os server rescue
    <server>
:option:`<server>`
Server (name or ID)

server resize

Scale server to a new flavor

os server resize
    --flavor <flavor>
    [--wait]
    <server>

os server resize
    --verify | --revert
    <server>
:option:`--flavor` <flavor>
Resize server to specified flavor
:option:`--verify`
Verify server resize is complete
:option:`--revert`
Restore server state before resize
:option:`--wait`
Wait for resize to complete
:option:`<server>`
Server (name or ID)

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.

server resume

Resume server

os server resume
    <server>
:option:`<server>`
Server (name or ID)

server set

Set server properties

os server set
    --name <new-name>
    --property <key=value>
    [--property <key=value>] ...
    --root-password
    <server>
:option:`--name` <new-name>
New server name
:option:`--root-password`
Set new root password (interactive only)
:option:`--property` <key=value>
Property to add/change for this server (repeat option to set multiple properties)
:option:`<server>`
Server (name or ID)

server show

Show server details

os server show
    [--diagnostics]
    <server>
:option:`--diagnostics`
Display server diagnostics information
:option:`<server>`
Server (name or ID)

server ssh

Ssh to server

os server ssh
    [--login <login-name>]
    [--port <port>]
    [--identity <keyfile>]
    [--option <config-options>]
    [--public | --private | --address-type <address-type>]
    <server>
:option:`--login` <login-name>
Login name (ssh -l option)
:option:`--port` <port>
Destination port (ssh -p option)
:option:`--identity` <keyfile>
Private key file (ssh -i option)
:option:`--option` <config-options>
Options in ssh_config(5) format (ssh -o option)
:option:`--public`
Use public IP address
:option:`--private`
Use private IP address
:option:`--address-type` <address-type>
Use other IP address (public, private, etc)
:option:`<server>`
Server (name or ID)

server suspend

Suspend server

os server suspend
    <server>
:option:`<server>`
Server (name or ID)

server unlock

Unlock server

os server unlock
    <server>
:option:`<server>`
Server (name or ID)

server unpause

Unpause server

os server unpause
    <server>
:option:`<server>`
Server (name or ID)

server unrescue

Restore server from rescue mode

os server unrescue
    <server>
:option:`<server>`
Server (name or ID)

server unset

Unset server properties

os server unset
    --property <key>
    [--property <key>] ...
    <server>
:option:`--property` <key>
Property key to remove from server (repeat to set multiple values)
:option:`<server>`
Server (name or ID)