---
title: "List Images"
method: GET
path: "/images/json"
---

# List Images

`GET /images/json`

Return a list of stored images.

## Query parameters

- `all` boolean
- `filters` string
- `digests` boolean

## Response `200`

Summary image data for the images matching the query

- ImageInfo[]
  - `Id` string — ID of an image.
  - `RepoTags` string[] — repository with tag.
  - `RepoDigests` string[] — repository with digest.
  - `CreatedAt` string — time of image creation.
  - `Size` integer — size of image's taking disk space.
  - `Config` ContainerConfig — Configuration for a container that is portable between hosts
    - `Hostname` string, hostname — The hostname to use for the container, as a valid RFC 1123 hostname.
    - `Domainname` string — The domain name to use for the container.
    - `User` string — The user that commands are run as inside the container.
    - `AttachStdin` boolean — Whether to attach to `stdin`.
    - `AttachStdout` boolean — Whether to attach to `stdout`.
    - `AttachStderr` boolean — Whether to attach to `stderr`.
    - `DisableNetworkFiles` boolean — Whether to generate the network files(/etc/hostname, /etc/hosts and /etc/resolv.conf) for container.
    - `ExposedPorts` object — An object mapping ports to an empty object in the form:`{<port>/<tcp|udp>: {}}`
    - `Tty` boolean — Attach standard streams to a TTY, including `stdin` if it is not closed.
    - `OpenStdin` boolean — Open `stdin`
    - `StdinOnce` boolean — Close `stdin` after one attached client disconnects
    - `Env` string[] — A list of environment variables to set inside the container in the form `["VAR=value", ...]`. A variable like "A=" means setting env A in container to be empty value. And a variable without `=` is removed from the environment, rather than to have an empty value.
    - `Cmd` string[] — Command to run specified an array of strings.
    - `ArgsEscaped` boolean — Command is already escaped (Windows only)
    - `Image` string, required — The name of the image to use when creating the container
    - `Volumes` object — An object mapping mount point paths inside the container to empty objects.
    - `WorkingDir` string — The working directory for commands to run in.
    - `Entrypoint` string[] — The entry point for the container as a string or an array of strings. If the array consists of exactly one empty string (`[""]`) then the entry point is reset to system default.
    - `NetworkDisabled` boolean — Disable networking for the container.
    - `MacAddress` string — MAC address of the container.
    - `OnBuild` string[] — `ONBUILD` metadata that were defined.
    - `Labels` object — User-defined key/value metadata.
    - `StopSignal` string — Signal to stop a container as a string or unsigned integer.
    - `StopTimeout` integer — Timeout to stop a container in seconds.
    - `Shell` string[] — Shell for when `RUN`, `CMD`, and `ENTRYPOINT` uses a shell.
    - `Rich` boolean — Whether to start container in rich container mode. (default false)
    - `RichMode` 'dumb-init' | 'sbin-init' | 'systemd' — Choose one rich container mode.(default dumb-init)
    - `InitScript` string — Initial script executed in container. The script will be executed before entrypoint or command
    - `DiskQuota` object, nullable — Set disk quota for container. Key is the dir in container. Value is disk quota size for the dir. / means rootfs dir in container. .* includes rootfs dir and all volume dir.
    - `SpecAnnotation` object — annotations send to runtime spec.
    - `QuotaID` string — Set disk quota by specified quota id. If QuotaID <= 0, it means pouchd should allocate a unique quota id by sequence automatically. By default, a quota ID is mapped to only one container. And one quota ID can include several mountpoint.
    - `NetPriority` integer — net priority.
    - `SpecificID` string — Create container with given id. MinLength: 64 MaxLength: 64 The characters of given id should be in 0123456789abcdef. By default, given id is unnecessary.
    - `Snapshotter` string — The snapshotter container choose, can be different with default snapshotter. The Field only set through hook plugin.
  - `Architecture` string — the CPU architecture.
  - `Os` string — the name of the operating system.
  - `RootFS` object — the rootfs key references the layer content addresses used by the image.
    - `Type` string, required — type of the rootfs
    - `Layers` string[] — an array of layer content hashes
    - `BaseLayer` string — the base layer content hash.

## Other responses

- `500` — An unexpected server error occurred.

---

[API](https://skmtc.net/aliyun/apis/pouch-engine-api.md) · [All operations](https://skmtc.net/aliyun/apis/pouch-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aliyun/pouch-engine-api/versions/36d75b2825fc/schema)