---
name: "getDevAlarmList"
mode: "api"
versionRequirements:
  - { name: "@ray-js/ray", version: "1.5.2" }
title: "getDevAlarmList - 根据设备 ID 查询告警列表信息。"
---

## getDevAlarmList

> [VERSION] @ray-js/ray >= 1.5.2

### 描述

根据设备 ID 查询告警列表信息

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `devId` | `string` | 是 | 设备 ID |

### 返回值

类型: `Promise<AlarmList[]>`

告警规则列表，包含告警 ID、名称、启用状态、绑定信息等

##### AlarmList

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `auditStatus` | `number` | 审核状态 |
| `boundForPanel` | `boolean` | 是否被场景面板绑定 |
| `boundForWiFiPanel` | `boolean` | 是否被 WIFI 场景面板绑定 |
| `enabled` | `boolean` | 是否启用 |
| `i18nData` | `Object` | 多语言数据体 |
| `id` | `string` | 规则 ID |
| `iotAutoAlarm` | `boolean` | 是否为 IoT 自动告警 |
| `isLogicRule` | `boolean` | 是否为逻辑规则 |
| `localLinkage` | `boolean` | 是否为本地联动 |
| `name` | `string` | 规则名称 |
| `newLocalScene` | `boolean` | 是否为 APP 管控本地联动 |
| `stickyOnTop` | `boolean` | 场景是否显示在首页 |

##### AlarmList.i18nData 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `name` | `Object` | 是 | - | 名称 |
| `content` | `Object` | 是 | - | 内容 |


##### AlarmList.i18nData.name 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `en` | `string` | 是 | - | 英文名称 |
| `zh` | `string` | 是 | - | 中文名称 |


##### AlarmList.i18nData.content 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `en` | `string` | 是 | - | 英文内容 |
| `zh` | `string` | 是 | - | 中文内容 |


### 示例代码

#### 基础用法

```ts
import { getDevAlarmList } from '@ray-js/ray';

getDevAlarmList('vdevo169477319679442').then((res) => {
  console.log('告警列表:', res);
}).catch((error) => {
  console.error(error);
});
```