# docker secret inspect

**Descripción:** Muestra información detallada sobre uno o más secretos

**Uso:** `docker secret inspect [OPTIONS] SECRET [SECRET...]`








**Orquestador:** Swarm

## Descripción

Inspecciona el secreto especificado.

Por defecto, este comando muestra todos los resultados en una matriz JSON. Si se especifica un formato,
la plantilla dada se ejecutará para cada resultado.

El paquete [text/template](https://pkg.go.dev/text/template) de Go
describe todos los detalles del formato.

Para obtener información detallada sobre el uso de secretos, consulta [gestionar datos sensibles con secretos de Docker](/engine/swarm/secrets/).

> [!NOTE]
> Este es un comando de gestión de clústeres y debe ejecutarse en un nodo administrador de Swarm (manager node).
> Para obtener más información sobre administradores y trabajadores, consulta la
> [sección del modo Swarm](/engine/swarm/) en la
> documentación.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `-f`, `--format` |  |  Da formato a la salida utilizando una plantilla personalizada:<br>'json':             Imprime en formato JSON<br>'TEMPLATE':         Imprime la salida utilizando la plantilla Go especificada.<br>Consulta https://docs-docker.esdocu.com/go/formatting/ para obtener más información sobre cómo dar formato a la salida con plantillas |

 | `--pretty` |  |  Imprime la información en un formato legible para humanos |




## Ejemplos

### Inspeccionar un secreto por nombre o ID

Puedes inspeccionar un secreto, ya sea por su nombre o por su ID.

Por ejemplo, dado el siguiente secreto:

```console
$ docker secret ls

ID                          NAME                CREATED             UPDATED
eo7jnzguqgtpdah3cm5srfb97   my_secret           3 minutes ago       3 minutes ago
```

```console
$ docker secret inspect secret.json
```

La salida está en formato JSON, por ejemplo:

```json
[
  {
    "ID": "eo7jnzguqgtpdah3cm5srfb97",
    "Version": {
      "Index": 17
    },
    "CreatedAt": "2017-03-24T08:15:09.735271783Z",
    "UpdatedAt": "2017-03-24T08:15:09.735271783Z",
    "Spec": {
      "Name": "my_secret",
      "Labels": {
        "env": "dev",
        "rev": "20170324"
      }
    }
  }
]
```

### Dar formato a la salida (--format) {#format}

Puedes utilizar la opción `--format` para obtener información específica sobre un
secreto. El siguiente comando de ejemplo muestra la fecha de creación del
secreto.

```console
$ docker secret inspect --format='{{.CreatedAt}}' eo7jnzguqgtpdah3cm5srfb97

2017-03-24 08:15:09.735271783 +0000 UTC
```