调用DescribeLayer4RuleAttributes查询四层转发属性，包括会话保持和DDoS防护策略。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeLayer4RuleAttributes

要执行的操作。取值：DescribeLayer4RuleAttributes。

Listeners String 是 [{"InstanceId":"ddoscoo-cn-XXXXX","Protocol":"tcp","FrontendPort":80}]

传入要查询的Listener数组JSON串，每个Listener的具体结构描述如下：

  • InstanceId，String类型，必选，实例ID。
  • Protocol，String类型，必选，协议类型。
  • FrontendPort，Integer类型，必选，前端使用的端口，取值范围：0~65535。
  • BackendPort，Integer类型，可选，后端使用的端口，取值范围：0~65535。
  • RealServers，Json数组类型，可选，源站IP地址。
  • IsAutoCreate，Boolean类型，可选，是否自动创建。如果是，则不允许删除和修改。
SourceIp String 否 1.1.1.1

请求源IP。无需填写，系统自动获取。
RegionId String 否 cn-hangzhou

地域ID。

返回数据

名称 类型 示例值 描述
Listeners Array

Listener数组JSON串。
Config Struct

TCP配置。
Cc Struct

源连接配置。
Sblack Array

源连接IP黑名单配置。
Cnt Integer 5

新建连接次数，固定取值5。

During Integer 60

间隔时长。单位秒，固定取值60。

Expires Integer 1800

黑名单有效时长，单位秒，取值范围：60~604800。
Type Integer 1

IP黑名单配置类型，取值：

  • 1：表示源新建连接IP黑名单。
  • 2：表示源并发连接IP黑名单。
  • 3：表示源PPS连接IP黑名单。
  • 4：表示源带宽连接IP黑名单。
NodataConn String on

DDoS防护策略的空连接，取值：off、on。

PayloadLen Struct

包过滤配置。
Max Integer 2

DDoS防护策略/包长度过滤，包长度的最大值。
Min Integer 1

DDoS防护策略/包长度过滤，包长度的最小值。
PersistenceTimeout Integer 0

会话保持的超时时间，单位为秒。默认为0，表示关闭。

Sla Struct

目的限速配置。
Cps Integer 100

目的新建连接限速阈值，取值范围：100~100,000（个）。
CpsEnable Integer 0

是否开启目的新建连接限速，取值：

  • 0：关闭
  • 1：开启（默认）
Maxconn Integer 1000

目的并发连接限速阈值，取值范围：1,000~1,000,000（个）。
MaxconnEnable Integer 0

是否开启目的并发连接限速，取值：

  • 0：关闭
  • 1：开启（默认）
Slimit Struct

源限速配置。
Bps Long 0

源带宽限速，单位Byte/s，取值范围：1024~68435456。

说明 当参数值为0时，表示未开启源带宽限速。
Cps Integer 100

源新建连接限速阈值，取值范围：100~100,000。
CpsEnable Integer 0

是否开启源新建连接限速，取值：

  • 0：关闭
  • 1：开启（默认）
CpsMode Integer 2

源新建连接限速状态，取值：

  • 1：手动
  • 2：自动
Maxconn Integer 1000

源并发连接限速阈值，取值范围：1,000~1,000,000。
MaxconnEnable Integer 0

是否开启源并发连接限速，取值：

  • 0：关闭
  • 1：开启（默认）
Pps Long 0

源PPS限速，单位Packet/s，取值范围：1~100000。

说明 当参数值为0时，表示未开启源PPS限速。
Synproxy String on

DDoS防护策略的虚假源，取值：off、on。

FrontendPort Integer 233

前端使用的端口，范围：0~65535。
InstanceId String ddoscoo-cn-XXXXX

实例ID。
Protocol String tcp

协议类型。
RequestId String CF33B4C3-196E-4015-AADD-5CAD00057B80

本次请求的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeLayer4RuleAttributes
&Listeners=[{"InstanceId":"ddoscoo-cn-XXXXX","Protocol":"tcp","FrontendPort":80}]
&<公共请求参数>

正常返回示例

XML 格式 

<Listeners>
    <InstanceId>0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc</InstanceId>
    <Protocol>tcp</Protocol>
    <FrontendPort>80</FrontendPort>
    <Config>
        <Cc>
            <Sblack>
                <Type>1</Type>
                <Cnt>5</Cnt>
                <Expires>1800</Expires>
                <During>60</During>
            </Sblack>
        </Cc>
        <PersistenceTimeout>80</PersistenceTimeout>
        <Synproxy>off</Synproxy>
        <NodataConn>on</NodataConn>
        <Sla>
            <Cps>10</Cps>
            <Maxconn>10</Maxconn>
            <CpsEnable>1</CpsEnable>
            <MaxconnEnable>1</MaxconnEnable>
        </Sla>
        <Slimit>
            <bps>0</bps>
            <Cps>10</Cps>
            <Maxconn>10</Maxconn>
            <CpsEnable>1</CpsEnable>
            <MaxconnEnable>1</MaxconnEnable>
            <pps>0</pps>
        </Slimit>
        <PayloadLen>
            <Min>1</Min>
            <Max>2</Max>
        </PayloadLen>
    </Config>
</Listeners>
<RequestId>0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc</RequestId>

JSON 格式 

{
    "Listeners": [
        {
            "InstanceId": "0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc",
            "Protocol": "tcp",
            "FrontendPort": 80,
            "Config": {
                "Cc": {
                    "Sblack":[
                        {
                            "Type":1,
                            "Cnt":5,
                            "Expires":1800,
                            "During":60
                            }
                            ]
                            },
                "PersistenceTimeout": 80,
                "Synproxy": "off",
                "NodataConn": "on",
                "Sla": {
                    "Cps": 10,
                    "Maxconn": 10,
                    "CpsEnable": 1,
                    "MaxconnEnable": 1
                },
                "Slimit": {
                    "bps":0,
                    "Cps": 10,
                    "Maxconn": 10,
                    "CpsEnable": 1,
                    "MaxconnEnable": 1,
                    "pps":0
                },
                "PayloadLen": {
                    "Min": 1,
                    "Max": 2
                }
            }
        }
    ],
    "RequestId": "0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc"
}

错误码

访问错误中心查看更多错误码。