---
title: "blockmapping map_host_to_volumes"
slug: "blockmapping-map-host-to-volumes"
updated: 2026-10-27T17:24:31Z
published: 2026-10-27T17:24:31Z
canonical: "docs.vastdata.com/blockmapping-map-host-to-volumes"
---

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

This command creates a mapping of a single block storage host to one or more block storage volumes.

## Usage

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

## Required Parameters

| `--blockhost-id ID` | Specifies the block host to map to volumes. |
| --- | --- |
| `--volume-ids IDS` | Specifies one or more volumes to map to the host. Specify `IDS` as a comma separated list of volume IDs. |

## Examples

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

Waiting ...
Waiting ... \
[2025-02-26 17:42:57] mapping host blockhost1 to volume dev/platform, clone_id=None in subsystem blocktarget1
[2025-02-26 17:42:58] mapping host blockhost1 to volume dev/platform finished,remote_mapping_object_id=1, remote_volume_object_id=1
[2025-02-26 17:42:58] bulk mapping finished successfully ... |

Completed
vcli: admin>
```

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

Waiting ...
Waiting ... \
[2025-04-06 14:59:40] mapping host Host to volume vol1, clone_id=1000000001 in subsystem Subsystem
[2025-04-06 14:59:40] mapping host Host to volume vol1 finished,remote_mapping_object_id=7, remote_volume_object_id=15
[2025-04-06 14:59:41] bulk mapping finished successfully ... |

Completed
```