# DescribeDeviceList

[device] 查询满足条件的终端数据详情，私有化调用path为：/capi/Assets/Device/DescribeDeviceList 前置：DescribeRootGroupId 或 DescribeDeviceChildGroups 拿 GroupId (GroupId 与 OsType 必须匹配)。

Agent View of the PolicyLayer registry record for `DescribeDeviceList`. HTML page: https://policylayer.com/tools/ioacloud-ioacloud-mcp/describedevicelist

## Facts

- Tool: `DescribeDeviceList`
- Server: Ioacloud (`@ioacloud/ioacloud-mcp`) — https://policylayer.com/tools/ioacloud-ioacloud-mcp.md
- Install: `npx -y @ioacloud/ioacloud-mcp`
- Homepage: https://www.npmjs.com/package/@ioacloud/ioacloud-mcp
- Risk category: Read (Low risk)
- Registry record: grade D, identity unverified
- Server rate-limited: no
- Parameters: 12
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `Sort` | object | no | 排序字段--兼容旧接口,参数同Condition |
| `OsType` | number | no | 终端树分组OsType枚举值：-1： 不区分系统0： Windows1： Linux2： macOS4： Android5： iOS |
| `Status` | number | no | 授权状态（4未授权 5已授权） |
| `Filters` | array | no | 过滤条件--兼容旧接口,参数同Condition |
| `GroupId` | number | no | 终端树分组ID（和GroupIds必须有一个填写）私有化默认分组 id-名称-操作系统 // 1 全网终端 Win // 2 未分组终端 Win // 30000000 服务器 Win // 40000101 全网终端 Linux // 40000102 未分组终端 Linux // 40000103 服务器 Linu |
| `PageNum` | number | no | 获取第几页--兼容旧接口,参数同Condition |
| `GroupIds` | object | no | 终端树分组ID列表（需要和OsType匹配）【和GroupId必须有一个填写】 |
| `NewScope` | number | no | 新版范围组件的标识（1:新版范围组件, 不传:旧版范围组件） |
| `PageSize` | number | no | 每页获取数--兼容旧接口,参数同Condition |
| `Condition` | object | no | 过滤条件 |
| `DeviceIds` | object | no | 终端Id列表 |
| `LoginType` | object | no | 登录类型 1 账号登录 2 ad域 4 信息登记枚举值：1： 账号登录2： ad域登录4： 信息登记 |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "DescribeDeviceList",
    "arguments": {}
  }
}
```

## Why DescribeDeviceList is rated Low

Even though DescribeDeviceList only reads data, uncontrolled read access leaks sensitive information and racks up API costs: an agent caught in a retry loop can make thousands of calls a minute without anyone noticing.

Risk signals: High parameter count (43 properties)

## Use case

AI agents call DescribeDeviceList to retrieve information from Ioacloud without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Ioacloud:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "DescribeDeviceList": {}
  }
}
```

## Other tools on Ioacloud (505)

- `IoaLogout` — Destructive — https://policylayer.com/tools/ioacloud-ioacloud-mcp/ioalogout.md
- `DescribeAccessDeviceTrafficHistogram` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccessdevicetraffichistogram.md
- `DescribeAccessReportByResource` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccessreportbyresource.md
- `DescribeAccessReportByUser` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccessreportbyuser.md
- `DescribeAccessStats` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccessstats.md
- `DescribeAccessStrategyDetail` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccessstrategydetail.md
- `DescribeAccessTopTerms` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccesstopterms.md
- `DescribeAccessUserCountTopTerm` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccessusercounttopterm.md
- `DescribeAccessUserList` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccessuserlist.md
- `DescribeAccountBindDeviceNum` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountbinddevicenum.md
- `DescribeAccountBindDevices` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountbinddevices.md
- `DescribeAccountDirectResources` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountdirectresources.md
- `DescribeAccountGroup` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountgroup.md
- `DescribeAccountGroupDomainTree` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountgroupdomaintree.md
- `DescribeAccountGroupResources` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountgroupresources.md
- `DescribeAccountGroups` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountgroups.md
- `DescribeAccountGroupsUserTotal` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountgroupsusertotal.md
- `DescribeAccountInheritedResources` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountinheritedresources.md
- `DescribeAccountLicenseUsageTimeHistogram` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountlicenseusagetimehistogram.md
- `DescribeAccountLogInInfo` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountlogininfo.md
- `DescribeAccountsByIds` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountsbyids.md
- `DescribeAccountSecurityPolicy` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountsecuritypolicy.md
- `DescribeAccountVirtualGroupResources` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountvirtualgroupresources.md
- `DescribeAccountVirtualGroups` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaccountvirtualgroups.md
- `DescribeAdminDomainDetail` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeadmindomaindetail.md
- `DescribeAdminDomainList` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeadmindomainlist.md
- `DescribeAggrSoftCategorySoftList` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaggrsoftcategorysoftlist.md
- `DescribeAggrSoftDetail` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaggrsoftdetail.md
- `DescribeAggrSoftDeviceList` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaggrsoftdevicelist.md
- `DescribeAggSoftDeviceAll` — Read — https://policylayer.com/tools/ioacloud-ioacloud-mcp/describeaggsoftdeviceall.md
- …and 475 more: https://policylayer.com/tools/ioacloud-ioacloud-mcp.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=ioacloud-ioacloud-mcp · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/ioacloud-ioacloud-mcp