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.
- Navigate to the Compute Cluster Networks list page. If you need help finding the list page, see Listing Cluster Networks.
- Select a cluster network.
Navigate to attached instances using the option you see:
- Scroll down to Attached instances.
- Under Resources, select Attached instances.
- For the instance that you want to detach, from the actions menu (3 dots) select Detach instance.
- Permanently terminate (delete) this instance and its attached boot volume: To permanently delete the instance and its boot volume, select the checkbox.
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 checkbox to replace the detached instance with a new one.
- Permanently terminate (delete) this instance and its attached boot volume: To permanently delete the instance and its boot volume, select the checkbox.
- 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 detachcommand 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: