# pool


Manage your team's VM pools (reserved capacity slices)

## Usage

```
pool <subcommand>
```

## Subcommands

### pool new

Create a pool: reserved capacity for your team's VMs

**Usage:**
```
pool new <name> --cpus=N --region=<region> [--max-vms=M]
```

**Options:**
- `--cpus`: number of CPUs reserved for the pool (required)
- `--json`: output in JSON format
- `--max-vms`: maximum number of VMs in the pool (default 100)
- `--region`: region code for the pool (required)

### pool list

List your team's pools

**Usage:**
```
pool list
```

**Aliases:** ls

**Options:**
- `--json`: output in JSON format

### pool delete

Delete a pool (refused while it has VMs; --force detaches them)

**Usage:**
```
pool delete <name> [--force]
```

**Options:**
- `--json`: output in JSON format