查询应用使用记录
功能介绍
查询应用使用记录。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v1/{project_id}/session/app-connection
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
limit |
否 |
Integer |
单次查询的大小[1-100]，默认值10。 |
|
offset |
否 |
Integer |
查询的偏移量，默认值0。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
服务不可用。 |
错误码
请参见错误码。
