文档首页/ 企业主机安全 HSS/ API参考（吉隆坡区域）/ API说明/ 网页防篡改/ 查询防护列表
更新时间：2025-09-23 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询防护列表

功能介绍

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

URI

GET /v5/{project_id}/webtamper/hosts

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户ID
表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

否

String

企业项目

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

默认是0

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

IAM token

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

data_list

Array of WtpProtectHostResponseInfo objects

data list

total_num

Integer

total number
表5 WtpProtectHostResponseInfo

参数

参数类型

描述

host_name

String

服务器名称

host_id

String

云服务器ID

public_ip

String

弹性公网IP

private_ip

String

私有IP

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

最近检测时间

scheduled_shutdown_status

String

定时关闭防护开关状态

  • opened : 开启

  • closed : 未开启

agent_status

String

Agent状态

  • not_installed : agent未安装

  • online : agent在线

  • offline : agent不在线

请求示例

查询防护状态为开启，企业项目为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

OK

{
  "total_num" : 1,
  "data_list" : [ {
    "host_name" : "test",
    "host_id" : "000411f9-42a7-4acd-80e6-f7b9d3db895f",
    "public_ip" : "",
    "private_ip" : "192.168.0.70",
    "group_name" : "UNINSTALL",
    "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" : "not_installed"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 网页防篡改