ACL模板管理-华为云

华为乾坤-删除ACL模板，post接口:请求示例

请求示例 HTTP的示例 POST /controller/campus/v3/profile/acl/action/batch-delete HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AC CES S-TOKEN: x-yyyyyy { "ids" : [ "4f350825-919c-47b7-b853-f51f15912396" ] }

华为乾坤 ACL模板管理

华为乾坤-删除ACL模板，post接口:响应示例

响应示例返回状态码为200：删除ACL模板成功。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "success" : [ "4f350825-919c-47b7-b853-f51f15912396" ], "fail" : [ { "errcode" : "0302000020", "errmsg" : "The site ID format is incorrect or the site does not exist", "id" : "4f350825-919c-47b7-b853-f51f15912398" } ] } 返回状态码为207：删除ACL模板部分成功。 HTTP/1.1 207 Multi-Status Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "success" : [ "4f350825-919c-47b7-b853-f51f15912396" ], "fail" : [ { "errcode" : "0302000020", "errmsg" : "The site ID format is incorrect or the site does not exist", "id" : "4f350825-919c-47b7-b853-f51f15912398" } ] } 返回状态码为400：删除ACL模板全部失败。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "success" : [ "4f350825-919c-47b7-b853-f51f15912396" ], "fail" : [ { "errcode" : "0302000020", "errmsg" : "The site ID format is incorrect or the site does not exist", "id" : "4f350825-919c-47b7-b853-f51f15912398" } ] } 返回状态码为500：内部服务异常。 HTTP/1.1 500 Internal Server Error Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

华为乾坤 ACL模板管理

华为乾坤-查询ACL模板:响应示例

响应示例返回状态码为200：查询返回的ACL模板信息。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "totalRecords" : 1, "data" : [ { "id" : "fbde1c5d-5b94-49e3-a912-48641015e45c", "name" : "ACLTemplate1", "aclNumber" : "3001", "description" : "ACLTemplate1", "aclType" : "Advanced", "ruleList" : [ { "ruleId" : "1", "ip" : "", "domain" : "", "policy" : "permit", "protocol" : "tcp", "tcpFlag" : "ack,fin", "srcIp" : "192.168.1.0/24", "srcPort" : "23", "dstIp" : "192.168.2.0/24", "dstPort" : "24", "dscp" : 2, "description" : "Rule1" } ], "ipType" : "ipv4" } ] } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

华为乾坤 ACL模板管理

华为乾坤-查询ACL模板:响应参数

响应参数返回状态码为200：查询返回的ACL模板信息。表2 QueryAclRet对象的参数列表参数名称类型参数值域默认值参数说明参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" totalRecords int32 - - 查询匹配到的ACL模板总数。 1 data ARRAY_REFERENCE 0-100个列表项，详细请参见表5。返回的ACL模板记录信息。 - 返回状态码为400：校验异常。详细信息请参见实际响应消息体。

华为乾坤 ACL模板管理

华为乾坤-查询ACL模板:请求示例

请求示例 HTTP的示例 GET /controller/campus/v3/profile/acl?ipType=ipv4 HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy

华为乾坤 ACL模板管理

华为乾坤-创建动态ACL模板:响应示例

响应示例返回状态码为201：成功创建的动态ACL模板信息。 HTTP/1.1 201 Created Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "id" : "fbde1c5d-5b94-49e3-a912-48641015e45c", "name" : "ACLTemplate1", "description" : "ACLTemplate1", "dynamicRuleList" : [ { "ruleId" : "10000", "policy" : "permit", "protocol" : "tcp", "dstIp" : "192.168.2.0/24", "dstPort" : "24" } ] } } 返回状态码为400：校验非法。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

华为乾坤 ACL模板管理

华为乾坤-创建动态ACL模板:请求示例

请求示例 HTTP的示例 POST /controller/campus/v3/profile/acl/dynamic HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "name" : "ACLTemplate1", "description" : "ACLTemplate1", "dynamicRuleList" : [ { "ruleId" : "10000", "policy" : "permit", "protocol" : "tcp", "dstIp" : "192.168.2.0/24", "dstPort" : "24" } ] }

华为乾坤 ACL模板管理

华为乾坤-创建动态ACL模板:请求参数

