Oracle Cloud Infrastructure Documentation

Creating an Instance Pool

Instance pools give you the ability to provision and create multiple Compute instances based off of the same configuration, within the same region. See Managing Compute Instances for more information.

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.


There are some values for instance configuration settings that are incompatible with instance pools. If you try to create an instance pool with one or more of these settings, an error will occur. See Error occurs when creating or updating an instance pool with a valid instance configuration for more information.

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 instance configurations and instance pools.


Before you can create an instance pool, you need:

  • An instance configuration. The instance configuration must be in the same compartment where you want to create the instance pool. For more information, see Creating an Instance Configuration.
  • If you want to associate the instance pool with a load balancer, you need a load balancer and backend set. For steps to create a load balancer, see Managing a Load Balancer.

Using the Console

You can create an instance pool from the Instance Configuration Details page or from the Instance Pools page.

To create an instance pool from the Instance Configuration Details page
To create an instance pool from the Instance Pools page

Using the API

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.

Use these API operations to create and manage instance pools: