# docker buildx history ls

**Descripción:** Lista los registros de construcción

**Uso:** `docker buildx history ls [OPTIONS]`










## Descripción

Lista las construcciones finalizadas registradas por el builder activo. Cada entrada
incluye el ID de construcción, el nombre, el estado, la marca de tiempo y la duración.

De forma predeterminada, solo se muestran los registros del builder actual. Puedes filtrar
los resultados mediante banderas.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `--filter` |  |  Proporciona valores de filtro (por ejemplo, `status=error`) |

 | `--format` | `table` |  Formatea la salida |

 | `--local` |  |  Lista registros únicamente para el repositorio actual |

 | `--no-trunc` |  |  No trunca la salida |




## Ejemplos

### Listar todos los registros de construcción para el builder actual

```console
$ docker buildx history ls
BUILD ID                    NAME           STATUS     CREATED AT        DURATION
qu2gsuo8ejqrwdfii23xkkckt   .dev/2850      Completed  3 days ago        1.4s
qsiifiuf1ad9pa9qvppc0z1l3   .dev/2850      Completed  3 days ago        1.3s
g9808bwrjrlkbhdamxklx660b   .dev/3120      Completed  5 days ago        2.1s
```

### Listar construcciones fallidas (--filter) {#filter}

```console
docker buildx history ls --filter status=error
```

Puedes filtrar la lista utilizando la bandera `--filter`. Los filtros admitidos incluyen:

| Filtro | Comparaciones admitidas | Ejemplo |
|:---------------------------------------|:-------------------------------------------------|:---------------------------|
| `ref`, `repository`, `status`          | Soporta las comparaciones `=` y `!=` | `--filter status!=success` |
| `startedAt`, `completedAt`, `duration` | Soporta las comparaciones `<` y `>` con valores de tiempo | `--filter duration>30s` |

Puedes combinar múltiples filtros repitiendo la bandera `--filter`:

```console
docker buildx history ls --filter status=error --filter duration>30s
```

### Listar construcciones del proyecto actual (--local) {#local}

```console
docker buildx history ls --local
```

### Mostrar la salida completa sin truncamiento (--no-trunc) {#no-trunc}

```console
docker buildx history ls --no-trunc
```

### Formatear la salida (--format) {#format}

#### Salida JSON

```console
$ docker buildx history ls --format json
[
  {
    "ID": "qu2gsuo8ejqrwdfii23xkkckt",
    "Name": ".dev/2850",
    "Status": "Completed",
    "CreatedAt": "2025-04-15T12:33:00Z",
    "Duration": "1.4s"
  },
  {
    "ID": "qsiifiuf1ad9pa9qvppc0z1l3",
    "Name": ".dev/2850",
    "Status": "Completed",
    "CreatedAt": "2025-04-15T12:29:00Z",
    "Duration": "1.3s"
  }
]
```

#### Salida de plantilla Go

```console
$ docker buildx history ls --format '{{.Name}} - {{.Duration}}'
.dev/2850 - 1.4s
.dev/2850 - 1.3s
.dev/3120 - 2.1s
```