openstack-manuals/doc/user-guide/source/cli-delete-an-instance.rst

Delete an instance

When you no longer need an instance, you can delete it.

1. List all instances:

   $ openstack server list
   +-------------+----------------------+--------+------------+-------------+------------------+------------+
   | ID          | Name                 | Status | Task State | Power State | Networks         | Image Name |
   +-------------+----------------------+--------+------------+-------------+------------------+------------+
   | 84c6e57d... | myCirrosServer       | ACTIVE | None       | Running     | private=10.0.0.3 | cirros     |
   | 8a99547e... | myInstanceFromVolume | ACTIVE | None       | Running     | private=10.0.0.4 | ubuntu     |
   | d7efd3e4... | newServer            | ERROR  | None       | NOSTATE     |                  | centos     |
   +-------------+----------------------+--------+------------+-------------+------------------+------------+

2. Run the openstack server delete command to delete the instance. The following example shows deletion of the newServer instance, which is in ERROR state:

   $ openstack server delete newServer

   The command does not notify that your server was deleted.

3. To verify that the server was deleted, run the openstack server list command:

   $ openstack server list
   +-------------+----------------------+--------+------------+-------------+------------------+------------+
   | ID          | Name                 | Status | Task State | Power State | Networks         | Image Name |
   +-------------+----------------------+--------+------------+-------------+------------------+------------+
   | 84c6e57d... | myCirrosServer       | ACTIVE | None       | Running     | private=10.0.0.3 | cirros     |
   | 8a99547e... | myInstanceFromVolume | ACTIVE | None       | Running     | private=10.0.0.4 | ubuntu     |
   +-------------+----------------------+--------+------------+-------------+------------------+------------+

   The deleted instance does not appear in the list.