Package com.databricks.sdk.service.compute

Class InstancePoolsAPI

java.lang.Object

com.databricks.sdk.service.compute.InstancePoolsAPI

@Generated
public class InstancePoolsAPI
extends Object

Instance Pools API are used to create, edit, delete and list instance pools by using ready-to-use cloud instances which reduces a cluster start and auto-scaling times.

Databricks pools reduce cluster start and auto-scaling times by maintaining a set of idle, ready-to-use instances. When a cluster is attached to a pool, cluster nodes are created using the pool’s idle instances. If the pool has no idle instances, the pool expands by allocating a new instance from the instance provider in order to accommodate the cluster’s request. When a cluster releases an instance, it returns to the pool and is free for another cluster to use. Only clusters attached to a pool can use that pool’s idle instances.

You can specify a different pool for the driver node and worker nodes, or use the same pool for both.

Databricks does not charge DBUs while instances are idle in the pool. Instance provider billing does apply. See pricing.

Constructor Summary

Constructors

Constructor	Description
InstancePoolsAPI(ApiClient apiClient)	Regular-use constructor
InstancePoolsAPI(InstancePoolsService mock)	Constructor for mocks

Method Summary

Modifier and Type	Method	Description
CreateInstancePoolResponse	create(CreateInstancePool request)	Create a new instance pool.
CreateInstancePoolResponse	create(String instancePoolName, String nodeTypeId)
void	delete(DeleteInstancePool request)	Delete an instance pool.
void	delete(String instancePoolId)
void	edit(EditInstancePool request)	Edit an existing instance pool.
void	edit(String instancePoolId, String instancePoolName, String nodeTypeId)
GetInstancePool	get(GetInstancePoolRequest request)	Get instance pool information.
GetInstancePool	get(String instancePoolId)
InstancePoolsService	impl()
Iterable<InstancePoolAndStats>	list()	List instance pool info.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

InstancePoolsAPI

public InstancePoolsAPI(ApiClient apiClient)

Regular-use constructor

InstancePoolsAPI

public InstancePoolsAPI(InstancePoolsService mock)

Constructor for mocks

Method Detail

create

public CreateInstancePoolResponse create(String instancePoolName,
                                         String nodeTypeId)

create

public CreateInstancePoolResponse create(CreateInstancePool request)

Create a new instance pool.

Creates a new instance pool using idle and ready-to-use cloud instances.

delete

public void delete(String instancePoolId)

delete

public void delete(DeleteInstancePool request)

Delete an instance pool.

Deletes the instance pool permanently. The idle instances in the pool are terminated asynchronously.

edit

public void edit(String instancePoolId,
                 String instancePoolName,
                 String nodeTypeId)

edit

public void edit(EditInstancePool request)

Edit an existing instance pool.

Modifies the configuration of an existing instance pool.

get

public GetInstancePool get(String instancePoolId)

get

public GetInstancePool get(GetInstancePoolRequest request)

Get instance pool information.

Retrieve the information for an instance pool based on its identifier.

list

public Iterable<InstancePoolAndStats> list()

List instance pool info.

Gets a list of instance pools with their statistics.

impl

public InstancePoolsService impl()