Oracle Cloud Infrastructure Documentation

Detaching Instances from a Cluster Network with Instance Pools

Remove specific nodes from a cluster network by detaching instances from the cluster network's underlying instance pool. The instances that you detach are no longer managed as part of the cluster network.

To remove instances from the cluster network by deleting instances, you can resize the cluster network.

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

    1. On the Compute Cluster Networks list page, select the cluster network that you want to manage. If you need help finding the list page, see Listing Cluster Networks.

    2. Navigate to attached instances:

      • Under Resources, select Attached instances.
    3. For the instance that you want to detach, select the Actions menu (Actions Menu) and then select Detach instance.
      • Permanently terminate (delete) this instance and its attached boot volume: To permanently delete the instance and its boot volume, select the check box.

        By default, the size of the underlying instance pool is reduced. If you want the cluster network to remain the same size after you detach the instance, then you can provision a replacement instance.

      • Replace the instance with a new instance, using the pool's instance configuration as a template for the instance: Select the check box to replace the detached instance with a new one.
    4. Select Detach (or Detach and terminate, if you're also deleting the instance).
    Tip

    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 and required parameters to detach an instance from the underlying instance pool of a cluster network.

    oci compute-management instance-pool-instance detach --from-json <file://path/to/file.json>

    <file://path/to/file.json> is the path to a JSON file that defines the instance details. For information about how to generate an example of the JSON file, see Advanced JSON Options.

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

  • For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.

    To detach instances from a cluster network's underlying instance pool, use the following API operation: