本文导读

典型场景
接口功能
接口约束
调用方法
URI
请求参数
请求示例
响应参数
响应示例

展开导读

文档首页/ 华为乾坤/ 云管理网络/ API参考/ 接口参考/ LANWAN融合/ 流量策略/ 流分类模板接口/ 批量创建流分类模板

批量创建流分类模板

更新时间：2025-02-17 GMT+08:00

查看PDF

典型场景

批量创建流分类模板。

接口功能

批量创建流分类模板。

接口约束

该接口仅支持租户视图或msp代维视图下，角色为“Open Api Operator”的用户访问，必须在用户会话建立后使用。

调用方法

POST

URI

/controller/campus/v1/sdwan/policy/traffic/classification-profiles

请求参数

表1 body参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
classificationProfiles	是	REFERENCE	详细请参见表2。		创建流分类模板请求数据。	-

表2 ClassificationProfileInfos对象的参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
classificationProfiles	否	ARRAY_REFERENCE	1-1000个列表项，详细请参见表3。		创建流分类模板请求数据。	-

表3 ClassificationProfileInfo对象的参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
id	否	uuid	-	-	模板ID，主键字段。创建时不填，后台自动生成。更新、删除时必填。	"00000000-0000-0000-0000-000000000000"
name	否	string	1~64个字符。	-	模板名称，创建时必填。模板名称不可以ADN(不区分大小写)开头；模板名称字符取值范围：中英文、数字、空格、特殊字符，其中特殊字符包括!"#$%&'()*+,_-./:;<=>@[\]^`{\|}~。	"app"
operator	否	string	2~3个字符。	-	规则类型：and、or，默认值and，不区分大小写。	"and"
aclType	否	string	4个字符。	-	ACL类型：ipv4、ipv6，默认值ipv4。 FW网关设备不支持ipv6。	"ipv4"
l3Acls	否	ARRAY_REFERENCE	0-1024个列表项，详细请参见表4。		当前最多支持1024条l3ACL，当aclType类型为ipv6时表示Acl6。创建时l3Acls、应用组、高级至少填一个。	-
applicationGroupIds	否	array<string>	0-256 个列表项。	-	应用组列表。	["00000000-0000-0000-0000-000000000000"]
enableVlanRange	否	boolean	true false	false	是否使能vlanRange，默认值false	false
vlanRange	否	REFERENCE	详细请参见表5。		Vlan值范围。	-
enableP8021	否	boolean	true false	false	是否使能802.1p，默认值false	false
p8021	否	int32	[0-7]	-	802.1p优先级，范围：0-7。	1
enableSourceMac	否	boolean	true false	false	是否使能源Mac地址，默认值false	false
sourceMac	否	REFERENCE	详细请参见表6。		源Mac详细信息。	-
enableDestinationMac	否	boolean	true false	false	是否使能目的Mac地址，默认值false	false
destinationMac	否	REFERENCE	详细请参见表6。		目的Mac详细信息。	-
enableL2Protocol	否	boolean	true false	false	是否使能L2协议，默认值false	false
l2ProtocolNum	否	string	0~6个字符。	-	L2 协议号，范围：0x600-0xffff。ARP：0x0806，IP：0x0800，MPLS：0x8847，RARP：0x8035。	"0x0800"
adn	否	boolean	true false	false	策略推荐标识。该字段已废弃。	false
experienceLevel	否	string	RealTime Business Bulk	-	体验级别 RealTime, Business, Bulk。该字段已废弃。	-
applyType	否	string	FW COMMON	-	适用类型，标识该模板是FW还是原应用模板。	"FW"
sourceIps	否	array<string>	0-64 个列表项。每个列表项0~18个字符。	-	源IP列表（适用于FW场景）。	["10.1.1.2/32"]
sourceIpSets	否	array<string>	0-64 个列表项。每个列表项0~63个字符。	-	源IP地址组名列表（适用于FW场景）。	["sourceIp"]
sourceDomainSets	否	array<string>	0-64 个列表项。每个列表项0~32个字符。	-	源域名地址组名列表（适用于FW场景）。	["domainSet"]
destIps	否	array<string>	0-64 个列表项。每个列表项0~18个字符。	-	目的IP列表（适用于FW场景）。	["10.1.1.2/32"]
destIpSets	否	array<string>	0-64 个列表项。每个列表项0~63个字符。	-	目的IP地址组名列表（适用于FW场景）。	["destIp"]
destDomainSets	否	array<string>	0-64 个列表项。每个列表项0~32个字符。	-	目的域名地址组名列表（适用于FW场景）。	["domainSet"]
protocols	否	ARRAY_REFERENCE	0-64个列表项，详细请参见表7。		服务列表（适用于FW场景）。	-

