> For the complete documentation index, see [llms.txt](https://docs.apolo.us/index/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apolo.us/index/apolo-cli/commands/vcluster.md).

# vcluster

Operations with virtual kubernetes clusters

## Usage

```bash
apolo vcluster [OPTIONS] COMMAND [ARGS]...
```

Operations with virtual kubernetes clusters.

**Commands:**

| Usage                                                       | Description                           |
| ----------------------------------------------------------- | ------------------------------------- |
| [*activate-service-account*](#activate-service-account)     | Activate kubernetes service account   |
| [*create-service-account*](#create-service-account)         | Create kubernetes service account     |
| [*delete-service-account*](#delete-service-account)         | Delete kubernetes service account     |
| [*list-service-accounts*](#list-service-accounts)           | List kubernetes service accounts      |
| [*regenerate-service-account*](#regenerate-service-account) | Regenerate kubernetes service account |

### activate-service-account

Activate kubernetes service account

#### Usage

```bash
apolo vcluster activate-service-account [OPTIONS] NAME
```

Activate kubernetes service account

#### Options

| Name                | Description                                                   |
| ------------------- | ------------------------------------------------------------- |
| *--help*            | Show this message and exit.                                   |
| *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). |
| *--org ORG*         | Look on a specified org (the current org by default).         |
| *--project PROJECT* | Look on a specified project (the current project by default). |

### create-service-account

Create kubernetes service account

#### Usage

```bash
apolo vcluster create-service-account [OPTIONS] NAME
```

Create kubernetes service account

#### Options

| Name                | Description                                                               |
| ------------------- | ------------------------------------------------------------------------- |
| *--help*            | Show this message and exit.                                               |
| *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default).             |
| *--org ORG*         | Look on a specified org (the current org by default).                     |
| *--project PROJECT* | Look on a specified project (the current project by default).             |
| *--ttl TTL*         | Expiration time in the format '1y2m3d4h5m6s' (some parts may be missing). |

### delete-service-account

Delete kubernetes service account

#### Usage

```bash
apolo vcluster delete-service-account [OPTIONS] NAME
```

Delete kubernetes service account

#### Options

| Name                | Description                                                   |
| ------------------- | ------------------------------------------------------------- |
| *--help*            | Show this message and exit.                                   |
| *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). |
| *--org ORG*         | Look on a specified org (the current org by default).         |
| *--project PROJECT* | Look on a specified project (the current project by default). |

### list-service-accounts

List kubernetes service accounts

#### Usage

```bash
apolo vcluster list-service-accounts [OPTIONS]
```

List kubernetes service accounts

#### Options

| Name                | Description                                                   |
| ------------------- | ------------------------------------------------------------- |
| *--help*            | Show this message and exit.                                   |
| *--all-users*       | Show accounts for all project users.                          |
| *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). |
| *--long-format*     | Output all info about service accounts.                       |
| *--org ORG*         | Look on a specified org (the current org by default).         |
| *--project PROJECT* | Look on a specified project (the current project by default). |

### regenerate-service-account

Regenerate kubernetes service account

#### Usage

```bash
apolo vcluster regenerate-service-account [OPTIONS] NAME
```

Regenerate kubernetes service account

#### Options

| Name                | Description                                                               |
| ------------------- | ------------------------------------------------------------------------- |
| *--help*            | Show this message and exit.                                               |
| *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default).             |
| *--org ORG*         | Look on a specified org (the current org by default).                     |
| *--project PROJECT* | Look on a specified project (the current project by default).             |
| *--ttl TTL*         | Expiration time in the format '1y2m3d4h5m6s' (some parts may be missing). |
