> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vessl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cluster

### create\_cluster

```python theme={null}
vessl.create_cluster(
   param: CreateClusterParam
)
```

Create a VESSL cluster by installing VESSL agent to given Kubernetes
namespace. If you want to override the default organization, then pass
`organization_name` to `param`.

**Args**

* `param` (CreateClusterParam) : Create cluster parameter.

**Example**

```python theme={null}
vessl.install_cluster(
    param=vessl.CreateClusterParam(
        cluster_name="foo",
        ...
    ),
)
```

***

## read\_cluster

```python theme={null}
vessl.read_cluster(
   cluster_name: str, **kwargs
)
```

Read cluster in the default organization. If you want to override the
default organization, then pass `organization_name` as `**kwargs`.

**Args**

* `cluster_name` (str) : Cluster name.

**Example**

```python theme={null}
vessl.read_cluster(
    cluster_name="seoul-cluster",
)
```

***

## list\_clusters

```python theme={null}
vessl.list_clusters(
   **kwargs
)
```

List clusters in the default organization. If you want to override the
default organization, then pass `organization_name` as `**kwargs`.

**Example**

```python theme={null}
vessl.list_clusters()
```

***

## delete\_cluster

```python theme={null}
vessl.delete_cluster(
   cluster_id: int, **kwargs
)
```

Delete custom cluster in the default organization. If you want to
override the default organization, then pass `organization_name` as
`**kwargs`.

**Args**

* `cluster_id` (int) : Cluster ID.

**Example**

```python theme={null}
vessl.delete_cluster(
    cluster_id=1,
)
```

***

## rename\_cluster

```python theme={null}
vessl.rename_cluster(
   cluster_id: int, new_cluster_name: str, **kwargs
)
```

Rename custom cluster in the default organization. If you want to
override the default organization, then pass `organization_name` as
`**kwargs`.

**Args**

* `cluster_id` (int) : Cluster ID.
* `new_cluster_name` (str) : Cluster name to change.

**Example**

```python theme={null}
vessl.rename_cluster(
    cluster_id=1,
    new_cluster_name="seoul-cluster-2",
)
```

***

## list\_cluster\_nodes

```python theme={null}
vessl.list_cluster_nodes(
   cluster_id: int, **kwargs
)
```

List custom cluster nodes in the default organization. If you want to
override the default organization, then pass `organization_name` as
`**kwargs`.

**Args**

* `cluster_id` (int) : Cluster ID.

**Example**

```python theme={null}
vessl.list_cluster_nodes(
    cluster_id=1,
)
```