> For the complete documentation index, see [llms.txt](https://docs.acecloud.ai/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acecloud.ai/knowledge-base/cli/compute/flavors.md).

# Flavors

Flavors define the hardware configuration for an instance: CPU cores, RAM, disk space, and optionally GPU resources. Each flavor has associated hourly and monthly pricing.

**Command:** `ace flavor`

***

## Table of Contents

* [List Flavors](#list-flavors)
* [Get Flavor Details](#get-flavor-details)
* [Understanding Flavor Names](#understanding-flavor-names)
* [Pricing](#pricing)

***

## List Flavors

List all available flavors in the current region.

```bash
ace flavor list
```

**Aliases:** `ls`

### Filters

| Flag         | Description                    |
| ------------ | ------------------------------ |
| `--cpu`      | Show only CPU flavors (no GPU) |
| `--gpu`      | Show only GPU flavors          |
| `--category` | Filter by flavor category      |

### Examples

```bash
# List all flavors
ace flavor list

# CPU-only flavors
ace flavor list --cpu

# GPU flavors only
ace flavor list --gpu

# JSON output
ace flavor list -o json
```

### Table Output

For CPU-only results, the table shows:

```
NAME                           VCPUS        RAM   DISK TYPE     PRICE/HR    PRICE/MO
C4i.medium                         4     8.0 GB   20GB Standard      $0.120       $86.40
C4i.large                          8    16.0 GB   20GB Standard      $0.240      $172.80
```

When GPU flavors are present, additional columns are displayed:

```
NAME                           VCPUS        RAM   DISK TYPE           GPUs   PRICE/HR    PRICE/MO
GPU.A100.1x                       12    64.0 GB   20GB GPU            1        $3.500    $2,520.00
GPU.A100.2x                       24   128.0 GB   20GB GPU            2        $7.000    $5,040.00
```

***

## Get Flavor Details

Get detailed information about a specific flavor. Accepts either a flavor name or UUID.

```bash
ace flavor get <flavor-name-or-id>
```

### Examples

```bash
# By name
ace flavor get C4i.medium

# By UUID
ace flavor get abc12345-1234-1234-1234-123456789abc

# JSON output
ace flavor get C4i.medium -o json
```

### Detail Output

```
  Name:                  C4i.medium
  ID:                    abc12345-1234-1234-1234-123456789abc
  Type:                  Standard
  VCPUs:                 4
  RAM:                   8.0 GB
  Disk:                  20 GB
  Price/hr:              $0.120
  Price/mo:              $86.40
  Billing:               Hourly
```

For GPU flavors, additional fields are shown:

```
  Name:                  GPU.A100.1x
  ID:                    def67890-1234-1234-1234-123456789abc
  Type:                  GPU
  VCPUs:                 12
  RAM:                   64.0 GB
  Disk:                  20 GB
  GPU Model:             NVIDIA A100
  GPU Count:             1
  GPU VRAM:              80 GB
  GPU Info:              NVIDIA A100 80GB PCIe
  Price/hr:              $3.500
  Price/mo:              $2,520.00
  Billing:               Hourly
```

***

## Understanding Flavor Names

Flavor names follow a naming convention that encodes their specifications:

| Prefix | Meaning                           |
| ------ | --------------------------------- |
| `C4i`  | Compute-optimized, 4th gen, Intel |
| `M4i`  | Memory-optimized, 4th gen, Intel  |
| `G4i`  | General purpose, 4th gen, Intel   |
| `GPU`  | GPU-accelerated                   |

Common sizes: `small`, `medium`, `large`, `xlarge`, `2xlarge`, `4xlarge`, `8xlarge`.

***

## Pricing

The flavor list and detail views include real-time pricing from the AceCloud pricing API:

* **PRICE/HR** — Hourly rate (pay-as-you-go)
* **PRICE/MO** — Monthly rate (approximate, based on full-month usage)

Pricing is displayed with the appropriate currency symbol for your account's billing region.

Pricing is fetched live from the API for the `instances` resource type. If the pricing API is temporarily unavailable, a dash (`-`) is shown instead of a price.

***

## Command Reference

| Command                            | Description                     |
| ---------------------------------- | ------------------------------- |
| `ace flavor list`                  | List all available flavors      |
| `ace flavor list --cpu`            | List CPU-only flavors           |
| `ace flavor list --gpu`            | List GPU-only flavors           |
| `ace flavor list --category <cat>` | List flavors by category        |
| `ace flavor get <name-or-id>`      | Get detailed flavor information |