CreateTrafficMarkingPolicy_云企业网_API文档-阿里云OpenAPI开发者门户

接口说明

仅企业版转发路由器支持创建流量标记策略。
CreateTrafficMarkingPolicy 接口属于异步接口，即系统会先返回一个流量标记策略 ID，但该流量标记策略并未创建完成，系统后台的创建任务仍在进行。您可以调用 ListTrafficMarkingPolicies 接口查询流量标记策略的状态。
- 当流量标记策略处于 Creating 状态时，表示流量标记策略正在创建中，在该状态下，您只能对流量标记策略执行查询操作，不能执行其他操作。
- 当流量标记策略处于 Active 状态时，表示流量标记策略创建完成。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

cen:CreateTrafficMarkingPolicy	Create	全部资源 *	无	无

请求参数

字段名称	字段详情
ClientTokenstring	客户端 Token，用于保证请求的幂等性。展开详情示例值:123e4567-e89b-12d3-a456-426****
DryRunboolean	是否只预检此次请求。取值：展开详情示例值:false
TransitRouterIdstring	转发路由器实例 ID。示例值:tr-8vbuqeo5h5pu3m01d****参考取值来源: ListTransitRouters CreateTransitRouter
TrafficMarkingPolicyNamestring	流量标记策略的名称。展开详情示例值:nametest参考取值来源: ListTrafficMarkingPolicies
TrafficMarkingPolicyDescriptionstring	流量标记策略的描述信息。展开详情示例值:desctest
Priorityinteger<int32>	流量标记策略的优先级。取值范围：1~100。展开详情示例值:5
MarkingDscpinteger<int32>	为符合流分类规则的流量报文添加 DSCP（Differentiated Services Code Point）值。取值范围：0~63。展开详情示例值:5
TrafficMatchRulesarray<object>	流量标记策略的流分类规则列表。展开详情子级条数 <= 50

返回参数

字段名称	字段详情
TrafficMarkingPolicyIdstring	流量标记策略 ID。示例值:tm-u9nxup5kww5po8****
RequestIdstring	请求 ID。示例值:0876E54E-3E36-5C31-89F0-9EE8A9266F9A

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InvalidTransitRouterId.NotFound	TransitRouterId is not found.	诊断
400	IllegalParam.Protocol	Protocol is illegal.	诊断
400	OperationFailed.TransitRouterType	Operation failed because The Basic TransitRouter does not support this action.	诊断
400	IllegalParam.Priority	Priority is illegal.	诊断
400	IllegalParam.MarkingDscp	MarkingDscp is illegal.	诊断
400	IllegalParam.SrcCidr	SrcCidr is illegal.	诊断
400	IllegalParam.DstCidr	DstCidr is illegal.	诊断
400	Duplicated.Priority	The parameter Priority is duplicated.	诊断
400	Duplicated.MarkingDscp	The parameter MarkingDscp is duplicated.	诊断
400	Duplicated.TrafficMatchRules	The parameter TrafficMatchRules are duplicated.	诊断
400	QuotaExceeded.TrafficMatchRule	The maximum number of TrafficMatchRule per Transit Router is exceeded.	诊断
400	IllegalParam.MatchDscp	MarkingDscp is invalid.	诊断
400	IllegalParam.SrcPortRange	The specified SrcPortRange is illegal.	诊断
400	IllegalParam.DstPortRange	The specified DstPortRange is illegal.	诊断
400	AttrMismatching.CidrAddressFamily	Attribute SrcCidr or DstCidr of TrafficMarkRule does not match AddressFamily.	诊断
400	IllegalParam.AddressFamily	AddressFamily is illegal.	诊断
400	AttrMismatching.SrcCidrDstCidr	Attribute SrcCidr of TrafficMarkRule does not match DstCidr.	诊断
400	AttrMismatching.CidrProtocol	Attribute SrcCidr or DstCidr of TrafficMarkRule does not match Protocol.	诊断
400	InvalidTransitRouterMode.NeedUpgrade	TransitRouter need to upgrade.	诊断
400	OperationUnsupported.DstPortRange	Current TR version does not support setting destination port range.	诊断
400	OperationUnsupported.SrcPortRange	Current TR version does not support setting source port range.	诊断
400	OperationUnsupported.IPv6Cidr	The traffic marking policy for current TR type does not support IPv6 CIDR.	诊断
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.	诊断
400	InvalidParameter	Invalid parameter.	诊断
400	Unauthorized	The AccessKeyId is unauthorized.	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-11-22	变更错误码400
	2024-09-10	变更请求参数TrafficMatchRules
	2024-08-20	变更错误码400
	2024-04-19	变更错误码400
	2024-03-15	变更错误码400
	2023-12-07	变更错误码400
	2023-01-09	变更错误码400
	2022-12-02	变更错误码400
	2022-11-30	变更错误码400

1
2
10 条/页

CreateTrafficMarkingPolicy_云企业网_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例