文档首页/ DDoS防护 AAD/ API参考/ DDoS原生高级防护API/ DDoS原生高级防护-防护对象管理/ 查询防护对象列表
更新时间：2025-06-09 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询防护对象列表

功能介绍

查询防护对象列表

调用方法

请参见如何调用API。

URI

GET /v1/cnad/protected-ips

表1 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

开始查询的偏移量,默认值:0

limit

否

Integer

每页显示的条目数量,默认值:2000

package_id

否

String

实例id

policy_id

否

String

策略id

ip

否

String

防护ip

tag

否

String

本地标签

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

Content-Type

是

String

Content-Type

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

total

Integer

总数

ips

Array of ProtectedIpResponse objects

防护ip列表
表4 ProtectedIpResponse

参数

参数类型

描述

id

String

防护IP的Id

ip

String

防护IP

type

String

类型。VPN：VPN；NAT：NAT；VIP：VIP；CCI：CCI；EIP：弹性公网IP；ELB：弹性负载均衡；REROUTING_IP：REROUTING_IP；SubEni：SubEni；NetInterFace：NetInterFace；

name

String

名字

status

Integer

状态：0 - 正常， 1 - 清洗中， 2 - 黑洞中

status_detail

IpStatusDetail object

封堵信息

policy_name

String

策略名

region

String

所属region

package_id

String

实例id

package_name

String

实例名

tags

String

TMS标签

tag

String

本地标签

is_resale

Boolean

默认false，表示是否转售版的IP，不需要展示策略和报表

package_version

String

package_version。cnad_pro：全力防基础版；cnad_ip：标准版；cnad_full_high：全力防高级版；cnad_v2：原生防护2.0；cnad_vic：按需版
表5 IpStatusDetail

参数

参数类型

描述

block_time

Long

封堵时间

unblock_time

Long

解封时间

请求示例

无

响应示例

状态码：200

OK

{
  "items" : [ {
    "id" : "7f0e3af2-455a-4a47-b95c-49137794f0c5",
    "ip" : "100.85.222.60",
    "is_resale" : false,
    "package_id" : "17f8f630-0714-4b3a-aedf-3983d7b98124",
    "package_name" : "kxnkxn99",
    "package_version" : "cnad_ip",
    "policy_name" : "tesy",
    "region" : "cn-north-7",
    "status" : 0,
    "type" : "EIP"
  } ],
  "total" : 1
}

状态码

状态码

描述

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。

父主题： DDoS原生高级防护-防护对象管理

相关文档