Oracle Cloud Infrastructure Documentation

Updating an Instance Pool

You can update the number of instances for an instance pool.

Optionally, you can associate a load balancer with an instance pool. If you do this, when you add an instance to the instance pool, the instance is automatically added to the load balancer's A logical entity defined by a list of backend servers, a load balancing policy, and a health check policy.. After the instance reaches a healthy state (the instance is listening on the configured port number), incoming traffic is automatically routed to the new instance. For background information about the Load Balancing service, see Overview of Load Balancing.

To update other settings for an instance pool, use the command line interface (CLI), SDKs, or REST APIs.

You can automatically adjust the number of instances in an instance pool based on performance metrics such as CPU utilization. To do this, you enable autoscaling for the instance pool. For background information and steps, see Autoscaling.

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

Required IAM Policy

To use Oracle Cloud Infrastructure, you must be given the required type of access in a 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. written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which A collection of related resources that can be accessed only by certain groups that have been given permission by an administrator in your organization. you should 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.

Using the Console

To update the instance pool size
To attach a load balancer to an instance pool
To detach a load balancer from an instance pool

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.

To manage the load balancers that are associated with an instance pool, use the AttachLoadBalancer and DetachLoadBalancer operations.

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. For steps, 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. You cannot use the Console to update instance configuration settings.