调用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防护策略的空连接,取值:offon

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防护策略的虚假源,取值:offon

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"
}

错误码

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