---
title: influxdb3 debug sweep list
description: The influxdb3 debug sweep list command names orphaned file cleanup passes recorded for an InfluxDB 3 Enterprise cluster.
url: https://docs.influxdata.com/influxdb3/enterprise/reference/cli/influxdb3/debug/sweep/list/
estimated_tokens: 867
product: InfluxDB 3 Enterprise
version: enterprise
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/enterprise/reference/cli/influxdb3/debug/sweep/list/
date: '2026-09-29T11:52:29-04:00'
lastmod: '2026-09-29T11:52:29-04:00'
---

The `influxdb3 debug sweep list` command names the[orphaned file cleanup](/influxdb3/enterprise/admin/orphaned-file-cleanup/)passes recorded for a cluster, oldest to newest.
It reads the audit trail directly from object storage and doesn’t need a
running InfluxDB 3 Enterprise server.

## Usage

```bash
influxdb3 debug sweep list [OPTIONS] --cluster-id <CLUSTER_ID>
```

## Options

|                  Option                   |                                                                Description                                                                |Required|
|-------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|--------|
|      `--object-store <OBJECT_STORE>`      |Object store type. Valid values: `s3`, `google`, `azure`, `file`, `memory`. Default: `file`. Environment variable: `INFLUXDB3_OBJECT_STORE`|   No   |
|            `--bucket <BUCKET>`            |                           Object store bucket name. Required for `s3`, `google`, and `azure` object store types                           | Varies |
|        `--cluster-id <CLUSTER_ID>`        |                          Cluster whose cleanup audit trail to read. Environment variable: `INFLUXDB3_CLUSTER_ID`                          |  Yes   |
|`--engine-path-prefix <ENGINE_PATH_PREFIX>`|                  Engine path prefix the cluster runs with, if any. Environment variable: `INFLUXDB3_ENGINE_PATH_PREFIX`                   |   No   |
|              `-h`, `--help`               |                                                          Print help information                                                           |   No   |
|               `--help-all`                |                                                      Print detailed help information                                                      |   No   |

`influxdb3 debug sweep list` accepts the same object store connection
options as `influxdb3 serve`. For example, `--aws-access-key-id` and`--aws-secret-access-key` for S3-compatible stores.
For the complete object store flag reference, see[`influxdb3 debug object-store-check`](/influxdb3/enterprise/reference/cli/influxdb3/debug/object-store-check/#options).

## Examples

### List recorded cleanup passes

Replace the following:

* `CLUSTER_ID`:
  your cluster identifier
* `S3_BUCKET`:
  your object store bucket name

```bash
influxdb3 debug sweep list \
  --object-store s3 \
  --bucket S3_BUCKET \
  --cluster-id CLUSTER_ID
```

If no passes are recorded yet, the command prints `no passes recorded` to
standard error and exits successfully.
| Option | Description | Required |
| --- | --- | --- |
| Option | Description | Required |
| --object-store <OBJECT_STORE> | Object store type. Valid values:  s3 ,  google ,  azure ,  file ,  memory . Default:  file . Environment variable:  INFLUXDB3_OBJECT_STORE | No |
| --bucket <BUCKET> | Object store bucket name. Required for  s3 ,  google , and  azure  object store types | Varies |
| --cluster-id <CLUSTER_ID> | Cluster whose cleanup audit trail to read. Environment variable:  INFLUXDB3_CLUSTER_ID | Yes |
| --engine-path-prefix <ENGINE_PATH_PREFIX> | Engine path prefix the cluster runs with, if any. Environment variable:  INFLUXDB3_ENGINE_PATH_PREFIX | No |
| -h ,  --help | Print help information | No |
| --help-all | Print detailed help information | No |
