Shutting Down an Instance

When you shut down an instance, the instance is gracefully shut down and its network configuration, storage volumes, and disk metadata associated with the instance are preserved. Shutting down an instance is necessary for maintenance or for updating the configuration of an instance, such as changing the shape. You can shut down only a running instance.

  1. Log in to the UI and go to the Self Service Portal.
  2. In the Self Service Portal, click the Home tab.
  3. Click the orchestration name in which the instance is running.
    All the instances in the orchestration are displayed with their status.
  4. Select the instance that you want to shut down and click Shutdown.
  5. Click Shutdown to confirm the action.
The selected instance is shut down and its configuration is preserved.

Shutting Down an Instance Using the CLI or API

Use the following command to shut down a running instance:

oracle-compute shutdown instance name

You can also shut down the instance in the error state if it has been in the running state at least once. You can use the force option in the command when the instance is in the unreachable state, the associated virtual machine is not running, and the virtual machine will not recover on its own. You can force the shut down of the instance and then restart it.

oracle-compute shutdown instance name --force

For more information, see CLI Reference for Oracle Compute Cloud Service.

To shut down an instance using the API, use the PUT http://api.oc.example.com/instance/name?action=SHUTDOWN method.

For more information, see REST API Reference for Oracle Compute Cloud Service.