获取用户信息
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | GetFingerprintUser | 要执行的操作,取值:GetFingerprintUser。 |
Version | String | 是 | 2024-05-08 | API的版本,取值:2024-05-08。 |
AgentId | String | 否 | KnTSF | 主机ID |
SortOrder | String | 否 | NeCht | 排序顺序
|
LeafGroupIDs | Array of String | 否 | [XigZL gzulw kMfoN] | 叶子分组ID列表 |
TopGroupID | String | 否 | VAdOE | 根分组ID |
CloudProviders | Array of String | 否 | [mnSQg NVdNS EIdSS] | 云厂商 |
PageNumber | Long | 是 | 81 | 翻页页码 |
Ip | String | 否 | YSvwf | IP |
PageSize | Long | 是 | 63 | 每页的大小 |
SortBy | String | 否 | TuUBt | 排序字段 |
Tags | Array of String | 否 | [AKYHj JKyUS dHWAb] | 主机TAG |
GroupName | String | 否 | wdQEG | GroupName |
Hostname | String | 否 | lRvSw | 主机名称 |
LastLoginIP | String | 否 | pvcWE | LastLoginIP |
LastLoginTimeEnd | Long | 否 | 9 | LastLoginTimeEnd |
LastLoginTimeStart | Long | 否 | 24 | LastLoginTimeStart |
Username | String | 否 | xyzIV | Username |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
TotalCount | Long | 68 | 全部数据条数 |
PageNumber | Long | 34 | 当前页面 |
PageSize | Long | 1 | 页面大小 |
Data | Array of Object | -- | Data |
POST /?Action=GetFingerprintUser&Version=2024-05-08HTTP/1.1 Host: seccenter.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20241120T080538Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241120/cn-beijing/seccenter/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "AgentId": "kYGAP", "CloudProviders": [ "jfvqW", "digfx", "igFvb" ], "GroupName": "qsMgc", "Hostname": "XQpyq", "Ip": "JBreG", "LastLoginIP": "MTLpf", "LastLoginTimeEnd": 88, "LastLoginTimeStart": 92, "LeafGroupIDs": [ "lxJzC", "zSfNF", "isuwA" ], "PageNumber": 18, "PageSize": 3, "SortBy": "lXQVH", "SortOrder": "ucXaX", "Tags": [ "CGRqB", "ZPwYv", "evFMj" ], "TopGroupID": "Xffbg", "Username": "aKwdg" }
{ "ResponseMetadata": { "RequestId": "20241120165538010234567890", "Action": "GetFingerprintUser", "Version": "2024-05-08", "Service": "seccenter", "Region": "cn-beijing" }, "Result": { "Data": [ { "AgentID": "QCTHT", "AgentTags": [ "NFLIa", "KWRgK", "ytxJE" ], "EipAddress": "UXeJF", "Gid": "sIMUc", "GroupName": "rRMVF", "HomeDir": "HvsPU", "Hostname": "TsIgJ", "ID": "BvNiQ", "Info": "qzcbe", "LastLoginIP": "KbvbZ", "LastLoginTime": 22, "Password": "TKVfu", "PrimaryIpAddress": "VzWWJ", "Shell": "PzWie", "StartTime": 49, "Sudoers": "JAiDf", "Uid": "tDUPG", "UpdateTime": 21, "Username": "eiwGo" } ], "PageNumber": 47, "PageSize": 92, "TotalCount": 39 } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
|---|---|---|
400 | MissingParameter | 请求参数缺失 |
400 | InvalidParameter | 请求参数错误 |
400 | OperationDenied | 不允许的操作 |
500 | InternalError | 服务器内部错误 |
500 | DBOperateError | 数据库操作异常 |