# vhsm list

The `vhsm list` command retrieves a list of data or secerts from vHSM at a specified path. It is a wrapper around the HTTP `LIST` method and is typically used to list keys in a secrets engine.

***

### **Usage**

```sh
vhsm list [options] <PATH>
```

* `<PATH>`: The vHSM path where data should be listed.

{% hint style="info" %}
**Note:** Not all secret engines support listing. Refer to the specific engine's documentation for more details.
{% endhint %}

***

### **Example**

This command lists all metadata under the secret folder.

```sh
vhsm list secret/metadata/
```

**Output**

```
Keys
----
my-app/
```

Each key represents a stored metadata.

***

### **Options**

#### **HTTP Options**

| Option                 | Description                                                                                  |
| ---------------------- | -------------------------------------------------------------------------------------------- |
| `-address=<string>`    | Address of the vHSM server. Default: `https://127.0.0.1:8200` (can be set via `VAULT_ADDR`). |
| `-namespace=<string>`  | Namespace for the command (`VAULT_NAMESPACE`).                                               |
| `-tls-skip-verify`     | Disables TLS certificate verification (not recommended, `VAULT_SKIP_VERIFY`).                |
| `-wrap-ttl=<duration>` | Wraps response in a cubbyhole token (e.g., `30s`, `5m`, `VAULT_WRAP_TTL`).                   |

#### **Output Options**

| Option             | Description                                                                          |
| ------------------ | ------------------------------------------------------------------------------------ |
| `-format=<string>` | Output format: `table`, `json`, `yaml`, `pretty`. Default: `table` (`VAULT_FORMAT`). |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enclaive.cloud/virtual-hsm/cli/secret-management/vhsm-list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.