Images

Images are operating system or application disk images used to boot instances. AceCloud provides a catalog of public images and supports user-created (private) images from snapshots and saves.

Command: ace image

---

Table of Contents

• List Images

• Get Image Details

• Delete Images

• Image Categories

---

List Images

List all available images in the current region.

ace image list

Aliases: ls

Filters

Flag	Description
--os	Filter by operating system (e.g. ubuntu, centos, windows, debian)
--category	Filter by image category

Examples

# List all images
ace image list

# Filter by OS
ace image list --os ubuntu
ace image list --os centos

# Filter by category
ace image list --category "Linux"

# JSON output
ace image list -o json

Table Output

ID                                     NAME                                STATUS         SIZE VISIBILITY
abc12345-1234-1234-1234-123456789abc   Ubuntu-22.04-LTS                    active       2.5 GB public
def67890-1234-1234-1234-123456789abc   Ubuntu-24.04-LTS                    active       2.8 GB public
111aaaaa-2222-3333-4444-555555555555   CentOS-9-Stream                     active       1.9 GB public

---

Get Image Details

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

ace image get <image-name-or-id>

Aliases: show, describe

Examples

# By name
ace image get Ubuntu-22.04-LTS

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

# JSON output
ace image get Ubuntu-22.04-LTS -o json

Detail Output

ID:                  abc12345-1234-1234-1234-123456789abc
Name:                Ubuntu-22.04-LTS
Status:              active
Visibility:          public
Size:                2.5 GB
Virtual Size:        10.0 GB
Disk Format:         qcow2
Container Format:    bare
Min Disk:            20 GB
Min RAM:             512 MB
Created:             2024-01-15T10:30:00Z
Updated:             2024-06-20T14:45:00Z
Tags:                [ubuntu, lts, 22.04]

---

Delete Images

Delete one or more images. Accepts image names or UUIDs. Names are automatically resolved to UUIDs.

# Delete a single image
ace image delete <image-name-or-id>

# Delete multiple images
ace image delete <image-1> <image-2> <image-3>

Aliases: rm

# Delete by name
ace image delete my-custom-image

# Delete by UUID
ace image delete abc12345-1234-1234-1234-123456789abc

# Delete multiple
ace image delete old-snapshot-1 old-snapshot-2

You can only delete images that belong to your project (private/shared visibility). Public images provided by AceCloud cannot be deleted.

---

Image Categories

List all available image categories. Categories group images by OS family or purpose.

ace image categories

Example Output

ID                                     NAME                      DESCRIPTION
aaa11111-2222-3333-4444-555555555555   Linux                     Linux-based operating systems
bbb11111-2222-3333-4444-555555555555   Windows                   Windows Server images
ccc11111-2222-3333-4444-555555555555   Application               Pre-configured application images

Use a category ID or name with the --category flag on ace image list:

ace image list --category Linux

---

Image Types

Visibility	Description
public	Provided by AceCloud, available to all users
private	Created by you (via snapshot or save-image), visible only in your project
shared	Shared with your project by another user

---

Common Images

Some commonly used public images:

Name	OS	Notes
Ubuntu-22.04-LTS	Ubuntu 22.04	Long-term support
Ubuntu-24.04-LTS	Ubuntu 24.04	Latest LTS
CentOS-9-Stream	CentOS 9	Stream release
Debian-12	Debian 12	Bookworm
Rocky-Linux-9	Rocky Linux 9	RHEL-compatible

Image availability varies by region. Use ace image list to see what is available in your current region.

---

Command Reference

Command	Description
ace image list	List all images
ace image list --os <os>	Filter images by OS
ace image list --category <cat>	Filter images by category
ace image get <name-or-id>	Get image details
ace image delete <name-or-id> [...]	Delete one or more images
ace image categories	List image categories