文档

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

更新时间:

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

调试

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

授权信息

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

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

请求参数

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

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

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

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

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

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

流量标记策略 ID。

tm-u9nxup5kww5po8****
TrafficMarkingPolicyNamestring

流量标记策略的新名称。

名称可以为空或长度为 1~128 个字符,不能以 http://或 https://开头。

nametest
TrafficMarkingPolicyDescriptionstring

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

描述可以为空或长度为 1~256 个字符,不能以 http://或 https://开头。

desctest
AddTrafficMatchRulesobject []

增加的流分类规则列表。

一次最多支持添加 50 个流分类规则。

MatchDscpinteger

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

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

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

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

1
DstCidrstring

流量报文的目的网段。

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

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

172.30.0.0/24
TrafficMatchRuleDescriptionstring

流分类规则的描述信息。

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

描述可以为空或长度为 1~256 个字符,不能以 http://或 https://开头。

test1
Protocolstring

流量报文的协议类型。

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

部分协议拥有固定的端口。单击查看端口详情。
  • 协议类型为 ICMP 时,目的端口号需指定为-1
  • 协议类型为 GRE 时,目的端口号需指定为-1
  • 协议类型为 SSH 时,目的端口号需指定为 22
  • 协议类型为 Telnet 时,目的端口号需指定为 23
  • 协议类型为 HTTP 时,目的端口号需指定为 80
  • 协议类型为 HTTPS 时,目的端口号需指定为 443
  • 协议类型为MS SQL 时,目的端口号需指定为 1443
  • 协议类型为 Oracle 时,目的端口号需指定为 1521
  • 协议类型为 Mysql 时,目的端口号需指定为 3306
  • 协议类型为 RDP 时,目的端口号需指定为 3389
  • 协议类型为Postgre SQL时,目的端口号需指定为 5432
  • 协议类型为 Redis 时,目的端口号需指定为 6379

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

UDP
DstPortRangearray

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

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

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

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

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

integer

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

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

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

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

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

22
TrafficMatchRuleNamestring

流分类规则的名称。

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

名称可以为空或长度为 1~128 个字符,不能以 http://或 https://开头。

广州测试
DeleteTrafficMatchRulesobject []

删除的流分类规则列表。

说明 请您要尽可能添加完整的流分类规则信息比如源网段、目标网段、源端口、目标端口、DSCP 值等,否则系统可能定位不到要删除的流分类规则,则不会删除目标流分类规则列表。
MatchDscpinteger

流量报文的 DSCP 值。

3
DstCidrstring

流量报文的目标网段。

192.168.200.3/32
TrafficMatchRuleDescriptionstring

流分类规则的描述信息。

描述可以为空或长度为 1~256 个字符,不能以 http://或 https://开头。

杭州区连青岛区CAT
Protocolstring

流量报文的协议类型。

您可以调用 ListTrafficMarkingPolicies 接口查询要删除的流分类规则的详细信息。

TCP
DstPortRangearray

流量报文的目的端口。

integer

流量报文的目的端口。

22
SrcCidrstring

流量报文的源网段。

10.72.0.0/16
SrcPortRangearray

流量报文的源端口。

integer

流量报文的源端口。

23
TrafficMatchRuleNamestring

流分类规则的名称。

名称可以为空或长度为 1~128 个字符,不能以 http://或 https://开头。

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不允许存在相同的条目,请先删除后添加。
400IllegalParam.DstPortRangeThe specified DstPortRange is illegal.目的端口不合法
400IllegalParam.SrcPortRangeThe specified SrcPortRange is illegal.源端口不合法
400InvalidParameterInvalid parameter.参数不合法。
400UnauthorizedThe AccessKeyId is unauthorized.账号无权限操作。
404InvalidDeleteTrafficMatchRules.NotFoundThe specified DeleteTrafficMatchRules are not found.参数中指定的DeleteTrafficMatchRules不存在。

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

变更历史

变更时间变更内容概要操作
2024-04-19OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:404
2024-03-15OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:404
2023-09-08OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:404
2023-01-09OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:404
入参OpenAPI 入参发生变更
    新增入参:AddTrafficMatchRules
    新增入参:DeleteTrafficMatchRules
2021-11-26新增 OpenAPI看变更集