Oracle Cloud Infrastructure Documentation

Updating an Instance Pool

On Compute Cloud@Customer, when you update an instance pool, you can change the name of the pool, the size of the pool, the instance configuration that's used to create new instances, the fault domains, VCN, and subnet.

To attach or detach an instance, see Attaching an Instance to an Instance Pool and Detaching an Instance from an Instance Pool.

To attach load balancers or detach load balancer attachments, see Managing Instance Pool Load Balancer Attachments.

Configuration changes don't affect existing instances; configuration changes only affect new instances. New instances will be provisioned using the new instance configuration and placement configuration.

If you increase the size of the pool, new instances are provisioned. The new instances are created evenly across the fault domains specified by the instance configuration or the placement configuration.

If you decrease the size of the pool, instances are deleted evenly across the fault domains specified by the instance configuration or the placement configuration. In each fault domain, instances are deleted in creation date order, oldest first.

You can't select which instances to delete when you decrease the size of a pool. If you delete an individual instance that's a member of a pool, as described in Deleting an Instance, a new instance is automatically provisioned to keep the pool at the specified pool size.

If you increase the size of the pool, and some new instances can't be provisioned because of resource constraints, those instances remain in Provisioning state and the pool remains in Scaling state until all instances are provisioned. See the suggested remedies in Creating an Instance Pool.

Avoid entering confidential information in names and tags.

    1. In the Compute Cloud@Customer Console navigation menu, click Compute, then click Instance Pools.

    2. At the top of the page, select the compartment that contains the instance pool that you want to update.

    3. For the instance pool that you want to update, click the Actions menu (An image of the three dot icon.), then click Edit.

    4. In the Update Instance Pool dialog box, make the changes.

    5. Click Update Instance Pool.

  • Use the oci compute-management instance-pool update command and required parameters to update the specified instance pool.

    oci compute-management instance-pool update --instance-pool-id instance_pool_OCID options_with_values_to_update[OPTIONS]

    For a complete list of CLI commands, flags, and options, see the Command Line Reference.

  • Use the UpdateInstancePool operation to update the specified instance pool.

    For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.