获取账号列表

最近更新时间: 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 - 是否必填:否 - 主机ip
  • MachineName - String - 是否必填:否 - 主机名称
  • InstanceID - string - 是否必填:否 - 实例ID
  • Name - String - 是否必填:否 - 账户名(模糊匹配)
  • NameStrict - String - 是否必填:否 - 账户名(严格匹配)
  • Uid - uint64 - 是否必填:否 - Uid
  • Gid - uint64 - 是否必填:否 - Gid
  • LoginTimeStart - String - 是否必填:否 - 开始时间,如:2021-01-11
  • LoginTimeEnd - String - 是否必填:否 - 结束时间,如:2021-01-11
  • LoginType - uint64 - 是否必填:否 - 0-不可登录;1-只允许key登录;2只允许密码登录;3-允许key和密码 仅linux
  • OsType - String - 是否必填:否 - windows或linux
  • Status - uint64 - 是否必填:否 - 账号状态:0-禁用;1-启用
  • UserType - uint64 - 是否必填:否 - 账号类型:0访客用户,1标准用户,2管理员用户 仅windows
  • IsDomain - uint64 - 是否必填:否 - 是否域账号:0 不是,1是 仅windows
  • IsRoot - uint64 - 是否必填:否 - 是否Root权限:0 不是,1是 仅linux
  • IsSudo - uint64 - 是否必填:否 - 是否Sudo权限:0 不是,1是 仅linux
  • IsSshLogin - uint64 - 是否必填:否 - 是否ssh登录:0 不是,1是 仅linux
  • ShellLoginStatus - uint64 - 是否必填:否 - 是否shell登录性,0不是;1是 仅linux
  • PasswordStatus - uint64 - 是否必填:否 - 密码状态:1正常 2即将过期 3已过期 4已锁定 仅linux
  • OsName -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 参数取值错误。