查询应用使用记录
功能介绍
查询应用使用记录。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/{project_id}/session/app-connection
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
limit |
否 |
Integer |
单次查询的大小[1-100]。 |
offset |
否 |
Integer |
查询的偏移量。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
String |
主键。 |
sid |
否 |
String |
应用服务器sid。 |
machine_name |
否 |
String |
应用服务器名称。 |
user_name |
否 |
String |
登录用户,模糊查询。 |
app_group_name |
否 |
String |
应用组名称。 |
app_group_id |
否 |
String |
应用组id。 |
app_name |
否 |
String |
应用名称,模糊查询。 |
failed_code |
否 |
String |
连接失败状态码。 |
connection_failure_reason |
否 |
String |
连接失败原因。 |
client_name |
否 |
String |
客户端名称。 |
client_version |
否 |
String |
客户端版本。 |
client_type |
否 |
String |
客户端操作系统类型。 |
agent_version |
否 |
String |
aps hda版本。 |
vm_ip |
否 |
String |
应用服务器ip。 |
wi_ip |
否 |
String |
连接IP。 |
public_ip |
否 |
String |
客户端出口ip。 |
tenant_id |
否 |
String |
租户id。 |
brokering_start_time |
否 |
String |
登录应用开始时间,格式 2022-10-31 08:07:39。 |
brokering_end_time |
否 |
String |
登录应用结束时间,格式 2022-10-31 08:07:39。 |
virtual_ip |
否 |
String |
会话虚拟ip。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
count |
Integer |
总数。 |
items |
Array of AppConnectionInfo objects |
应用使用记录列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
应用连接唯一标识ID。 |
sid |
String |
应用服务器sid。 |
machine_name |
String |
应用服务器名称。 |
user_name |
String |
登录用户。 |
app_group_name |
String |
应用组名称。 |
app_group_id |
String |
应用组ID。 |
app_name |
String |
应用名称。 |
brokering_time |
String |
登录应用时间。 |
failed_code |
String |
连接失败状态码。 |
connection_failure_reason |
String |
连接失败原因。 |
client_mac |
String |
客户端Mac。 |
client_name |
String |
客户端名称。 |
client_ip |
String |
客户端ip。 |
client_version |
String |
客户端版本。 |
client_type |
String |
客户端操作系统类型。 |
agent_version |
String |
aps hda版本。 |
vm_ip |
String |
应用服务器ip。 |
wi_ip |
String |
连接IP。 |
tenant_id |
String |
租户id。 |
virtual_ip |
String |
会话虚拟ip。 |
public_ip |
String |
客户端出口ip。 |
transaction_id |
String |
事务id。 |
end_time |
String |
登录应用结束时间。 |
aps_instance_id |
String |
aps服务器ID。 |
aps_instance_name |
String |
aps服务器名称。 |
aps_host_id |
String |
wdh专属主机ID。 |
primary_server_group_id |
String |
主服务器组ID。 |
secondary_server_group_id |
String |
主服务器组ID。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码: 405
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码: 415
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
状态码: 503
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
请求示例
POST /v1/a4da8115c9d8464ead3a38309130523f/session/app-connection?limit=10&offset=0
响应示例
状态码: 200
成功响应。
{ "count" : 2, "items" : [ { "id" : "5af4a8c1047411ee9f75fa163e289e5a", "sid" : "S-1-5-21-1213649063-4191095369-2401105760-1418", "machine_name" : "APS-XS1QJ3TA7T", "user_name" : "user001@wksapp***.huawei.com", "app_group_name" : "云存储", "app_group_id" : "573743978327834675", "app_name" : "云存储-Notepad++", "brokering_time" : "2023-06-06T14:13:48Z", "failed_code" : "", "connection_failure_reason" : "", "client_mac" : "00-e0-***-58-08-33", "client_name" : "DESKTOP-KDB5TN1", "client_ip" : "10.*73.109.160", "client_version" : "23.5.0.0", "client_type" : "Windows 10", "agent_version" : "23.5.0.0529", "vm_ip" : "10.*.248.130", "wi_ip" : "192.**.10.*00\\#192.**.10.23", "tenant_id" : "a4da8115c9d8464ead3a38309130523f", "virtual_ip" : "" }, { "id" : "b5442cb1047211ee9f75fa163e289e5a", "sid" : "S-1-5-21-1213649063-4191095369-2401105760-1418", "machine_name" : "APS-XS1QJ3TA7T", "user_name" : "user001@wksapp***.huawei.com", "app_group_name" : "云存储", "app_group_id" : "573743978327834675", "app_name" : "云存储-Notepad++", "brokering_time" : "2023-06-06T14:02:00Z", "failed_code" : "", "connection_failure_reason" : "", "client_mac" : "00-e0-**-58-08-33", "client_name" : "DESKTOP-KDB5TN1", "client_ip" : "10.*73.109.160", "client_version" : "23.5.0.0", "client_type" : "Windows 10", "agent_version" : "23.5.0.0529", "vm_ip" : "10.*.248.130", "wi_ip" : "192.**.10.*00\\#192.**.10.23", "tenant_id" : "a4da8115c9d8464ead3a38309130523f", "virtual_ip" : "" } ] }
状态码
状态码 |
描述 |
---|---|
200 |
成功响应。 |
400 |
由于包含语法错误,当前请求无法被服务器理解。 |
401 |
鉴权失败。 |
403 |
没有操作权限。 |
404 |
找不到资源。 |
405 |
请求中指定的方法不被允许。 |
415 |
请求中提交的资源格式不支持。 |
500 |
服务内部错误,具体返回错误码请参见错误码说明。 |
503 |
服务不可用。 |
错误码
请参见错误码。