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

> ## 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 unmap_volume_hosts

This command removes mappings between a block volume and specified block hosts.

## Usage

```plaintext
blockmapping unmap_volume_hosts --volume-id ID
                                --blockhost-ids IDS
```

## Required Parameters

| `--volume-id ID` | Specifies the volume. |
| --- | --- |
| `--blockhost-ids IDS` | Specifies the block hosts to unmap from the specified volume. Specify IDS as a comma separated list of block host IDs. |

## Example

```plaintext
vcli: admin> blockmapping unmap_volume_hosts --volume-id 2 --blockhost-ids 1

Waiting ...
Waiting ... \
[2025-03-02 14:43:02] un-mapping host Host1 to volume BlockTeam1Vol2
[2025-03-02 14:43:02] un-mapping host Host1 to volume BlockTeam1Vol2 finished
[2025-03-02 14:43:02] bulk mapping finished successfully ... |

Completed
vcli: admin>
```