---
title: "blockhost modify"
slug: "blockhost-modify"
updated: 2026-10-27T17:24:38Z
published: 2026-10-27T17:24:38Z
canonical: "docs.vastdata.com/blockhost-modify"
---

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

# blockhost modify

This command modifies a block host.

## Usage

```plaintext
blockhost modify --id ID
                 [--name NAME]
                 [--tags TAGS]
```

## Required Parameters

| `--id ID` | Specifies which block host to modify. |
| --- | --- |

## Options

| `--name NAME` | Specifies the host name. |
| --- | --- |
| `--tags TAGS` | Adds specified key-value pairs to tag the host, for the purpose of categorizing and organizing block hosts. Specify `TAGS` as a comma separated list of pairs of strings in the format `KEY=VALUE`. For example: `--tags owner=John,department=research` |

## Example

```plaintext
vcli: admin> blockhost modify --id 2 --tags team=coolguys,owner=bg
vcli: admin> blockhost show --id 2
+-------------+----------------------------------------------------------------------+
| Id          | 2                                                                    |
| Tenant-id   | 1                                                                    |
| Name        | blockhost1                                                           |
| Nqn         | nqn.2014-08.org.nvmexpress:uuid:4c4c4544-004e-3310-804d-c6c04f4b3234 |
| Tags        | {}                                                                   |
| Tenant-name | default                                                              |
+-------------+----------------------------------------------------------------------+
vcli: admin> blockhost modify --id 2 --tags "team=coolguys,owner=bg"
vcli: admin> blockhost show --id 2
+-------------+----------------------------------------------------------------------+
| Id          | 2                                                                    |
| Tenant-id   | 1                                                                    |
| Name        | blockhost1                                                           |
| Nqn         | nqn.2014-08.org.nvmexpress:uuid:4c4c4544-004e-3310-804d-c6c04f4b3234 |
| Tags        | {'team': 'coolguys', 'owner': 'bg'}                                  |
| Tenant-name | default                                                              |
+-------------+----------------------------------------------------------------------+
```