获取账号列表
最近更新时间: 2026-04-10 00:04:30
1. 接口描述
接口请求域名: cwp.api3.fincloud.tencent.cn。
获取账号列表
默认接口请求频率限制:20次/秒。
接口更新时间:2022-09-28 15:55:30。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数。
| 参数名称 |
必选 |
允许NULL |
类型 |
描述 |
| Action |
是 |
否 |
String |
公共参数,本接口取值:DescribeAssetUserList |
| Version |
是 |
否 |
String |
公共参数,本接口取值:2018-02-28 |
| Region |
是 |
否 |
String |
公共参数,地域信息本接口不需要传递此参数。 |
| By |
否 |
否 |
String |
可选排序:[FirstTime |
| Filters |
否 |
否 |
Array of Filter |
过滤条件。 IP - String - 是否必填:否 - 主机ipMachineName - String - 是否必填:否 - 主机名称InstanceID - string - 是否必填:否 - 实例IDName - String - 是否必填:否 - 账户名(模糊匹配)NameStrict - String - 是否必填:否 - 账户名(严格匹配)Uid - uint64 - 是否必填:否 - UidGid - uint64 - 是否必填:否 - GidLoginTimeStart - String - 是否必填:否 - 开始时间,如:2021-01-11LoginTimeEnd - String - 是否必填:否 - 结束时间,如:2021-01-11LoginType - uint64 - 是否必填:否 - 0-不可登录;1-只允许key登录;2只允许密码登录;3-允许key和密码 仅linuxOsType - String - 是否必填:否 - windows或linuxStatus - uint64 - 是否必填:否 - 账号状态:0-禁用;1-启用UserType - uint64 - 是否必填:否 - 账号类型:0访客用户,1标准用户,2管理员用户 仅windowsIsDomain - uint64 - 是否必填:否 - 是否域账号:0 不是,1是 仅windowsIsRoot - uint64 - 是否必填:否 - 是否Root权限:0 不是,1是 仅linuxIsSudo - uint64 - 是否必填:否 - 是否Sudo权限:0 不是,1是 仅linuxIsSshLogin - uint64 - 是否必填:否 - 是否ssh登录:0 不是,1是 仅linuxShellLoginStatus - uint64 - 是否必填:否 - 是否shell登录性,0不是;1是 仅linuxPasswordStatus - uint64 - 是否必填:否 - 密码状态:1正常 2即将过期 3已过期 4已锁定 仅linuxOsName -String 是否必填: 否 - 操作系统( DescribeMachineOsList 接口 值 ) 示例值:查看 |
| Limit |
否 |
否 |
Uint64 |
需要返回的数量,默认为10,最大值为100 示例值: 1 |
| Offset |
否 |
否 |
Uint64 |
偏移量,默认为0。 示例值: 1 |
| Order |
否 |
否 |
String |
排序方式,asc升序 或 desc降序 示例值: asc |
| Quuid |
否 |
否 |
String |
查询指定Quuid主机的信息 示例值: 1 |
3. 输出参数
| 参数名称 |
类型 |
描述 |
| Total |
Uint64 |
记录总数 示例值: 1 |
| Users |
Array of AssetUserBaseInfo |
账号列表 示例值:查看 |
| RequestId |
String |
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码。
| 错误码 |
描述 |
| InternalError |
内部错误。 |
| InvalidParameter.ParsingError |
参数解析错误。 |
| InvalidParameter.DateRange |
时间区间格式错误。 |
| InvalidParameter |
参数错误。 |
| InvalidParameterValue |
参数取值错误。 |