1podman-secret-ls(1)         General Commands Manual        podman-secret-ls(1)
2
3
4

NAME

6       podman-secret-ls - List all available secrets
7
8

SYNOPSIS

10       podman secret ls [options]
11
12

DESCRIPTION

14       Lists  all  the secrets that exist. The output can be formatted to a Go
15       template using the --format option.
16
17

OPTIONS

19   --filter, -f=filter=value
20       Filter output based on conditions given.  Multiple filters can be given
21       with multiple uses of the --filter option.
22
23
24       Valid filters are listed below:
25
26
27       ┌───────┬────────────────────────────────┐
28       │Filter │ Description                    │
29       ├───────┼────────────────────────────────┤
30       │name   │ [Name]  Secret  name  (accepts │
31       │       │ regex)                         │
32       ├───────┼────────────────────────────────┤
33       │id     │ [ID] Full or partial secret ID │
34       └───────┴────────────────────────────────┘
35
36   --format=format
37       Format secret output using Go template.
38
39
40       Valid placeholders for the Go template are listed below:
41
42
43       ┌─────────────────────────┬────────────────────────────┐
44       │Placeholder              │ Description                │
45       ├─────────────────────────┼────────────────────────────┤
46       │.CreatedAt               │ When  secret  was  created │
47       │                         │ (relative  timestamp,  hu‐ │
48       │                         │ man-readable)              │
49       ├─────────────────────────┼────────────────────────────┤
50       │.ID                      │ ID of secret               │
51       ├─────────────────────────┼────────────────────────────┤
52       │.SecretData              │ Secret   Data   (Displayed │
53       │                         │ only with --showsecret op‐ │
54       │                         │ tion)                      │
55       ├─────────────────────────┼────────────────────────────┤
56       │.Spec ...                │ Details of secret          │
57       ├─────────────────────────┼────────────────────────────┤
58       │.Spec.Driver             │ Driver info                │
59       ├─────────────────────────┼────────────────────────────┤
60       │.Spec.Driver.Name        │ Driver name (string)       │
61       ├─────────────────────────┼────────────────────────────┤
62       │.Spec.Driver.Options ... │ Driver  options  (map   of │
63       │                         │ driver-specific options)   │
64       ├─────────────────────────┼────────────────────────────┤
65       │.Spec.Labels             │ Labels for this secret     │
66       ├─────────────────────────┼────────────────────────────┤
67       │.Spec.Name               │ Name of secret             │
68       ├─────────────────────────┼────────────────────────────┤
69       │.UpdatedAt               │ When  secret  was last up‐ │
70       │                         │ dated (relative timestamp, │
71       │                         │ human-readable)            │
72       └─────────────────────────┴────────────────────────────┘
73
74   --noheading, -n
75       Omit the table headings from the listing.
76
77
78   --quiet, -q
79       Print secret IDs only.
80
81

EXAMPLES

83       $ podman secret ls
84       $ podman secret ls --format "{{.Name}}"
85       $ podman secret ls --filter name=confidential
86
87
88

SEE ALSO

90       podman(1), podman-secret(1)
91
92

HISTORY

94       January   2021,  Originally  compiled  by  Ashley  Cui  acui@redhat.com
95       ⟨mailto:acui@redhat.com⟩
96
97
98
99                                                           podman-secret-ls(1)