mirror of
https://github.com/containers/podman.git
synced 2025-11-29 09:37:38 +08:00
71 lines
2.2 KiB
Markdown
71 lines
2.2 KiB
Markdown
% podman-artifact-ls 1
|
|
|
|
## NAME
|
|
podman\-artifact\-ls - List OCI artifacts in local store
|
|
|
|
## SYNOPSIS
|
|
**podman artifact ls** [*options*]
|
|
|
|
## DESCRIPTION
|
|
|
|
List all local artifacts in your local store.
|
|
|
|
## OPTIONS
|
|
|
|
#### **--format**
|
|
|
|
Print results with a Go template.
|
|
|
|
| **Placeholder** | **Description** |
|
|
|-----------------|------------------------------------------------|
|
|
| .Created | Elapsed time since the artifact was created |
|
|
| .Digest | The computed digest of the artifact's manifest |
|
|
| .Repository | Repository name of the artifact |
|
|
| .Size | Size artifact in human readable units |
|
|
| .Tag | Tag of the artifact name |
|
|
| .VirtualSize | Size of artifact in bytes |
|
|
|
|
@@option no-trunc
|
|
|
|
@@option noheading
|
|
|
|
## EXAMPLES
|
|
|
|
List artifacts in the local store
|
|
```
|
|
$ podman artifact ls
|
|
REPOSITORY TAG DIGEST CREATED SIZE
|
|
quay.io/artifact/foobar1 latest ab609fad386d 6 hours ago 2.097GB
|
|
quay.io/artifact/foobar2 special cd734b558ceb 53 seconds ago 12.58MB
|
|
```
|
|
|
|
List artifacts in the local store without truncating the digest
|
|
```
|
|
$ podman artifact ls --no-trunc
|
|
REPOSITORY TAG DIGEST CREATED SIZE
|
|
quay.io/artifact/foobar1 latest ab609fad386df1433f461b0643d9cf575560baf633809dcc9c190da6cc3a3c29 6 hours ago 2.097GB
|
|
quay.io/artifact/foobar2 special cd734b558ceb8ccc0281ca76530e1dea1eb479407d3163f75fb601bffb6f73d0 53 seconds ago 12.58MB
|
|
```
|
|
|
|
List artifacts in the local store without the title header
|
|
```
|
|
$ podman artifact ls --noheading
|
|
quay.io/artifact/foobar1 latest ab609fad386d 6 hours ago 2.097GB
|
|
quay.io/artifact/foobar2 special cd734b558ceb 53 seconds ago 12.58MB
|
|
```
|
|
|
|
List artifact digests and size using a --format
|
|
```
|
|
$ podman artifact ls --format "{{.Digest}} {{.Size}}"
|
|
ab609fad386d 2.097GB
|
|
cd734b558ceb 12.58MB
|
|
```
|
|
|
|
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-artifact(1)](podman-artifact.1.md)**
|
|
|
|
## HISTORY
|
|
Jan 2025, Originally compiled by Brent Baude <bbaude@redhat.com>
|