表4 L3Acl对象的参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
priority	否	int32	[1-5000]	-	优先级，范围：1-5000，越小优先级越高。默认值1。	1
sourceIP	否	string	0~64个字符。	-	源IP网段或者Any。当aclType类型为ipv6时，表示ipv6地址。支持掩码和通配符两种配置形式，比如：192.168.0.0/16和192.168.0.0/255.0.31.18。掩码换算成二进制以后1表示匹配，0表示不匹配。通配符换算成二进制以后1表示不匹配，0表示匹配。	"192.168.0.0/16"
destinationIP	否	string	0~64个字符。	-	目的IP网段或者Any。当aclType类型为ipv6时，表示ipv6地址。支持掩码和通配符两种配置形式，比如：192.168.0.0/16和192.168.0.0/255.0.31.18。掩码换算成二进制以后1表示匹配，0表示不匹配。通配符换算成二进制以后1表示不匹配，0表示匹配。	"192.168.0.0/16"
sourcePort	否	int32	[0-65535]	-	源端口号起始值。protocolNum为6（TCP）、17（UDP）时有效。sourcePort值小于等于sourcePortEnd。	1
sourcePortEnd	否	int32	[0-65535]	-	源端口号结束值。protocolNum为6（TCP）、17（UDP）时有效。	1
destinationPort	否	int32	[0-65535]	-	目的端口号起始值。protocolNum为6（TCP）、17（UDP）时有效。destinationPort值小于等于destinationPortEnd。	1
destinationPortEnd	否	int32	[0-65535]	-	目的端口号结束值。protocolNum为6（TCP）、17（UDP）时有效。	1
dscp	否	int32	[0-63]	-	差分服务码点，标志流量优先级。	1
protocolNum	否	int32	[0-255]	-	协议号。1为ICMP，6为TCP，17为UDP，132为SCTP，默认为0。	1
tcpFlag	否	string	0~64个字符。	-	TCP标识状态，支持配置ack、established、fin、psh、rst、syn、urg，多个值逗号分隔。aclType赋值Ipv4时，protocolNum为6（TCP）时有效,其他情况不允许配置。tcpFlag值为established时，不能同时配置其他值，仅支持单独配置tcpFlag值为established。	"ack,fin"

表5 VlanRange对象的参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
start	否	int32	[1-4094]	-	Vlan ID范围的开始值，取值范围：1-4094。	1
end	否	int32	[1-4094]	-	Vlan ID范围的结束值，取值范围：1-4094。	4094

表6 Mac对象的参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
address	否	string	0~64个字符。	-	MAC地址。	"00:e0:fc:12:34:56"
mask	否	string	0~64个字符。	-	掩码。	"0xffff-ffff-0000"

表7 Protocol对象的参数列表
参数名称	必选	类型	参数值域	默认值	参数说明	参数示例
name	否	string	0~20个字符。	-	协议名称。	"TCP"
protocolNum	否	integer	[0-255]	-	协议号。	6
srcPort	否	string	0~11个字符。	-	源端口。	"0-65535"
dstPort	否	string	0~11个字符。	-	目的端口。	"0-65535"

请求示例

HTTP的示例

POST /controller/campus/v1/sdwan/policy/traffic/classification-profiles 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
{
	"classificationProfiles" : [
		{
			"id" : "00000000-0000-0000-0000-000000000000",
			"name" : "app",
			"operator" : "and",
			"aclType" : "ipv4",
			"l3Acls" : [
				{
					"priority" : 1,
					"sourceIP" : "192.168.0.0/16",
					"destinationIP" : "192.168.0.0/16",
					"sourcePort" : 1,
					"sourcePortEnd" : 1,
					"destinationPort" : 1,
					"destinationPortEnd" : 1,
					"dscp" : 1,
					"protocolNum" : 1,
					"tcpFlag" : "ack,fin"
				}
			],
			"applicationGroupIds" : [
				 "00000000-0000-0000-0000-000000000000"
			],
			"enableVlanRange" : false,
			"vlanRange" : {
				"start" : 1,
				"end" : 4094
			},
			"enableP8021" : false,
			"p8021" : 1,
			"enableSourceMac" : false,
			"sourceMac" : {
				"address" : "00:e0:fc:12:34:56",
				"mask" : "0xffff-ffff-0000"
			},
			"enableDestinationMac" : false,
			"destinationMac" : {
				"address" : "00:e0:fc:12:34:56",
				"mask" : "0xffff-ffff-0000"
			},
			"enableL2Protocol" : false,
			"l2ProtocolNum" : "0x0800",
			"adn" : false,
			"experienceLevel" : "",
			"applyType" : "FW",
			"sourceIps" : [
				 "10.1.1.2/32"
			],
			"sourceIpSets" : [
				 "sourceIp"
			],
			"sourceDomainSets" : [
				 "domainSet"
			],
			"destIps" : [
				 "10.1.1.2/32"
			],
			"destIpSets" : [
				 "destIp"
			],
			"destDomainSets" : [
				 "domainSet"
			],
			"protocols" : [
				{
					"name" : "TCP",
					"protocolNum" : 6,
					"srcPort" : "0-65535",
					"dstPort" : "0-65535"
				}
			]
		}
	]
}

