首页 云企业网 开发参考 API参考 API目录 流量调度 流量标记策略 UpdateTrafficMarkingPolicyAttribute - 修改流量标记策略的名称,描述信息以及流分类规则

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

更新时间: 2023-08-31 10:53:56

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

调试

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

调试

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
cen:UpdateTrafficMarkingPolicyAttribute
  • CEN
    acs:cen:*:{#accountId}:ceninstance/{#CenId}

请求参数

名称类型必填描述示例值
ClientTokenstring

客户端Token,用于保证请求的幂等性。

由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符。

123e4567-e89b-12d3-a456-426****
DryRunboolean

是否只预检此次请求。取值:

  • true:发送检查请求,不会修改流量标记策略的名称,描述信息以及流分类规则。检查项包括是否填写了必需参数、请求格式、业务限制等。如果检查不通过,则返回对应错误。如果检查通过,则返回错误码DryRunOperation
  • false(默认值):发送正常请求,通过检查后直接修改流量标记策略的名称,描述信息以及流分类规则
false
TrafficMarkingPolicyIdstring

流量标记策略ID。

tm-u9nxup5kww5po8****
TrafficMarkingPolicyNamestring

流量标记策略的新名称。

名称长度为2~128个字符,以大小写字母或中文开头,可包含数字、短划线(-)和下划线(_)。

nametest
TrafficMarkingPolicyDescriptionstring

流量标记策略新的描述信息。

描述信息的长度为2~128个字符,以大小写字母或中文开头,可包含数字、短划线(-)和下划线(_)。

desctest
AddTrafficMatchRulesobject []

增加的流分类规则列表。

MatchDscpinteger

流量报文的DSCP值。取值范围:0~63

流分类规则匹配包含指定DSCP值的流量,如果不设置则代表使流分类规则匹配任意DSCP值的流量。

说明 当前DSCP值是指流量报文进入跨地域连接前已携带的DSCP值。

一次最多支持创建50个流分类规则,每个流分类规则可指定匹配一个DSCP值。

1
DstCidrstring

流量报文的目的网段。

流分类匹配目的IP地址在目的网段中的流量,如果不设置则代表使流分类规则匹配任意目的IP地址的流量。

一次最多支持创建50个流分类规则,每个流分类规则可指定一个目的网段。

172.30.0.0/24
TrafficMatchRuleDescriptionstring

流分类规则的描述信息。

一次最多支持创建50个流分类规则,每个流分类规则可添加一个描述信息。

描述信息的长度为2~128个字符,以大小写字母或中文开头,可包含数字、短划线(-)和下划线(_)。

test1
Protocolstring

流量报文的协议类型。

流量标记策略支持匹配HTTPHTTPSTCPUDPSSHTelnet等多种协议类型的流量。更多协议类型,请登录云企业网管理控制台查看。

一次最多支持创建50个流分类规则,每个流分类规则可指定匹配一个协议类型。

UDP
DstPortRangearray

流量报文的目的端口。取值范围:-11~65535

流分类规则匹配目的端口号在目的端口范围中的流量,如果不设置则代表使流分类规则匹配任意目的端口号的流量。

当前参数最多支持输入两个端口号。输入格式说明如下:

  • 如果您只输入一个端口号,例如1,则系统默认匹配目的端口为1的流量。
  • 如果您输入了两个端口号,例如1和200,则系统默认匹配目的端口处于1至200范围内的流量。
  • 如果您输入了两个端口号且其中一个端口号为-1,则另一个端口也必须为-1,表示匹配任意目的端口。

一次最多支持创建50个流分类规则,每个流分类规则可指定一个目的端口范围。

integer

流量报文的目的端口。取值范围:-11~65535

流分类规则匹配目的端口号在目的端口范围中的流量,如果不设置则代表使流分类规则匹配任意目的端口号的流量。

当前参数最多支持输入两个端口号。输入格式说明如下:

  • 如果您只输入一个端口号,例如1,则系统默认匹配目的端口为1的流量。
  • 如果您输入了两个端口号,例如1和200,则系统默认匹配目的端口处于1至200范围内的流量。
  • 如果您输入了两个端口号且其中一个端口号为-1,则另一个端口也必须为-1,表示匹配任意目的端口。

一次最多支持创建50个流分类规则,每个流分类规则可指定一个目的端口范围。

77
SrcCidrstring

流量报文的源网段。

流分类规则匹配源IP地址在源网段中的流量,如果不设置则代表使流分类规则匹配任意源IP地址的流量。

一次最多支持创建50个流分类规则,每个流分类规则可指定匹配一个源网段。

10.128.32.0/19
SrcPortRangearray

流量报文的源端口。取值范围:-11~65535

流分类规则匹配源端口号在源端口范围中的流量,如果不设置则代表使流分类规则匹配任意源端口。

当前参数最多支持输入两个端口号。输入格式说明如下:

  • 如果您只输入一个端口号,例如1,则系统默认匹配源端口为1的流量。
  • 如果您输入了两个端口号,例如1和200,则系统默认匹配源端口处于1至200范围内的流量。
  • 如果您输入了两个端口号且其中一个端口号为-1,则另一个端口也必须为-1,表示匹配任意源端口。

一次最多支持创建50个流分类规则,每个流分类规则可指定一个源端口范围。

integer

流量报文的源端口。取值范围:-11~65535

流分类规则匹配源端口号在源端口范围中的流量,如果不设置则代表使流分类规则匹配任意源端口。

当前参数最多支持输入两个端口号。输入格式说明如下:

  • 如果您只输入一个端口号,例如1,则系统默认匹配源端口为1的流量。
  • 如果您输入了两个端口号,例如1和200,则系统默认匹配源端口处于1至200范围内的流量。
  • 如果您输入了两个端口号且其中一个端口号为-1,则另一个端口也必须为-1,表示匹配任意源端口。

一次最多支持创建50个流分类规则,每个流分类规则可指定一个源端口范围。

22
TrafficMatchRuleNamestring

流分类规则的名称。

一次最多支持创建50个流分类规则,每个流分类规则可添加一个名称。

名称长度为2~128个字符,以大小写字母或中文开头,可包含数字、短划线(-)和下划线(_)。

广州测试
DeleteTrafficMatchRulesobject []

删除的流分类规则列表。

MatchDscpinteger

流量报文的DSCP值。

3
DstCidrstring

流量报文的目标网段。

192.168.200.3/32
TrafficMatchRuleDescriptionstring

流分类规则的描述信息。

杭州区连青岛区CAT
Protocolstring

流量报文的协议类型。

流分类规则支持匹配HTTPHTTPSTCPUDPSSHTelnet等多种协议类型的流量。更多协议类型,请登录云企业网管理控制台查看。

TCP
DstPortRangearray

流量报文的目的端口。取值范围:-11~65535

integer

流量报文的目的端口。取值范围:-11~65535

22
SrcCidrstring

流量报文的源网段。

10.72.0.0/16
SrcPortRangearray

流量报文的源端口。取值范围:-11~65535

integer

流量报文的源端口。取值范围:-11~65535

23
TrafficMatchRuleNamestring

流分类规则的名称。

test

返回参数

名称类型描述示例值
object

返回结果。

RequestIdstring

请求ID。

60BB11B2-7BF4-54DC-BCC9-F706E1EB02AC

示例

正常返回示例

JSON格式

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

错误码

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

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

变更历史

变更时间变更内容概要操作
2023-01-09OpenAPI 错误码发生变更,OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:404
入参OpenAPI 入参发生变更
    新增入参:AddTrafficMatchRules
    新增入参:DeleteTrafficMatchRules
2021-11-26新增 OpenAPI看变更集
阿里云首页 云企业网 相关技术圈