創建ACL規則v3
更新時間 2024-06-04 11:04:10
最近更新時間: 2024-06-04 11:04:10
分享文章
接口功能介紹
創建ACL規則
接口約束
無
URI
POST /v3/aclRule/create
路徑參數
無
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 資源池ID。 | d8bbd132b53a11e9b0e40242ac110002 |
請求參數
請求頭header參數
無
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| aclOid | 是 | String | 被添加規則所屬ACL ID | acl-ixpc4edyti2kx9c1q7dvy | |
| direction | 是 | String | 方向（ingress-入方向;egress-出方向） | ingress | |
| ruleList | 是 | Array of Objects | 規則列表，單次長度限制[1,20]，源/目的地址處于同一子網下的網絡ACL規則不生效 | ruleList | |
| aclRuleOid | 否 | String | ACL規則ID，相對位置是before或after時必填 | ||
| relativePosition | 否 | String | 所添加規則的相對位置（default-添加到最后，優先級最低;before-向前添加，優先級更高;after-向后添加，優先級更低），默認值為default |
表 ruleList
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| name | 是 | String | ACL規則名稱，只能包含英文字母、數字、下劃線、中劃線，長度限制1-16個字符 | 222 | |
| type | 是 | String | 類型（ipv4-IPv4;ipv6-IPv6） | ipv6 | |
| strategy | 是 | String | 策略（allow-允許；deny-拒絕） | deny | |
| protocol | 是 | String | 協議（tcp-TCP協議;udp-UDP協議;all-全部協議;icmpv4-ICMPv4協議;icmpv6-ICMPv6協議） | tcp | |
| sourceAddress | 否 | String | 此方向允許的源地址。當前支持形式：IP地址段。type為ipv4時，默認值為0.0.0.0/0；type為ipv6時，默認值為::/0，代表支持所有的IP地址 | null | |
| destinationAddress | 否 | String | 此方向允許的目的地址。當前支持形式：IP地址段。type為ipv4時，默認值為0.0.0.0/0；type為ipv6時，默認值為::/0，代表支持所有的IP地址 | null | |
| sourcePort | 否 | String | 源端口范圍，選擇TCP或UDP協議時必須填寫，取值范圍是1-65535的數字。 表示單個端口時，指定端口號。 表示某一范圍時，兩個數字以:分隔（例如，1:100）；若為空，則表示全部端口（1-65535） |
null | |
| destinationPort | 否 | String | 目的端口范圍，選擇TCP或UDP協議時必須填寫，取值范圍是1-65535的數字。 表示單個端口時，指定端口號。 表示某一范圍時，兩個數字以:分隔（例如，1:100）；若為空，則表示全部端口（1-65535） |
null | |
| description | 是 | String | 描述，字符數限制[0,100] | decs-zYUV7w6E |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 狀態碼。可能值： - 800：請求成功。 - 900：請求失敗。 |
800 | |
| error | String | 錯誤碼。 | ||
| message | String | 提示信息。 | OK. | |
| returnObj | Object | 返回數據結構體。 | { } | returnObj |
枚舉參數
無
請求示例
請求url
無
請求頭header
無
請求體body
{"aclOid":"acl-xxx","direction":"ingress","ruleList":[{"name":"name-6E9588UA","type":"ipv6","strategy":"deny","protocol":"tcp","sourceAddress":null,"destinationAddress":null,"sourcePort":null,"destinationPort":null,"description":"decs-zYUV7w6E"}]}
響應示例
{"statusCode":800,"message":"OK.","returnObj":{ }}
狀態碼
請參考
錯誤碼
請參考
