文档首页/ 企业主机安全 HSS/ API参考（联盟区域）/ API说明/ 网页防篡改/ 查询防护列表
更新时间：2026-01-08 GMT+08:00
查看PDF
分享

查询防护列表

功能介绍

查询防护列表：查询网页防篡改主机防护状态列表信息

URI

GET /v5/{project_id}/webtamper/hosts

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID
表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

否

String

企业项目ID

host_name

否

String

服务器名称

host_id

否

String

主机ID

public_ip

否

String

弹性公网IP

private_ip

否

String

私有IP

group_name

否

String

服务器组名称

os_type

否

String

操作系统类别（linux，windows）

  • linux : linux操作系统

  • windows : windows操作系统

protect_status

否

String

防护状态

  • closed : 未开启

  • opened : 防护中

agent_status

否

String

客户端状态

  • not_installed : agent未安装

  • online : agent在线

  • offline : agent不在线

limit

否

Integer

默认10

offset

否

Integer

偏移量：指定返回记录的开始位置

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

region

是

String

Region Id

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

data_list

Array of WtpProtectHostResponseInfo objects

data list

total_num

Integer

total number of WTP protected servers
表5 WtpProtectHostResponseInfo

参数

参数类型

描述

host_name

String

服务器名称

host_id

String

主机ID

public_ip

String

弹性公网IP

private_ip

String

私有IP

ipv6

String

私有IPv6地址

group_name

String

服务器组名称

os_bit

String

操作系统位数

os_type

String

操作系统（linux，windows）

protect_status

String

防护状态

  • closed : 未开启

  • opened : 防护中

rasp_protect_status

String

动态网页防篡改状态

  • closed : 未开启

  • opened : 防护中

anti_tampering_times

Long

已防御篡改攻击次数

detect_tampering_times

Long

已发现篡改攻击

last_detect_time

Long

最近检测时间(ms)

scheduled_shutdown_status

String

定时关闭防护开关状态

  • opened : 开启

  • closed : 未开启

agent_status

String

Agent状态

  • not_installed : agent未安装

  • online : agent在线

  • offline : agent不在线

请求示例

查询防护状态为开启，企业项目ID为XX的网页防篡改主机防护状态列表信息，默认查询第一页10条

GET https://{endpoint}/v5/{project_id}/webtamper/hosts?offset=XX&limit=XX&protect_status=opened&enterprise_project_id=XX

{
  "protect_status" : "opened"
}

响应示例

状态码：200

请求已成功

{
  "total_num" : 1,
  "data_list" : [ {
    "host_name" : "test",
    "host_id" : "000411f9-42a7-4acd-80e6-f7b9d3db895f",
    "public_ip" : "",
    "private_ip" : "192.168.0.70,fe80::f816:3eff:fed4:c4d7",
    "ipv6" : "fe80::f816:3eff:fed4:c4d7",
    "group_name" : "testGroup",
    "os_bit" : "64",
    "os_type" : "Linux",
    "protect_status" : "opened",
    "rasp_protect_status" : "opened",
    "anti_tampering_times" : 0,
    "detect_tampering_times" : 0,
    "last_detect_time" : 0,
    "agent_status" : "online"
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码。

父主题： 网页防篡改