响应参数

返回状态码为201：创建成功，响应体参考ClassificationProfileResponse。

表8 ClassificationProfileResponse对象的参数列表
参数名称	类型	参数值域	默认值	参数说明	参数示例
errcode	string	-	-	错误码：errcode取值0代表成功，非0代表失败。	"0"
errmsg	string	-	-	错误信息。	""
success	ARRAY_REFERENCE	0-1000个列表项，详细请参见表9。		成功的流分类模板信息列表。	-
fail	ARRAY_REFERENCE	0-1000个列表项，详细请参见表14。		失败的流分类模板信息列表。	-

表9 ClassificationProfileInfo对象的参数列表
参数名称	类型	参数值域	默认值	参数说明	参数示例
id	uuid	-	-	模板ID，主键字段。创建时不填，后台自动生成。更新、删除时必填。	"00000000-0000-0000-0000-000000000000"
name	string	1~64个字符。	-	模板名称，创建时必填。模板名称不可以ADN(不区分大小写)开头；模板名称字符取值范围：中英文、数字、空格、特殊字符，其中特殊字符包括!"#$%&'()*+,_-./:;<=>@[\]^`{\|}~。	"app"
operator	string	2~3个字符。	-	规则类型：and、or，默认值and，不区分大小写。	"and"
aclType	string	4个字符。	-	ACL类型：ipv4、ipv6，默认值ipv4。 FW网关设备不支持ipv6。	"ipv4"
l3Acls	ARRAY_REFERENCE	0-1024个列表项，详细请参见表10。		当前最多支持1024条l3ACL，当aclType类型为ipv6时表示Acl6。创建时l3Acls、应用组、高级至少填一个。	-
applicationGroupIds	array<string>	0-256 个列表项。	-	应用组列表。	["00000000-0000-0000-0000-000000000000"]
enableVlanRange	boolean	true false	false	是否使能vlanRange，默认值false	false
vlanRange	REFERENCE	详细请参见表11。		Vlan值范围。	-
enableP8021	boolean	true false	false	是否使能802.1p，默认值false	false
p8021	int32	[0-7]	-	802.1p优先级，范围：0-7。	1
enableSourceMac	boolean	true false	false	是否使能源Mac地址，默认值false	false
sourceMac	REFERENCE	详细请参见表12。		源Mac详细信息。	-
enableDestinationMac	boolean	true false	false	是否使能目的Mac地址，默认值false	false
destinationMac	REFERENCE	详细请参见表12。		目的Mac详细信息。	-
enableL2Protocol	boolean	true false	false	是否使能L2协议，默认值false	false
l2ProtocolNum	string	0~6个字符。	-	L2 协议号，范围：0x600-0xffff。ARP：0x0806，IP：0x0800，MPLS：0x8847，RARP：0x8035。	"0x0800"
adn	boolean	true false	false	策略推荐标识。该字段已废弃。	false
experienceLevel	string	RealTime Business Bulk	-	体验级别 RealTime, Business, Bulk。该字段已废弃。	-
applyType	string	FW COMMON	-	适用类型，标识该模板是FW还是原应用模板。	"FW"
sourceIps	array<string>	0-64 个列表项。每个列表项0~18个字符。	-	源IP列表（适用于FW场景）。	["10.1.1.2/32"]
sourceIpSets	array<string>	0-64 个列表项。每个列表项0~63个字符。	-	源IP地址组名列表（适用于FW场景）。	["sourceIp"]
sourceDomainSets	array<string>	0-64 个列表项。每个列表项0~32个字符。	-	源域名地址组名列表（适用于FW场景）。	["domainSet"]
destIps	array<string>	0-64 个列表项。每个列表项0~18个字符。	-	目的IP列表（适用于FW场景）。	["10.1.1.2/32"]
destIpSets	array<string>	0-64 个列表项。每个列表项0~63个字符。	-	目的IP地址组名列表（适用于FW场景）。	["destIp"]
destDomainSets	array<string>	0-64 个列表项。每个列表项0~32个字符。	-	目的域名地址组名列表（适用于FW场景）。	["domainSet"]
protocols	ARRAY_REFERENCE	0-64个列表项，详细请参见表13。		服务列表（适用于FW场景）。	-

