---
title: "blockmapping map_volume_to_hosts"
slug: "blockmapping-map-volume-to-hosts"
tags: ["5.5"]
updated: 2026-10-27T23:00:54Z
published: 2026-10-27T23:00:54Z
canonical: "docs.vastdata.com/blockmapping-map-volume-to-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 map_volume_to_hosts

This command creates a mapping of a single block volume to one or more block hosts.

## Usage

```plaintext
blockmapping map_volume_to_hosts --volume-id
                                --blockhost-ids IDS
```

## Required Parameters

| `--volume-id` | Specifies the block volume to map to hosts. |
| --- | --- |
| `--blockhost-ids IDS` | Specifies block hosts to map to the specified volume. |

## Example

```plaintext
vcli: admin> blockmapping map_host_to_volumes --volume-id 5 --blockhost-ids 1  --snapshot-id 122

Waiting ...
Waiting ... \
[2025-02-27 22:50:59] mapping host Host1 to volume sub1block5, clone_id=1000000123 in subsystem Block1
[2025-02-27 22:50:59] mapping host Host1 to volume sub1block5 finished,remote_mapping_object_id=5, remote_volume_object_id=7
[2025-02-27 22:50:59] bulk mapping finished successfully ... |

Completed
```