请求参数表1 body参数列表参数名称必选类型参数值域默认值参数说明参数示例 body 是 REFERENCE 详细请参见表2。待创建的动态ACL模板信息。 - 表2 DynamicAclDto对象的参数列表参数名称必选类型参数值域默认值参数说明参数示例 name 是 string 1~32个字符。 - 动态ACL模板名称，包括字母、数字、下划线、.、@、-，不能与已有的名称重复。 "ACLTemplate1" description 否 string 0~127个字符。 - 动态ACL模板描述。 "ACLTemplate1" dynamicRuleList 是 ARRAY_REFERENCE 1-64个列表项，详细请参见表3。规则列表。 - 表3 DynamicRuleList对象的参数列表参数名称必选类型参数值域默认值参数说明参数示例 ruleId 是 string - - 规则号，取值范围：10000-10999的整数。 "10000" policy 是 string permit deny - 策略，取值范围：permit，deny。 "permit" protocol 是 string udp tcp all icmp - 协议，取值范围：udp，tcp，all，icmp。 "tcp" dstIp 是 string - - 目的IP地址，格式：IP/掩码。 "192.168.2.0/24" dstPort 否 string - - 目的端口号，或目的端口段，取值范围：整数（例如1000）或者整数段（1-100），且整数和整数段包含的值在0~65535。当参数protocol取值为all或icmp时，目的端口号不填写。 "24"

华为乾坤 ACL模板管理

华为乾坤-创建动态ACL模板:响应参数

响应参数返回状态码为201：成功创建的动态ACL模板信息。表4 DynamicAclRet对象的参数列表参数名称类型参数值域默认值参数说明参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data REFERENCE 详细请参见表5。动态acl返回体 - 表5 DynamicAclDtoResponse对象的参数列表参数名称类型参数值域默认值参数说明参数示例 id string - - 动态ACL模板标识，UUID格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c" name string 1~32个字符。 - 动态ACL模板名称，包括字母、数字、下划线、.、@、-，不能与已有的名称重复。 "ACLTemplate1" description string 0~127个字符。 - 动态ACL模板描述。 "ACLTemplate1" dynamicRuleList ARRAY_REFERENCE 1-64个列表项，详细请参见表6。规则列表。 - 表6 DynamicRuleList对象的参数列表参数名称类型参数值域默认值参数说明参数示例 ruleId string - - 规则号，取值范围：10000-10999的整数。 "10000" policy string permit deny - 策略，取值范围：permit，deny。 "permit" protocol string udp tcp all icmp - 协议，取值范围：udp，tcp，all，icmp。 "tcp" dstIp string - - 目的IP地址，格式：IP/掩码。 "192.168.2.0/24" dstPort string - - 目的端口号，或目的端口段，取值范围：整数（例如1000）或者整数段（1-100），且整数和整数段包含的值在0~65535。当参数protocol取值为all或icmp时，目的端口号不填写。 "24" 返回状态码为400：校验非法。详细信息请参见实际响应消息体。

华为乾坤 ACL模板管理

华为乾坤-创建ACL模板:响应示例

响应示例返回状态码为201：成功创建的ACL模板信息。 HTTP/1.1 201 Created Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "id" : "fbde1c5d-5b94-49e3-a912-48641015e45c", "name" : "ACLTemplate1", "aclNumber" : "3001", "description" : "ACLTemplate1", "aclType" : "Advanced", "ruleList" : [ { "ruleId" : "1", "ip" : "", "domain" : "", "policy" : "permit", "protocol" : "tcp", "tcpFlag" : "ack,fin", "srcIp" : "192.168.1.0/24", "srcPort" : "23", "dstIp" : "192.168.2.0/24", "dstPort" : "24", "dscp" : 2, "description" : "Rule1" } ], "ipType" : "ipv4" } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

华为乾坤 ACL模板管理

华为乾坤-创建ACL模板:响应参数

