ListInstancePoolInstances
get
/20160918/instancePools/{instance_pool_id}/instances
List the instances in the specified instance pool.
Request
Supported Media Types
- application/json
Path Parameters
-
instancePoolId(required): string
The OCID of the instance pool.
Query Parameters
-
compartmentId(required): string
Minimum Length:
1
Maximum Length:255
The OCID of the compartment. -
displayName: string
Minimum Length:
1
Maximum Length:255
A filter to return only resources that match the entire display name given. -
limit: integer
Minimum Value:
1
Maximum Value:1000
For list pagination. The maximum number of results per page, or items to return in a paginated List call. 1 is the minimum, 1000 is the maximum.Default Value:100
-
page: string
Minimum Length:
1
Maximum Length:512
For list pagination. The value of the opc-next-page response header from the previous List call.Default Value:oracle.doceng.json.BetterJsonNull@2c07545f
-
sortBy: string
The optional field to sort the results by.Default Value:
NAME
Allowed Values:[ "ID", "NAME", "TIME_CREATED" ]
-
sortOrder: string
The sort order to use, either ascending (ASC) or descending (DESC).Allowed Values:
[ "ASC", "DESC" ]
Response
Supported Media Types
- application/json
200 Response
The list is being retrieved.
Headers
-
opc-next-page: string
For list pagination. When this header appears in the response, additional pages of results remain. Use this value as the page parameter to get the next page of items.
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
Root Schema : schema
Type:
Show Source
array
-
Array of:
object InstanceSummary
Condensed instance data when listing instances in an instance pool.
Nested Schema : InstanceSummary
Type:
object
Condensed instance data when listing instances in an instance pool.
Show Source
-
availabilityDomain(required):
string
Minimum Length:
1
Maximum Length:255
The availability domain the instance is running in. -
compartmentId(required):
string
Minimum Length:
1
Maximum Length:255
The OCID of the compartment that contains the instance. -
displayName:
string
Minimum Length:
1
Maximum Length:255
A user-friendly name. Does not need to be unique, and it is changeable. Avoid entering confidential information. -
faultDomain:
string
Minimum Length:
1
Maximum Length:255
The fault domain the instance is running in. -
id(required):
string
Minimum Length:
1
Maximum Length:255
The OCID of the instance. -
instanceConfigurationId(required):
string
Minimum Length:
1
Maximum Length:255
The OCID of the instance confgiuration used to create the instance. -
loadBalancerBackends:
array loadBalancerBackends
The load balancer backends that are configured for the instance pool instance.
-
region(required):
string
Minimum Length:
1
Maximum Length:255
The region that contains the availability domain the instance is running in. Oracle Private Cloud Appliance has one region, named pca_name.domain (for example: mypca.example.com), and one availability domain, named AD-1. -
shape:
string
Minimum Length:
1
Maximum Length:255
The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance. You can enumerate all available shapes by calling ListShapes. -
state(required):
string
Minimum Length:
1
Maximum Length:255
The current state of the instance pool instance. -
timeCreated(required):
string(date-time)
The date and time the instance pool instance was created, in the format defined by [RFC3339](https://tools.ietf.org/html/rfc3339). Example: 2016-08-25T21:10:29.600Z
Nested Schema : loadBalancerBackends
Type:
array
The load balancer backends that are configured for the instance pool instance.
Show Source
-
Array of:
object InstancePoolInstanceLoadBalancerBackend
Represents the load balancer Backend that is configured for an instance pool instance.
Nested Schema : InstancePoolInstanceLoadBalancerBackend
Type:
object
Represents the load balancer Backend that is configured for an instance pool instance.
Show Source
-
backendHealthStatus(required):
string
Allowed Values:
[ "OK", "WARNING", "CRITICAL", "UNKNOWN" ]
The health of the backend as observed by the load balancer. -
backendName(required):
string
Minimum Length:
1
Maximum Length:255
The name of the backend in the backend set. -
backendSetName(required):
string
Minimum Length:
1
Maximum Length:255
The name of the backend set on the load balancer. -
loadBalancerId(required):
string
Minimum Length:
1
Maximum Length:255
The OCID of the load balancer attached to the instance pool.
400 Response
Bad Request
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing..Example:
UnknownError
-
message(required):
string
A human-readable error string.Example:
error validating payload
401 Response
Unauthorized
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing..Example:
UnknownError
-
message(required):
string
A human-readable error string.Example:
error validating payload
404 Response
Not Found
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing..Example:
UnknownError
-
message(required):
string
A human-readable error string.Example:
error validating payload
500 Response
Internal Server Error
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing..Example:
UnknownError
-
message(required):
string
A human-readable error string.Example:
error validating payload
Default Response
An error has occurred.
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing..Example:
UnknownError
-
message(required):
string
A human-readable error string.Example:
error validating payload