Deleting Instance Pools

Permanently delete instance pools that you no longer need.


When you delete an instance pool, the resources that are associated with the pool are permanently deleted. Resources include instances created by the pool, instances that are attached to the pool, and attached boot volumes and block volumes created by the pool. Block volumes attached to instances after they were created are detached but not deleted.

If an autoscaling configuration applies to the instance pool, then the autoscaling configuration is deleted asynchronously after the pool is deleted. You can also manually delete the autoscaling configuration.

Required IAM Policy

To use Oracle Cloud Infrastructure, you must be granted security access in a policy  by an administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don't have permission or are unauthorized, verify with your administrator what type of access you have and which compartment  to work in.

For administrators: For a typical policy that gives access to instance pools and instance configurations, see Let users manage Compute instance configurations, instance pools, and cluster networks.

    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 delete.
    3. Click the instance pool that you want to delete to display the details page.
    4. Click More Actions, and then click Terminate.
    5. Confirm when prompted.

      To track the progress of the operation and troubleshoot errors that might occur when deleting an instance pool, use the associated work request.

  • To delete an instance pool using the CLI, open a command prompt and run the instance-pool terminate command:

    oci compute-management instance-pool terminate 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.

  • 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.

    In the API, use the TerminateInstancePool operation to delete an instance pool.