**表10** L3Acl对象的参数列表
参数名称	类型	参数值域	默认值	参数说明	参数示例
priority	int32	[1-5000]	-	优先级，范围：1-5000，越小优先级越高。默认值1。	1
sourceIP	string	0~64个字符。	-	源IP网段或者Any。当aclType类型为ipv6时，表示ipv6地址。支持掩码和通配符两种配置形式，比如：192.168.0.0/16和192.168.0.0/255.0.31.18。掩码换算成二进制以后1表示匹配，0表示不匹配。通配符换算成二进制以后1表示不匹配，0表示匹配。	"192.168.0.0/16"
destinationIP	string	0~64个字符。	-	目的IP网段或者Any。当aclType类型为ipv6时，表示ipv6地址。支持掩码和通配符两种配置形式，比如：192.168.0.0/16和192.168.0.0/255.0.31.18。掩码换算成二进制以后1表示匹配，0表示不匹配。通配符换算成二进制以后1表示不匹配，0表示匹配。	"192.168.0.0/16"
sourcePort	int32	[0-65535]	-	源端口号起始值。protocolNum为6（TCP）、17（UDP）时有效。sourcePort值小于等于sourcePortEnd。	1
sourcePortEnd	int32	[0-65535]	-	源端口号结束值。protocolNum为6（TCP）、17（UDP）时有效。	1
destinationPort	int32	[0-65535]	-	目的端口号起始值。protocolNum为6（TCP）、17（UDP）时有效。destinationPort值小于等于destinationPortEnd。	1
destinationPortEnd	int32	[0-65535]	-	目的端口号结束值。protocolNum为6（TCP）、17（UDP）时有效。	1
dscp	int32	[0-63]	-	差分服务码点，标志流量优先级。	1
protocolNum	int32	[0-255]	-	协议号。1为ICMP，6为TCP，17为UDP，132为SCTP，默认为0。	1
tcpFlag	string	0~64个字符。	-	TCP标识状态，支持配置ack、established、fin、psh、rst、syn、urg，多个值逗号分隔。aclType赋值Ipv4时，protocolNum为6（TCP）时有效,其他情况不允许配置。tcpFlag值为established时，不能同时配置其他值，仅支持单独配置tcpFlag值为established。	"ack,fin"

**表11** VlanRange对象的参数列表
参数名称	类型	参数值域	默认值	参数说明	参数示例
start	int32	[1-4094]	-	Vlan ID范围的开始值，取值范围：1-4094。	1
end	int32	[1-4094]	-	Vlan ID范围的结束值，取值范围：1-4094。	4094

**表12** Mac对象的参数列表
参数名称	类型	参数值域	默认值	参数说明	参数示例
address	string	0~64个字符。	-	MAC地址。	"00:e0:fc:12:34:56"
mask	string	0~64个字符。	-	掩码。	"0xffff-ffff-0000"

**表13** Protocol对象的参数列表
参数名称	类型	参数值域	默认值	参数说明	参数示例
name	string	0~20个字符。	-	协议名称。	"TCP"
protocolNum	integer	[0-255]	-	协议号。	6
srcPort	string	0~11个字符。	-	源端口。	"0-65535"
dstPort	string	0~11个字符。	-	目的端口。	"0-65535"

**表14** FailClassificationProfileInfo对象的参数列表
参数名称	类型	参数值域	默认值	参数说明	参数示例
errcode	string	-	-	错误码。	"0x00c8000c"
errmsg	string	-	-	错误信息。	"The parameter is invalid."
data	REFERENCE	详细请参见表9。		-	-

返回状态码为400：请求参数错误，无响应体。

详细信息请参见实际响应消息体。

返回状态码为500：内部错误，无响应体。

详细信息请参见实际响应消息体。

