调用UpdateTrafficMarkingPolicyAttribute修改流量标记策略的名称/描述信息以及流分类规则

修改流量标记策略的名称，描述信息以及流分类规则。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
cen:UpdateTrafficMarkingPolicyAttribute		CEN acs:cen:*:{#accountId}:ceninstance/{#CenId}	无	无

请求参数

名称	类型	必填	描述	示例值
ClientToken	string	否	客户端Token，用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符。	123e4567-e89b-12d3-a456-426****
DryRun	boolean	否	是否只预检此次请求。取值： true：发送检查请求，不会修改流量标记策略的名称，描述信息以及流分类规则。检查项包括是否填写了必需参数、请求格式、业务限制等。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码`DryRunOperation`。 false（默认值）：发送正常请求，通过检查后直接修改流量标记策略的名称，描述信息以及流分类规则	false
TrafficMarkingPolicyId	string	是	流量标记策略ID。	tm-u9nxup5kww5po8****
TrafficMarkingPolicyName	string	否	流量标记策略的新名称。名称长度为2~128个字符，以大小写字母或中文开头，可包含数字、短划线（-）和下划线（_）。	nametest
TrafficMarkingPolicyDescription	string	否	流量标记策略新的描述信息。描述信息的长度为2~128个字符，以大小写字母或中文开头，可包含数字、短划线（-）和下划线（_）。	desctest
AddTrafficMatchRules	object []	否	增加的流分类规则列表。
MatchDscp	integer	否	流量报文的DSCP值。取值范围：0~63。流分类规则匹配包含指定DSCP值的流量，如果不设置则代表使流分类规则匹配任意DSCP值的流量。说明当前DSCP值是指流量报文进入跨地域连接前已携带的DSCP值。一次最多支持创建50个流分类规则，每个流分类规则可指定匹配一个DSCP值。	1
DstCidr	string	否	流量报文的目的网段。流分类匹配目的IP地址在目的网段中的流量，如果不设置则代表使流分类规则匹配任意目的IP地址的流量。一次最多支持创建50个流分类规则，每个流分类规则可指定一个目的网段。	172.30.0.0/24
TrafficMatchRuleDescription	string	否	流分类规则的描述信息。一次最多支持创建50个流分类规则，每个流分类规则可添加一个描述信息。描述信息的长度为2~128个字符，以大小写字母或中文开头，可包含数字、短划线（-）和下划线（_）。	test1
Protocol	string	否	流量报文的协议类型。流量标记策略支持匹配HTTP、HTTPS、TCP、UDP、SSH、Telnet等多种协议类型的流量。更多协议类型，请登录云企业网管理控制台查看。一次最多支持创建50个流分类规则，每个流分类规则可指定匹配一个协议类型。	UDP
DstPortRange	array	否	流量报文的目的端口。取值范围：-1、1~65535。流分类规则匹配目的端口号在目的端口范围中的流量，如果不设置则代表使流分类规则匹配任意目的端口号的流量。当前参数最多支持输入两个端口号。输入格式说明如下：如果您只输入一个端口号，例如1，则系统默认匹配目的端口为1的流量。如果您输入了两个端口号，例如1和200，则系统默认匹配目的端口处于1至200范围内的流量。如果您输入了两个端口号且其中一个端口号为-1，则另一个端口也必须为-1，表示匹配任意目的端口。一次最多支持创建50个流分类规则，每个流分类规则可指定一个目的端口范围。
	integer	否	流量报文的目的端口。取值范围：-1、1~65535。流分类规则匹配目的端口号在目的端口范围中的流量，如果不设置则代表使流分类规则匹配任意目的端口号的流量。当前参数最多支持输入两个端口号。输入格式说明如下：如果您只输入一个端口号，例如1，则系统默认匹配目的端口为1的流量。如果您输入了两个端口号，例如1和200，则系统默认匹配目的端口处于1至200范围内的流量。如果您输入了两个端口号且其中一个端口号为-1，则另一个端口也必须为-1，表示匹配任意目的端口。一次最多支持创建50个流分类规则，每个流分类规则可指定一个目的端口范围。	77
SrcCidr	string	否	流量报文的源网段。流分类规则匹配源IP地址在源网段中的流量，如果不设置则代表使流分类规则匹配任意源IP地址的流量。一次最多支持创建50个流分类规则，每个流分类规则可指定匹配一个源网段。	10.128.32.0/19
SrcPortRange	array	否	流量报文的源端口。取值范围：-1、1~65535。流分类规则匹配源端口号在源端口范围中的流量，如果不设置则代表使流分类规则匹配任意源端口。当前参数最多支持输入两个端口号。输入格式说明如下：如果您只输入一个端口号，例如1，则系统默认匹配源端口为1的流量。如果您输入了两个端口号，例如1和200，则系统默认匹配源端口处于1至200范围内的流量。如果您输入了两个端口号且其中一个端口号为-1，则另一个端口也必须为-1，表示匹配任意源端口。一次最多支持创建50个流分类规则，每个流分类规则可指定一个源端口范围。
	integer	否	流量报文的源端口。取值范围：-1、1~65535。流分类规则匹配源端口号在源端口范围中的流量，如果不设置则代表使流分类规则匹配任意源端口。当前参数最多支持输入两个端口号。输入格式说明如下：如果您只输入一个端口号，例如1，则系统默认匹配源端口为1的流量。如果您输入了两个端口号，例如1和200，则系统默认匹配源端口处于1至200范围内的流量。如果您输入了两个端口号且其中一个端口号为-1，则另一个端口也必须为-1，表示匹配任意源端口。一次最多支持创建50个流分类规则，每个流分类规则可指定一个源端口范围。	22
TrafficMatchRuleName	string	否	流分类规则的名称。一次最多支持创建50个流分类规则，每个流分类规则可添加一个名称。名称长度为2~128个字符，以大小写字母或中文开头，可包含数字、短划线（-）和下划线（_）。	广州测试
DeleteTrafficMatchRules	object []	否	删除的流分类规则列表。
MatchDscp	integer	否	流量报文的DSCP值。	3
DstCidr	string	否	流量报文的目标网段。	192.168.200.3/32
TrafficMatchRuleDescription	string	否	流分类规则的描述信息。	杭州区连青岛区CAT
Protocol	string	否	流量报文的协议类型。流分类规则支持匹配HTTP、HTTPS、TCP、UDP、SSH、Telnet等多种协议类型的流量。更多协议类型，请登录云企业网管理控制台查看。	TCP
DstPortRange	array	否	流量报文的目的端口。取值范围：-1、1~65535。
	integer	否	流量报文的目的端口。取值范围：-1、1~65535。	22
SrcCidr	string	否	流量报文的源网段。	10.72.0.0/16
SrcPortRange	array	否	流量报文的源端口。取值范围：-1、1~65535。
	integer	否	流量报文的源端口。取值范围：-1、1~65535。	23
TrafficMatchRuleName	string	否	流分类规则的名称。	test

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求ID。	60BB11B2-7BF4-54DC-BCC9-F706E1EB02AC

示例

正常返回示例

JSON格式

{
  "RequestId": "60BB11B2-7BF4-54DC-BCC9-F706E1EB02AC"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidTrafficMarkingPolicyId.NotFound	TrafficMarkingPolicyId is not found.	参数中指定的TrafficMarkingPolicyId不存在。
400	IncorrectStatus.TrafficMarkingPolicy	The status of TrafficMarkingPolicy is incorrect.	当前TrafficMarkingPolicy的状态不支持该操作，请稍后重试。
400	Duplicated.AddTrafficMatchRules	The parameter AddTrafficMatchRules are duplicated.	-
400	Duplicated.DeleteTrafficMatchRulese	The parameter DeleteTrafficMatchRules are duplicated.	-
400	InstanceExist.AddTrafficMatchRules	The instance already exists.	指定实例已经存在。
400	Duplicated.AddTrafficMatchRulesAndDeleteTrafficMatchRules	The same rule in AddTrafficMatchRules and DeleteTrafficMatchRules is not supported..	AddTrafficMatchRules和DeleteTrafficMatchRules不允许存在相同的条目，请先删除后添加。
400	InvalidParameter	Invalid parameter.	参数不合法。
400	Unauthorized	The AccessKeyId is unauthorized.	账号无权限操作。
404	InvalidDeleteTrafficMatchRules.NotFound	The specified DeleteTrafficMatchRules are not found.	参数中指定的DeleteTrafficMatchRules不存在。

访问错误中心查看更多错误码。

变更历史

变更时间

变更内容概要

操作

2023-01-09

OpenAPI 错误码发生变更，OpenAPI 入参发生变更

看变更集

变更项	变更内容
错误码	OpenAPI 错误码发生变更
	删除错误码：400
	删除错误码：404
入参	OpenAPI 入参发生变更
	新增入参：AddTrafficMatchRules
	新增入参：DeleteTrafficMatchRules

2021-11-26

新增 OpenAPI

看变更集