响应参数返回状态码为201：成功创建的ACL模板信息。表4 UpdateAclRet对象的参数列表参数名称类型参数值域默认值参数说明参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data REFERENCE 详细请参见表5。 acl返回体 - 表5 AclDtoInResponse对象的参数列表参数名称类型参数值域默认值参数说明参数示例 id string - - ACL模板标识，UUID格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c" name string 1~32个字符。 - ACL模板名称，包括汉字、字母、数字、下划线、.、@、-不能与已有的名称重复。 "ACLTemplate1" aclNumber string - - ACL模板编号，必须为数字或段（例如：6000或6000-6031）。修改模板时只能扩大编号范围。未填写ACL编号的ACL默认为最大编号范围。aclType为Advanced时，aclNumber范围：3001-3999，aclType为User时，aclNumber范围：6000-6031。 "3001" description string 0~127个字符。 - ACL模板描述。 "ACLTemplate1" aclType string Advanced User - ACL模板类型（User为“用户”，Advanced为“高级”）。 "Advanced" ruleList ARRAY_REFERENCE 1-1024个列表项，详细请参见表6。规则列表。当aclType为User时，支持1-128个规则列表项，仅IPV4支持用户ACL。当aclType为Advanced时，最多支持1024个规则列表项。 - ipType string ipv4 ipv6 ipv4 ACLIP类型。 "ipv4" 表6 ruleList对象的参数列表参数名称类型参数值域默认值参数说明参数示例 ruleId string - - 规则优先级编号（0~4294967294的整数），仅在aclType为高级时有效且必填。 "1" ip string - - IP地址，仅在aclType为用户时有效非必填。为空时，默认赋予值为any。与domain共存时，优先级高于domain。例如：192.168.1.0/24 - domain string - - 域名，仅在aclType为用户时有效且非必填。为空时，默认赋予值为any，长度限制127位。例如：www.example.com - policy string permit deny - 策略，aclType为高级acl时有效且必填，有效值permit，deny。 "permit" protocol string udp tcp any icmp - 协议，aclType为高级acl时有效且必填，有效值udp，tcp，any，icmp，当aclType为用户时有效非必填，有效值udp，tcp，any，为空时，默认赋予值为any。 "tcp" tcpFlag string 0~64个字符。 - TCP标识状态，支持配置ack（010000，确认标识，表示确认序号有效）、established（表示标识位为ack或rst）、fin（000001，结束标识，表示发送方完成发送任务）、psh（001000，推送标识，表示接收方应该尽快将这个报文交给应用层处理）、rst（000100，重置复位标识，表示重建连接）、syn（000010，同步标识，表示开始会话请求，用于建立连接）、urg（100000，紧急指针标识，表明发送端向另一端使用紧急方式发送数据。包中有紧急处理的数据），多选时用逗号隔开，配置established时其他不可配置。protocol为tcp时有效 "ack,fin" srcIp string - - 源IP地址，可以输入Any表示任意IP，仅在aclType为高级时有效且必填。仅IPv4高级ACL支持通配符掩码（当前仅支持V200R020C10及之后版本的交换机和V600R021C10及之后版本的路由器，“0”表示“检查相应的位”，“1”表示“不检查相应的位”），如192.168.1.0/0.0.0.255。 "192.168.1.0/24" srcPort string - - 源端口号，或源端口段，仅在aclType为高级时有效，范围：整数（例如1000）或者整数段（1-100），且整数和整数段包含的值在0~65535。 "23" dstIp string - - 目的IP地址，可以输入Any表示任意IP，仅在aclType为高级时有效且必填。仅IPv4高级ACL支持通配符掩码（当前仅支持V200R020C10及之后版本的交换机和V600R021C10及之后版本的路由器，“0”表示“检查相应的位”，“1”表示“不检查相应的位”），如192.168.1.0/0.0.0.255。 "192.168.2.0/24" dstPort string - - 目的端口号，或目的端口段，范围：整数（例如1000）或者整数段（1-100），且整数和整数段包含的值在0~65535，当aclType为用户时有效非必填，当aclType为高级时有效。 "24" dscp integer [0-63] - dscp，仅IPv4的高级ACL有效。 2 description string 0~127个字符。 - 规则描述。 "Rule1" 返回状态码为400：校验异常。详细信息请参见实际响应消息体。

华为乾坤 ACL模板管理

华为乾坤-创建ACL模板:请求示例

请求示例 HTTP的示例 POST /controller/campus/v3/profile/acl HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "name" : "ACLTemplate1", "aclNumber" : "3001", "description" : "ACLTemplate1", "aclType" : "Advanced", "ruleList" : [ { "ruleId" : "1", "ip" : "", "domain" : "", "policy" : "permit", "protocol" : "tcp", "tcpFlag" : "ack,fin", "srcIp" : "192.168.1.0/24", "srcPort" : "23", "dstIp" : "192.168.2.0/24", "dstPort" : "24", "dscp" : 2, "description" : "Rule1" } ], "ipType" : "ipv4" }

华为乾坤 ACL模板管理

华为乾坤-创建ACL模板:请求参数

