获取账户变动历史信息
功能介绍
获取账户变动历史记录信息
调用方法
请参见如何调用API。
URI
GET /v5/{project_id}/asset/user/change-history
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID 最小长度:1 最大长度:256 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
user_name |
否 |
String |
账号名 最小长度:1 最大长度:128 |
host_id |
否 |
String |
主机id 最小长度:1 最大长度:128 |
root_permission |
否 |
Boolean |
是否有root权限 |
host_name |
否 |
String |
主机名称 最小长度:1 最大长度:128 |
private_ip |
否 |
String |
服务器私有IP 最小长度:1 最大长度:128 |
change_type |
否 |
String |
账号变更类型:
最小长度:1 最大长度:128 |
limit |
否 |
Integer |
每页显示数量 最小值:10 最大值:100 缺省值:10 |
offset |
否 |
Integer |
偏移量:指定返回记录的开始位置 最小值:0 最大值:10000 缺省值:0 |
enterprise_project_id |
否 |
String |
企业项目ID,查询所有企业项目时填写:all_granted_eps 最小长度:1 最大长度:256 |
start_time |
否 |
Long |
变更开始时间,13位时间戳 最小值:0 最大值:4070880000000 |
end_time |
否 |
Long |
变更结束时间,13位时间戳 最小值:0 最大值:4070880000000 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) 最小长度:32 最大长度:4096 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
total_num |
Integer |
账号变动总数 最小值:0 最大值:10000000 |
data_list |
Array of UserChangeHistoryResponseInfo objects |
账号历史变动记录列表 数组长度:0 - 200 |
参数 |
参数类型 |
描述 |
---|---|---|
agent_id |
String |
Agent ID 最小长度:1 最大长度:128 |
change_type |
String |
变更类型
最小长度:1 最大长度:128 |
host_id |
String |
主机ID 最小长度:1 最大长度:128 |
host_name |
String |
服务器名称 最小长度:1 最大长度:128 |
private_ip |
String |
服务器私有IP 最小长度:1 最大长度:128 |
login_permission |
Boolean |
是否有登录权限 |
root_permission |
Boolean |
是否有root权限 |
user_group_name |
String |
用户组 最小长度:1 最大长度:128 |
user_home_dir |
String |
用户目录 最小长度:1 最大长度:128 |
shell |
String |
用户启动shell 最小长度:1 最大长度:128 |
user_name |
String |
账号名称 最小长度:1 最大长度:128 |
expire_time |
Long |
到期时间,采用时间戳,默认毫秒, 最小值:0 最大值:4070880000000 |
recent_scan_time |
Long |
账号增加、修改、删除等操作的变更时间 最小值:0 最大值:4070880000000 |
请求示例
默认查询前10条开始时间为1700446129130,结束时间为1701050929130的账户变动历史记录信息
GET https://{endpoint}/v5/{project_id}/asset/user/change-history?start_time=1700446129130&end_time=1701050929130
响应示例
状态码: 200
账号历史变动记录列表
{ "total_num" : 1, "data_list" : [ { "agent_id" : "0bf792d910xxxxxxxxxxx52cb7e63exxx", "host_id" : "13xxxxxxxece69", "private_ip" : "192.168.0.1", "host_name" : "test", "user_home_dir" : "/test", "login_permission" : false, "recent_scan_time" : 1667039707730, "expire_time" : 1667039707730, "root_permission" : false, "shell" : "/sbin/nologin", "user_group_name" : "bin", "user_name" : "bin", "change_type" : "ADD" } ] }
状态码
状态码 |
描述 |
---|---|
200 |
账号历史变动记录列表 |
错误码
请参见错误码。