创建流量规则
接口功能介绍
创建流量规则
接口约束
需要预先创建流量策略，在对应的流量策略下创建流量规则
URI
POST /v4/ec/traffic-rule/create
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| policyID | 是 | String | 流量策略ID | 55450584-fe8f-49b0-9e09-ef915caeee10 | |
| ruleName | 是 | String | 流量规则名字 | rule-23idc4 | |
| ipProtocol | 是 | Integer | 协议类型，取值如下： 0:"全部协议" 1:"ICMP" 2:"IGMP" 6:"TCP" 17:"UDP" |
6 | |
| ruleDescription | 否 | String | 描述信息 | test | |
| srcIpCidr | 否 | String | 流量报文源网段，ipv4，默认为匹配任意源IP地址（0.0.0.0/0） | 192.168.2.0/24 | |
| dstIpCidr | 否 | String | 流量报文目的网段，ipv4，默认为匹配任意目的IP地址（0.0.0.0/0） | 192.168.1.0/24 | |
| srcPort | 否 | String | 流量报文源端口，默认值-1/-1（代表匹配任意源端口） 取值范围：-1、1-65535 输入格式说明如下： 1/200：代表源端口范围1至200 80/80：代表源端口80 -1/-1：代表匹配任意源端口 -1不支持单独设置，仅支持设置为-1/-1 |
1/200 | |
| dstPort | 否 | String | 流量报文目的端口，默认值-1/-1（代表匹配任意目的端口） 取值范围：-1、1-65535 输入格式说明如下： 1/200：代表源端口范围1至200 80/80：代表源端口80 -1/-1：代表匹配任意源端口 -1不支持单独设置，仅支持设置为-1/-1 |
1/200 |
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 否 | Integer | 返回状态码 取值范围: 800:成功 900:失败 |
800 | |
| errorCode | 否 | String | 业务细分码，为product.module.code三段式码 | ||
| message | 否 | String | 失败时的错误描述，一般为英文描述 | ||
| description | 否 | String | 失败时的错误描述，一般为中文描述 | ||
| traceID | 否 | String | 链路追踪ID | 74cb2e66-1f95-45da-aac5-ee013470fd96 | |
| returnObj | 否 | Object | 返回参数 | returnObj |
表returnObj
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| ruleID | 否 | String | 流量规则ID | 55450584-fe8f-49b0-9e09-ef915caeee10 | |
| result | 否 | String | 更新结果 | create success |
请求示例
请求url
无
请求头header
无
请求体body
{
"policyID": "55450584-fe8f-49b0-9e09-ef915caeee10",
"ruleName": "rule-23idc4",
"ipProtocol": 6,
"ruleDescription": "test",
"srcIpCidr": "192.168.2.0/24",
"dstIpCidr": "192.168.1.0/24",
"srcPort": "1/200",
"dstPort": "1/200"
}
响应示例
{
"description":"",
"errorCode":"",
"message":"",
"statusCode":800,
"traceID":"bc9a70eb-28d7-4032-9510-1bea00192f34",
"returnObj":{
"ruleID": "55450584-fe8f-49b0-9e09-ef915caeee10",
"result": "create success"
}
}
状态码
| 状态码 | 含义 |
|---|---|
| 200 | 请求成功 |
错误码
| errorCode | 含义 |
|---|---|
| Openapi.PatternCheck.NotValid | 请求参数无效 |
| Openapi.TrafficRuleEc.CreateError | 内部错误，请重试。如果多次尝试失败，请提交工单 |
