Skip to main content

dtctl image list

Usage​

dtctl image list [flags]

Aliases​

l

Description​

Retrieve the images available to you, optionally filtered by visibility or status.

Example​

# List all images, or only your private ones
dtctl image list
dtctl image list --visibility private

Response​

In text output (the default), this command returns the following columns: ID, Name, Status, Type, OS Type, OS Distro, Min. Volume Size, Size, Visibility.

Pass --output json to get the full response object instead.

Flags​

OptionDescription
--status, -sFilter by status. One of: queued, saving, active, killed, deleted, pending_delete, deactivated, uploading, importing
--visibility, -vFilter by visibility. One of: public, private, shared, community
CommandDescription
dtctl image showShow an image
dtctl image deleteDelete an image
dtctl image actionUpdate image metadata
dtctl image versionsList image versions

Global Flags​

OptionDescription
--api-urlSend this command to a different API endpoint, e.g. a test environment (default "https://console.dt.net.tr/api/v1")
--config, -cSpecify a custom config file
Default: ~/.config/dtctl/config.yaml
--no-headersOmit the column headers, for scripting
Default: false
--output, -oOutput format: text, wide, vertical, json. text fits the terminal, wide never truncates, vertical prints one field per line
Default: text