文档首页> Web应用防火墙 WAF> API参考 (巴黎) > API说明> 云模式> WAF防护域名> 查询防护域名
更新时间：2022-12-29 GMT+08:00
查看PDF

查询防护域名

功能介绍

查询某个防护域名的详细信息。

URI

  • URI格式

    GET /v1/{project_id}/waf/instance/{instance_id}

  • 参数说明
    表1 Path参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    是

    String

    用户操作的项目ID。

    instance_id

    是

    String

    防护实例ID。

请求消息

请求参数

无

响应消息

响应参数
表2 响应参数说明

名称

参数类型

说明

id

String

防护实例的ID。

hostname

String

域名。

cname

String

CNAME的值，例如：efec1196267b41c399f2980ea4048517.waf.cloud.com。

txt_code

String

TXT记录。当“proxy”为“true”时，才会返回“txt_code”。

sub_domain

String

子域名。当“proxy”为“true”时，才返回“sub_domain”。

policy_id

String

policy的ID。

protect_status

Integer

防护状态。

  • “0”：表示关闭。
  • “1”：表示开启。
  • “-1”：表示bypass。

access_status

Integer

接入状态。

  • “0”：表示未接入。
  • “1”：表示已接入。

protocol

String

协议类型，取值范围为：“HTTP”，“HTTPS”和“HTTP,HTTPS”。

certificate_id

String

证书ID，只有当“client_protocol”为“HTTPS”时，才会返回该值。

server

Array

源站信息列表，包含“client_protocol”、“server_protocol”、“address”、“port”四个字段。

  • “client_protocol”：客户端协议类型。包括HTTP、HTTPS两种协议类型，例如：HTTPS。
  • “server_protocol”：服务器协议类型，WAF转发客户端请求的协议。包括HTTP、HTTPS两种协议类型，例如：HTTP。
  • “address”：客户端访问的网站服务器的公网IP地址或域名。
  • “port”：客户端访问的网站服务器的端口号，取值为(0, 65535)，例如：8080。

proxy

Boolean

是否使用代理。

  • false：表示没有使用代理。
  • true：表示使用了代理。

sip_header_name

String

获取真实源IP的http请求头的类别。当“proxy”为“true”时，才会返回该值。

取值范围为：“default”，“cloudflare”，“akamai”，“custom”。

sip_header_list

Array

获取真实源IP的http请求头。当“proxy”为“true”时，才会返回该值。

  • 当“sip_header_name”为“default”时，“sip_header_list”为["X-Forwarded-For"]；
  • 当“sip_header_name”为“cloudflare”时，“sip_header_list”为["CF-Connecting-IP", "X-Forwarded-For"]；
  • 当“sip_header_name”为“akamai”时，“sip_header_list”为["True-Client-IP"]；
  • 当“sip_header_name”为“custom”时，用户可以自定义。

timestamp

Long

创建防护域名的时间。

block_page

BlockPage object

告警页面配置
表3 BlockPage

参数

参数类型

描述

template

String

模板名称

custom_page

CustomPage object

自定义告警页面

redirect_url

String

页面URL
表4 CustomPage

参数

参数类型

描述

status_code

String

返回状态码

content_type

String

“自定义”告警页面内容类型，可选择text/html、text/xml和application/json三种类型

content

String

根据选择的“content_type”配置对应的页面内容。

示例

如下以查询防护域名www.a.com为例。

响应样例 
{
          "id": "388a7789d55b41d1918b3088a8f1e7f3",
          "hostname": "www.a.com",
          
          "cname": "3249d21e5eb34d21be12fdc817fcb67d.waf.cloud.com",
          "txt_code": "3249d21e5eb34d21be12fdc817fcb67d",
          "sub_domain": "3249d21e5eb34d21be12fdc817fcb67d.www.a.com",
          "policy_id": "xxxxxxxxxxxxxx",
          "certificate_id": "xxxxxxxxxxxxxxxxxxx",
          "protect_status": 0,
          "access_status": 0,
          "protocol": "HTTP,HTTPS",

          "server": [
             {"client_protocol": "HTTPS", "server_protocol":"HTTP", "address":"X.X.X.X.", "port":443},
             {"client_protocol": "HTTP", "server_protocol":"HTTP", "address":"X.X.X.X", "port":80}
          ],
         "proxy": true,
         "sip_header_name": "default",
         "sip_header_list": ["X-Forwarded-For"],
         "timestamp": 1499817600
         "block_page" : { 
         "template" : "default"
          },
         
         
}

状态码

表5描述的是API返回的正常状态码。
表5 状态码

状态码

编码

状态说明

200

OK

客户端请求已处理成功。

异常状态码，请参见状态码。

父主题： WAF防护域名