查询主机账号列表

最近更新时间: 2026-07-13 00:07:50

1. 接口描述

接口请求域名： bhsaas.api3.fincloud.tencent.com。

查询主机账号列表

默认接口请求频率限制：20次/秒。

接口更新时间：2023-09-05 03:34:56。

接口既验签名又鉴权。

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeDeviceAccounts
Version	是	否	String	公共参数，本接口取值：2019-10-18
Region	是	否	String	公共参数，地域信息本接口不需要传递此参数。
IdSet	否	否	Array of Uint64	主机账号ID集合，非必需，如果使用IdSet则忽略其他过滤参数示例值： [1,2]
Account	否	否	String	主机账号名，模糊查询，不能单独出现，必须于DeviceId一起提交示例值： root
DeviceId	否	否	Uint64	主机ID，未使用IdSet时必须携带示例值： 1
Offset	否	否	Uint64	分页偏移位置，默认值为0 示例值： 0
Limit	否	否	Uint64	每页条目数量，默认20 示例值： 10

参数名称	类型	描述
TotalCount	Uint64	记录总数示例值： 20
DeviceAccountSet	Array of DeviceAccount	账号信息列表示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。