Oracle Cloud Infrastructure Documentation

Updating an Instance Pool

You can update the number of instances for an instance pool using the Console. The capability to update other settings for an instance pool is only available using the command line interface (CLI), SDKs, or REST APIs.

See Managing Compute Instances for more information about instance pools and instance configurations.

Required IAM Policy

Each service in Oracle Cloud Infrastructure integrates with IAM for authentication and authorization, for all interfaces (the Console, SDK or CLI, and REST API).

An administrator in your organization needs to set up A collection of users who all need a particular type of access to a set of resources or compartment., A collection of related resources that can be accessed only by certain groups that have been given permission by an administrator in your organization., and An IAM document that specifies who has what type of access to your resources. It is used in different ways: to mean an individual statement written in the policy language; to mean a collection of statements in a single, named "policy" document (which has an Oracle Cloud ID (OCID) assigned to it); and to mean the overall body of policies your organization uses to control access to resources. that control which users can access which services, which resources, and the type of access. For example, the policies control who can create new users, create and manage the cloud network, launch instances, create buckets, download objects, etc. For more information, see Getting Started with Policies. For specific details about writing policies for each of the different services, see Policy Reference.

If you’re a regular user (not an administrator) who needs to use the Oracle Cloud Infrastructure resources that your company owns, contact your administrator to set up a user ID for you. The administrator can confirm which compartment or compartments you should be using.

Using the Console

You can only update the instance pool size from the Console

  1. Open the navigation menu. Under Core Infrastructure, go to Compute and click Instance Pools.
  2. In the list of instance pools, find the instance pool you want to update.
  3. Click the highlighted name of the instance pool to display the instance pool details.
  4. Click Edit.

  5. Specify the updated number of instances for the instance pool, and then click Save.

When you update the instance pool size, it will trigger a scaling event. Keep the following in mind:

  • If the instance pool lifecycle state is RUNNING, the instance pool will create new instances or terminate existing instances at that time, to match the new size of the instance pool. Instances are terminated in the order that they were created, first-in, first out.

  • If the instance pool lifecycle state is STOPPED, for an increase in size, new instances will be configured for the instance pool, but won't be launched. For a decrease in size, the instances will be terminated.


If the instance pool has been in the scaling or provisioning state for an extended period of time it may be because the number of instances requested has exceeded your tenancy's service limits for that shape and availability domain. Check your tenancy's service limits for Compute.

Using the API

To update other instance pool configuration settings, use the CLI, SDKs, or REST APIs. For information about using the CLI, see Command Line Interface (CLI). 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.

For instance pool configuration settings, such as the instance configuration, display name, tags, or availability domain selections, use the UpdateInstancePool operation and the UpdateInstancePoolDetails datatype.

To update the configuration used by the instance pool when creating instances you can either:

  • Create a new instance configuration with the desired settings. You can do this using the Console, see Creating an Instance Configuration. To do this using the API, use the CreateInstanceConfiguration operation.

  • Update the existing instance configuration for the instance pool. You can only update the display name and tags of existing instance configurations. For any other updates, create a new instance configuration with the settings you want to use. To update the display name or tags, use the UpdateInstanceConfiguration operation, passing the UpdateInstanceConfigurationDetails datatype. You cannot use the Console to update instance configuration settings.