---
title: "cnode list"
slug: "cnode-list"
tags: ["5.4"]
updated: 2026-10-28T01:53:01Z
published: 2026-10-28T01:53:01Z
canonical: "docs.vastdata.com/cnode-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.

# cnode list

This command displays all CNodes and their details.

##### Usage

```plaintext
cnode list [--ip IP]
           [--state STATE]
           [--name NAME]
           [--enabled]
           [--vippool-id ID]
```

##### Options

| `--ip IP` | Filters the list by CNode IP address. |
| --- | --- |
| `--state STATE` | Filters the list by CNode state. Specify one of the following values for STATE: - INIT - ACTIVATING - ACTIVE - DEACTIVATING - INACTIVE - FAILING - FAILED |
| `--name NAME` | Filters the list by CNode name. |
| `--enabled` | If specified, only enabled CNodes are displayed. |
| `--vippool-id ID` | Filters the list by VIP pool ID. |

##### Example

```plaintext
vcli: admin> cnode list
+----+-------------+--------------+----------------+-----------+--------+---------+----------------------+------------+------------+------------+-------------+-------+-------------------+------------+----------------+
| ID | Name        | IP           | Mgmt-ip        | Host Name | State  | Enabled | Build                | Management | Cluster    | OS-Version | CBox        | Cores | Serial            | LED Status | BMC-FW-Version |
+----+-------------+--------------+----------------+-----------+--------+---------+----------------------+------------+------------+------------+-------------+-------+-------------------+------------+----------------+
| 7  | cnode-3-177 | 203.0.13.177 | 198.51.100.101 | myhost    | ACTIVE | True    | release-4-5-0-776058 | Yes        | mycluster  | 12.8.10    | cbox-200051 | 14    | a4:bf:01:7c:d1:1b | off        | 1.93.240       |
| 2  | cnode-3-178 | 203.0.13.178 | 198.51.100.103 | myhost    | ACTIVE | True    | release-4-5-0-776058 | No         | mycluster  | 12.8.10    | cbox-200051 | 14    | a4:bf:01:7c:c1:da | off        | 1.93.240       |
| 6  | cnode-3-179 | 203.0.13.179 | 198.51.100.105 | myhost    | ACTIVE | True    | release-4-5-0-776058 | No         | mycluster  | 12.8.10    | cbox-200051 | 14    | a4:bf:01:7c:c8:1a | off        | 1.93.240       |
+----+-------------+--------------+-------------------------+-------------+-----------+--------+---------+----------------------+------------+------------+------------+-------------+-------+-------------------+------------+----------------+
```