# 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 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.acecloud.ai/knowledge-base/cli/compute/flavors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.