响应示例

返回状态码为201：创建成功，响应体参考ClassificationProfileResponse。

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" : "",
	"success" : [
		{
			"id" : "00000000-0000-0000-0000-000000000000",
			"name" : "app",
			"operator" : "and",
			"aclType" : "ipv4",
			"l3Acls" : [
				{
					"priority" : 1,
					"sourceIP" : "192.168.0.0/16",
					"destinationIP" : "192.168.0.0/16",
					"sourcePort" : 1,
					"sourcePortEnd" : 1,
					"destinationPort" : 1,
					"destinationPortEnd" : 1,
					"dscp" : 1,
					"protocolNum" : 1,
					"tcpFlag" : "ack,fin"
				}
			],
			"applicationGroupIds" : [
				 "00000000-0000-0000-0000-000000000000"
			],
			"enableVlanRange" : false,
			"vlanRange" : {
				"start" : 1,
				"end" : 4094
			},
			"enableP8021" : false,
			"p8021" : 1,
			"enableSourceMac" : false,
			"sourceMac" : {
				"address" : "00:e0:fc:12:34:56",
				"mask" : "0xffff-ffff-0000"
			},
			"enableDestinationMac" : false,
			"destinationMac" : {
				"address" : "00:e0:fc:12:34:56",
				"mask" : "0xffff-ffff-0000"
			},
			"enableL2Protocol" : false,
			"l2ProtocolNum" : "0x0800",
			"adn" : false,
			"experienceLevel" : "",
			"applyType" : "FW",
			"sourceIps" : [
				 "10.1.1.2/32"
			],
			"sourceIpSets" : [
				 "sourceIp"
			],
			"sourceDomainSets" : [
				 "domainSet"
			],
			"destIps" : [
				 "10.1.1.2/32"
			],
			"destIpSets" : [
				 "destIp"
			],
			"destDomainSets" : [
				 "domainSet"
			],
			"protocols" : [
				{
					"name" : "TCP",
					"protocolNum" : 6,
					"srcPort" : "0-65535",
					"dstPort" : "0-65535"
				}
			]
		}
	],
	"fail" : [
		{
			"errcode" : "0x00c8000c",
			"errmsg" : "The parameter is invalid.",
			"data" : {
				"id" : "00000000-0000-0000-0000-000000000000",
				"name" : "app",
				"operator" : "and",
				"aclType" : "ipv4",
				"l3Acls" : [
					{
						"priority" : 1,
						"sourceIP" : "192.168.0.0/16",
						"destinationIP" : "192.168.0.0/16",
						"sourcePort" : 1,
						"sourcePortEnd" : 1,
						"destinationPort" : 1,
						"destinationPortEnd" : 1,
						"dscp" : 1,
						"protocolNum" : 1,
						"tcpFlag" : "ack,fin"
					}
				],
				"applicationGroupIds" : [
					 "00000000-0000-0000-0000-000000000000"
				],
				"enableVlanRange" : false,
				"vlanRange" : {
					"start" : 1,
					"end" : 4094
				},
				"enableP8021" : false,
				"p8021" : 1,
				"enableSourceMac" : false,
				"sourceMac" : {
					"address" : "00:e0:fc:12:34:56",
					"mask" : "0xffff-ffff-0000"
				},
				"enableDestinationMac" : false,
				"destinationMac" : {
					"address" : "00:e0:fc:12:34:56",
					"mask" : "0xffff-ffff-0000"
				},
				"enableL2Protocol" : false,
				"l2ProtocolNum" : "0x0800",
				"adn" : false,
				"experienceLevel" : "",
				"applyType" : "FW",
				"sourceIps" : [
					 "10.1.1.2/32"
				],
				"sourceIpSets" : [
					 "sourceIp"
				],
				"sourceDomainSets" : [
					 "domainSet"
				],
				"destIps" : [
					 "10.1.1.2/32"
				],
				"destIpSets" : [
					 "destIp"
				],
				"destDomainSets" : [
					 "domainSet"
				],
				"protocols" : [
					{
						"name" : "TCP",
						"protocolNum" : 6,
						"srcPort" : "0-65535",
						"dstPort" : "0-65535"
					}
				]
			}
		}
	]
}

返回状态码为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

返回状态码为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

父主题： 流分类模板接口

上一篇：批量删除流分类模板

下一篇：查询流分类模板

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

批量创建流分类模板

典型场景

接口功能

接口约束

调用方法

URI

请求参数

请求示例

响应参数

响应示例

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