# docker config ls
**Descripción:** Lista las configuraciones (configs)
**Uso:** `docker config ls [OPTIONS]`
**Alias:** `docker config list`
**Orquestador:** Swarm
## Descripción
Ejecuta este comando en un nodo administrador (manager) para listar las configuraciones en el Swarm.
Para obtener información detallada sobre el uso de configuraciones, consulta [store configuration data using Docker Configs](/engine/swarm/configs/).
> [!NOTE]
> Este es un comando de administración de clústeres y debe ejecutarse en un nodo
> administrador (manager) de Swarm. Para obtener más información sobre administradores y trabajadores (workers), consulta la
> [sección de modo Swarm](/engine/swarm/) en la
> documentación.
## Opciones
| Opción | Predeterminado | Descripción |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| | `-f`, `--filter` | | Filtra la salida en función de las condiciones proporcionadas |
| `--format` | | Formatea la salida utilizando una plantilla personalizada:
'table': Imprime la salida en formato de tabla con encabezados de columna (predeterminado)
'table PLANTILLA': Imprime la salida en formato de tabla utilizando la plantilla de Go especificada
'json': Imprime en formato JSON
'PLANTILLA': Imprime la salida utilizando la plantilla de Go especificada.
Consulta https://docs-docker.esdocu.com/go/formatting/ para obtener más información sobre cómo formatear la salida con plantillas |
| `-q`, `--quiet` | | Muestra únicamente los IDs |
## Ejemplos
```console
$ docker config ls
ID NAME CREATED UPDATED
6697bflskwj1998km1gnnjr38 q5s5570vtvnimefos1fyeo2u2 6 weeks ago 6 weeks ago
9u9hk4br2ej0wgngkga6rp4hq my_config 5 weeks ago 5 weeks ago
mem02h8n73mybpgqjf0kfi1n0 test_config 3 seconds ago 3 seconds ago
```
### Filtrado (-f, --filter) {#filter}
El formato de la flag de filtrado (`-f` o `--filter`) es un par `clave=valor`. Si hay más de un filtro, pasa múltiples flags (ej., `--filter "foo=bar" --filter "bif=baz"`)
Los filtros admitidos actualmente son:
- [id](#id) (ID de la configuración)
- [label](#label) (`label=` o `label==`)
- [name](#name) (nombre de la configuración)
#### id
El filtro `id` coincide con todo el ID de una configuración o con su prefijo.
```console
$ docker config ls -f "id=6697bflskwj1998km1gnnjr38"
ID NAME CREATED UPDATED
6697bflskwj1998km1gnnjr38 q5s5570vtvnimefos1fyeo2u2 6 weeks ago 6 weeks ago
```
#### label
El filtro `label` coincide con las configuraciones según la presencia de una etiqueta sola o de una etiqueta y un valor.
El siguiente filtro coincide con todas las configuraciones que tengan una etiqueta `project` independientemente de su valor:
```console
$ docker config ls --filter label=project
ID NAME CREATED UPDATED
mem02h8n73mybpgqjf0kfi1n0 test_config About an hour ago About an hour ago
```
El siguiente filtro coincide únicamente con los servicios que tengan la etiqueta `project` con el valor `project-a`.
```console
$ docker config ls --filter label=project=project-a
ID NAME CREATED UPDATED
mem02h8n73mybpgqjf0kfi1n0 test_config About an hour ago About an hour ago
```
#### name
El filtro `name` coincide con todo el nombre de una configuración o con su prefijo.
El siguiente filtro coincide con la configuración que tenga un nombre que comience con el prefijo `test`.
```console
$ docker config ls --filter name=test
ID NAME CREATED UPDATED
mem02h8n73mybpgqjf0kfi1n0 test_config About an hour ago About an hour ago
```
### Formatear la salida (--format) {#format}
La opción de formato (`--format`) realiza una impresión limpia de la salida de las configuraciones utilizando una plantilla de Go.
A continuación se enumeran los marcadores de posición (placeholders) válidos para la plantilla de Go:
| Marcador de posición | Descripción |
|---|---|
| `.ID` | ID de la configuración |
| `.Name` | Nombre de la configuración |
| `.CreatedAt` | Hora en que se creó la configuración |
| `.UpdatedAt` | Hora en que se actualizó la configuración |
| `.Labels` | Todas las etiquetas asignadas a la configuración |
| `.Label` | Valor de una etiqueta específica para esta configuración. Por ejemplo `{{.Label "mi-etiqueta"}}` |
Al usar la opción `--format`, el comando `config ls` generará los datos exactamente como lo declara la plantilla o, cuando se use la directiva `table`, también incluirá los encabezados de las columnas.
El siguiente ejemplo utiliza una plantilla sin encabezados y genera las entradas `ID` y `Name` separadas por dos puntos (`:`) para todas las imágenes:
```console
$ docker config ls --format "{{.ID}}: {{.Name}}"
77af4d6b9913: config-1
b6fa739cedf5: config-2
78a85c484f71: config-3
```
Para listar todas las configuraciones con su nombre y fecha de creación en formato de tabla, puedes usar:
```console
$ docker config ls --format "table {{.ID}}\t{{.Name}}\t{{.CreatedAt}}"
ID NAME CREATED
77af4d6b9913 config-1 5 minutes ago
b6fa739cedf5 config-2 3 hours ago
78a85c484f71 config-3 10 days ago
```