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

# alarm list

This command lists alarms.

##### Usage

```plaintext
alarm list [--start-time START-TIME] 
           [--end-time END-TIME] 
           [--object-type TYPE]
           [--object-id OBJECT_ID] 
           [--message TEXT] 
           [--severity CRITICAL|MAJOR|MINOR] 
           [--page PAGE_NUMBER] 
           [--page-size NUMBER_ON_PAGE]
```

##### Options

| `--start-time START-TIME` | Starts listing from a specified alarm time. Specify START-TIME in the format *YYYY-MM-DD HH:MM:SS*. For example: 2017-10-19 10:31:47 |
| --- | --- |
| `--end-time END-TIME` | Ends listing by a specified alarm time. Specify END-TIME in the format *YYYY-MM-DD HH:MM:SS*. For example: 2017-10-19 10:31:47 |
| `--object-type TYPE` | Filters the list by object type. For example: `--object-type Cluster` Valid types include: ```plaintext Vms\|Cluster\|BMC\|CNode\|DNode\|ReplicationTarget\|ReplicationStream\| SSD\|NVRAM\|NIC\|Carrier\|Quota\|Fan\|PSU\|DBox\|CBox\|Switch\|Port\|Ldap\| NIS\|Task\|Host\|SupportBundle\|ActiveDirectory\|License ``` |
| `--object-id OBJECT_ID` | Filters the list by object ID. For example: `--object-id 23` |
| `--message TEXT` | Filters the list by alarm message text. Specify any text to search for as TEXT. The search is case sensitive. For example: `--message DEGRADED` |
| `--severity CRITICAL\|MAJOR\|MINOR` | Filters the list by alarm severity. |
| `--page PAGE_NUMBER` | Displays a specified page if `--page-size` is set. Defaults to the first page. |
| `--page-size NUMBER_ON_PAGE` | Sets the maximum number of alarms to display on a page. |

##### Example

```plaintext
vcli: admin> alarm list --severity CRITICAL
+----+---------------------+-------------+-----------+-----------+----------+----------------------------------------------------------------------------------+
| ID | Timestamp           | Object-type | Object-id | Cluster   | Severity | Alarm-message                                                                    |
+----+---------------------+-------------+-----------+-----------+----------+----------------------------------------------------------------------------------+
| 4  | 2020-08-19 12:09:27 | CNode       | 3         | vast2     | CRITICAL | CNode cnode-3 (203.0.113.7) [ac1n3] file server access changed from True to False |
| 3  | 2020-08-19 12:09:27 | CNode       | 2         | vast2     | CRITICAL | CNode cnode-2 (203.0.113.6) [ac1n2] file server access changed from True to False |
| 2  | 2020-08-19 12:09:27 | CNode       | 1         | vast2     | CRITICAL | CNode cnode-1 (203.0.113.5) [ac1n1] file server access changed from True to False |
+----+---------------------+-------------+-----------+-----------+----------+----------------------------------------------------------------------------------+
```