调用ConfigLayer4RulePolicy为端口转发规则设置主、备源站IP地址。

调试

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

请求参数

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

要执行的操作。取值:ConfigLayer4RulePolicy

Listeners String [{\"InstanceId\":\"ddosDip-sg-4hr2b3l****\",\"Protocol\":\"udp\",\"FrontendPort\":2020,\"BackendPort\":2022,\"PriRealServers\":[{\"RealServer\":\"192.0.2.1\"},{\"RealServer\":\"192.0.2.2\"}],\"SecRealServers\":[{\"RealServer\":\"192.0.2.3\"},{\"RealServer\":\"192.0.2.4\"}],\"CurrentRsIndex\":1}]

设置端口转发规则。

该参数使用JSON数组转换的字符串表示。JSON数组的每个元素表示一个已创建的端口转发规则。一次最多可以设置1个端口转发规则。

说明 您可以调用DescribeNetworkRules查询所有已创建的端口转发规则。

每个端口转发规则包含以下字段:

  • InstanceId:String类型,必选,DDoS高防实例的ID。
  • Protocol:String类型,必选,转发协议类型。取值:tcpudp
  • FrontendPort:Integer类型,必选,转发端口。
  • BackendPort:Integer类型,必选,源站端口。
  • PriRealServers:JSON数组类型,必选,主源站IP地址列表。JSON数组的每个元素表示一个主源站IP地址。最多支持设置20个主源站IP地址。

    每个主源站IP地址包含以下字段:

    • RealServer:String类型,必选,主源站IP地址。
  • SecRealServers:JSON数组类型,必选,备源站IP地址列表。JSON数组的每个元素表示一个备源站IP地址。最多支持设置20个备源站IP地址。

    每个备源站IP地址包含以下字段:

    • RealServer:String类型,必选,备源站IP地址。
  • CurrentRsIndex:Integer类型,必选,要生效的源站类型。取值:
    • 1:表示主源站设置生效(DDoS高防将业务流量转发到主源站IP地址)。
    • 2:表示备源站设置生效(DDoS高防将业务流量转发到备源站IP地址)。
RegionId String cn-hangzhou

DDoS高防实例所属地域ID。取值:

  • cn-hangzhou(默认):表示中国内地,即DDoS高防(新BGP)实例。
  • ap-southeast-1:表示非中国内地,即DDoS高防(国际)实例。

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
RequestId String CC042262-15A3-4A49-ADF0-130968EA47BC

本次请求的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ConfigLayer4RulePolicy
&Listeners=[{\"InstanceId\":\"ddosDip-sg-4hr2b3l****\",\"Protocol\":\"udp\",\"FrontendPort\":2020,\"BackendPort\":2022,\"PriRealServers\":[{\"RealServer\":\"192.0.2.1\"},{\"RealServer\":\"192.0.2.2\"}],\"SecRealServers\":[{\"RealServer\":\"192.0.2.3\"},{\"RealServer\":\"192.0.2.4\"}],\"CurrentRsIndex\":1}]
&<公共请求参数>

正常返回示例

XML格式

<ConfigLayer4RulePolicyResponse>
	  <RequestId>CC042262-15A3-4A49-ADF0-130968EA47BC</RequestId>
</ConfigLayer4RulePolicyResponse>

JSON格式

{
    "RequestId": "CC042262-15A3-4A49-ADF0-130968EA47BC"
}

错误码

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