---
title: "switch list"
slug: "switch-list"
tags: ["5.5"]
updated: 2026-10-27T23:00:54Z
published: 2026-10-27T23:00:54Z
canonical: "docs.vastdata.com/switch-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.

# switch list

This command displays all cluster switches added to VMS or discovered by VMS, and their details.

## Usage

```plaintext
switch list
```

## Example

```plaintext
vcli: admin> switch list
+----+----------------------------------------------+---------------+---------------+--------------+-------+-------------+
| ID | Title                                        | Ip            | Model         | Sn           | State | Switch-type |
+----+----------------------------------------------+---------------+---------------+--------------+-------+-------------+
| 1  | rack3-1: switch-MSN3700-VS2FC (MT2436J001X0) | <IP>          | MSN3700-VS2FC | MT2436J001X0 | OK    | cumulus     |
| 2  | rack3-2: switch-MSN3700-VS2FC (MT2436J001XU) | <IP>          | MSN3700-VS2FC | MT2436J001XU | OK    | cumulus     |
+----+----------------------------------------------+---------------+---------------+--------------+-------+-------------+
```

## Command Output

| `ID` | The VMS ID of the switch. |
| --- | --- |
| `Title` | The descriptive name of the switch. |
| `Ip` | The IP address of the switch. |
| `Model` | The switch model. |
| `Sn` | The switch serial number. |
| `State` | State. Values vary according to vendor. |
| `Switch-type` | The switch vendor. Possible values: - `arista` - `mellanox` - `mellanox-os` - `aruba` - `cumulus` |