请求参数表1 body参数列表参数名称必选类型参数值域默认值参数说明参数示例 body 是 REFERENCE 详细请参见表2。待创建的ACL模板信息。 - 表2 AclDtoDetail对象的参数列表参数名称必选类型参数值域默认值参数说明参数示例 name 是 string 1~32个字符。 - ACL模板名称，包括汉字、字母、数字、下划线、.、@、-不能与已有的名称重复。 "ACLTemplate1" aclNumber 否 string - - ACL模板编号，必须为数字或段（例如：6000或6000-6031）。修改模板时只能扩大编号范围。未填写ACL编号的ACL默认为最大编号范围。aclType为Advanced时，aclNumber范围：3001-3999，aclType为User时，aclNumber范围：6000-6031。 "3001" description 否 string 0~127个字符。 - ACL模板描述。 "ACLTemplate1" aclType 是 string Advanced User - ACL模板类型（User为“用户”，Advanced为“高级”）。 "Advanced" ruleList 是 ARRAY_REFERENCE 1-1024个列表项，详细请参见表3。规则列表。当aclType为User时，支持1-128个规则列表项，仅IPV4支持用户ACL。当aclType为Advanced时，最多支持1024个规则列表项。 - ipType 否 string ipv4 ipv6 ipv4 ACLIP类型。 "ipv4" 表3 ruleList对象的参数列表参数名称必选类型参数值域默认值参数说明参数示例 ruleId 否 string - - 规则优先级编号（0~4294967294的整数），仅在aclType为高级时有效且必填。 "1" ip 否 string - - IP地址，仅在aclType为用户时有效非必填。为空时，默认赋予值为any。与domain共存时，优先级高于domain。例如：192.168.1.0/24 - domain 否 string - - 域名，仅在aclType为用户时有效且非必填。为空时，默认赋予值为any，长度限制127位。例如：www.example.com - policy 否 string permit deny - 策略，aclType为高级acl时有效且必填，有效值permit，deny。 "permit" protocol 否 string udp tcp any icmp - 协议，aclType为高级acl时有效且必填，有效值udp，tcp，any，icmp，当aclType为用户时有效非必填，有效值udp，tcp，any，为空时，默认赋予值为any。 "tcp" tcpFlag 否 string 0~64个字符。 - TCP标识状态，支持配置ack（010000，确认标识，表示确认序号有效）、established（表示标识位为ack或rst）、fin（000001，结束标识，表示发送方完成发送任务）、psh（001000，推送标识，表示接收方应该尽快将这个报文交给应用层处理）、rst（000100，重置复位标识，表示重建连接）、syn（000010，同步标识，表示开始会话请求，用于建立连接）、urg（100000，紧急指针标识，表明发送端向另一端使用紧急方式发送数据。包中有紧急处理的数据），多选时用逗号隔开，配置established时其他不可配置。protocol为tcp时有效 "ack,fin" srcIp 否 string - - 源IP地址，可以输入Any表示任意IP，仅在aclType为高级时有效且必填。仅IPv4高级ACL支持通配符掩码（当前仅支持V200R020C10及之后版本的交换机和V600R021C10及之后版本的路由器，“0”表示“检查相应的位”，“1”表示“不检查相应的位”），如192.168.1.0/0.0.0.255。 "192.168.1.0/24" srcPort 否 string - - 源端口号，或源端口段，仅在aclType为高级时有效，范围：整数（例如1000）或者整数段（1-100），且整数和整数段包含的值在0~65535。 "23" dstIp 否 string - - 目的IP地址，可以输入Any表示任意IP，仅在aclType为高级时有效且必填。仅IPv4高级ACL支持通配符掩码（当前仅支持V200R020C10及之后版本的交换机和V600R021C10及之后版本的路由器，“0”表示“检查相应的位”，“1”表示“不检查相应的位”），如192.168.1.0/0.0.0.255。 "192.168.2.0/24" dstPort 否 string - - 目的端口号，或目的端口段，范围：整数（例如1000）或者整数段（1-100），且整数和整数段包含的值在0~65535，当aclType为用户时有效非必填，当aclType为高级时有效。 "24" dscp 否 integer [0-63] - dscp，仅IPv4的高级ACL有效。 2 description 否 string 0~127个字符。 - 规则描述。 "Rule1"

华为乾坤 ACL模板管理

华为乾坤-删除ACL模板:请求示例

请求示例 HTTP的示例 DELETE /controller/campus/v3/profile/acl HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "ids" : [ "4f350825-919c-47b7-b853-f51f15912396" ] }

华为乾坤 ACL模板管理

华为乾坤-删除ACL模板:响应示例

响应示例返回状态码为200：删除ACL模板的返回信息。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "success" : [ "4f350825-919c-47b7-b853-f51f15912396" ], "fail" : [ { "errcode" : "0302000020", "errmsg" : "The site ID format is incorrect or the site does not exist", "data" : "4f350825-919c-47b7-b853-f51f15912398" } ] } 返回状态码为400：删除ACL模板全部失败。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

华为乾坤 ACL模板管理

云服务器内容精选

ACL模板管理

7*24

备案

专业服务

退订

建议反馈

售前咨询热线