---
title: "blockmapping list"
slug: "blockmapping-list"
updated: 2026-10-27T17:24:31Z
published: 2026-10-27T17:24:31Z
canonical: "docs.vastdata.com/blockmapping-list"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# blockmapping list

This command displays mappings of block volumes to hosts.

## Usage

```plaintext
blockmapping list [--tenant-id ID]
```

## Options

| `--tenant-id ID` | Specifies for which tenant to display block mappings. Defaults to the default tenant. |
| --- | --- |

## Example

```plaintext
vcli: admin> blockmapping list
+----+-----------+--------------+-------------------------------+
| Id | Volume id | BlockHost id | Snapshot-data                 |
+----+-----------+--------------+-------------------------------+
| 1  | 3         | 1            | {'id': None, 'name': 'N/A'}   |
| 3  | 8         | 1            | {'id': 1, 'name': 'Vol1Snap'} |
| 4  | 9         | 1            | {'id': 5, 'name': 'CatsSnap'} |
| 5  | 7         | 1            | {'id': None, 'name': 'N/A'}   |
+----+-----------+--------------+-------------------------------+
```

## Command Output

| `Id` | The identifier of the mapping. |
| --- | --- |
| `Volume id` | The identifier of a block volume. |
| `BlockHost id` | The identifier of a block host that is mapped to the volume specified in the `Volume id` column. |
| `Snapshot-data` | The ID and name of a snapshot of the mapped volume that is mapped to the specified host. |