Oracle Cloud Infrastructure Documentation

Detaching an Instance from an Instance Pool

Detach an instance from an instance pool when you no longer want to manage the instance as part of the pool.

When you detach an instance from a pool, you can choose whether to delete the instance or to retain it. You can also choose whether to replace the detached instance by creating an instance in the pool. If you don't replace the detached instance, then the pool size decreases.

    1. Open the navigation menu and click Compute. Under Compute, click Instance Pools.
    2. In the List scope section, select the compartment that contains the instance pool that you want to update.
    3. Click the name of the instance pool from which you want to detach an instance to display the details page.
    4. In the Resources section, click Attached instances.
    5. For the instance that you want to detach, click the Actions menu (Actions Menu), and click Detach instance to display the Detach instance from instance pool dialog.
    6. To delete the instance and its boot volume, select Permanently terminate (delete) this instance and its attached boot volume.
    7. If you want the pool to remain the same size after you detach the instance, then you can provision a replacement instance. Select Replace the instance with a new instance, using the pool's instance configuration as a template for the instance.
    8. Click Detach (or Detach and terminate, if you're also deleting the instance).
      To track the progress of the operation and troubleshoot errors that occur during instance creation, use the associated work request.

  • Use the instance-pool-instance detach command to detach an instance from an instance pool.

    oci compute-management instance-pool-instance detach --instance-id <INSTANCE_OCID> --instance-pool-id <INSTANCE_POOL_OCID>

    For a complete list of flags and variable options for the Compute Service CLI commands, see the command line reference for Compute.

  • Use the DetachInstancePoolInstance operation to detach an instance from an instance pool.