调用CreateRouteRule API创建流转规则-运维事件中心-阿里云-运维事件中心(Operations Incident Center)-阿里云帮助中心

创建流转规则。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

gemp:CreateRouteRule

create

*全部资源

*

无

请求语法

POST /routeRule/save HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	创建流转规则参数。
ruleName	string	是	流转规则名称。	规则名称
enableStatus	string	否	是否启用： disable：禁用。 enable：启用。	enable
relatedServiceId	integer	是	关联服务 ID。	100
routeType	string	是	路由类型： INCIDENT：触发事件。 ALERT：仅触发报警。	INCIDENT
incidentLevel	string	是	事件级别：P1、P2、P3、P4 递减。	P1
assignObjectId	integer	是	事件分派对象 ID（服务组 ID 或用户 ID）。	65
assignObjectType	string	是	事件分派对象类型： SERVICEGROUP：服务组。 USER：单个用户。	SERVICEGROUP
effection	string	是	影响程度： LOW：一般。 HIGH：严重。	LOW
timeWindow	integer	是	时间窗口。	2
matchCount	integer	是	命中次数。	3
timeWindowUnit	string	是	时间窗口单位： MINUTE：分钟。 SECOND：秒。	MINUTE
routeChildRules	array<object>	是	子规则数组。
	array<object>	是	子规则。
monitorSourceId	integer	是	监控源 ID。	1
conditions	array<object>	是	匹配条件列表。
	object	是	条件。
key	string	是	匹配 key。	payload.summary
value	string	是	匹配 value。	123
operationSymbol	string	是	操作符。	equals
childConditionRelation	integer	否	0：与。 1：或。	0
problemLevel	string	否	故障级别：P1、P2、P3、P4 递降。	P1
notifyChannels	array	是	通知渠道列表。
	string	是	通知渠道： SMS：短信。 PHONE：语音。 EMAIL：邮件。 WEBHOOK：群通知。	[SMS,PHONE]
clientToken	string	否	幂等号。	C4BE3837-1A13-413B-A225-2C88188E8A43
childRuleRelation	string	是	子规则关系： AND：与。 OR：或。	AND
problemLevelGroup	object	否	故障等级组。
	object	否	故障等级。
childRuleRelation	integer	否	子规则关系： 0：与。 1：或。	1
matchCount	integer	否	抑制：命中次数。	1
timeWindow	integer	否	抑制：时间窗口。	5
timeWindowUnit	string	否	抑制：时间窗口单位。	M
enableUpgrade	boolean	否	升级：是否升级。	false
upgradeTimeWindow	integer	否	升级：时间窗口。	5
upgradeTimeWindowUnit	string	否	升级：时间窗口单位。	M
coverageProblemLevels	array	否	故障等级覆盖。
	string	否	故障等级类型。	P1
problemEffectionServices	array	否	故障影响服务。
	integer	否	影响服务 ID。	1
convergenceFields	array	否	收敛字段集合。
	string	否	收敛字段集合。	app
convergenceType	integer	否	收敛类型： 0：流转规则收敛。 1：字段收敛。	0

返回参数

名称	类型	描述	示例值
	object	响应结构。
requestId	string	请求 ID。	请求ID
data	object	返回结果。	65
routeRuleId	integer	规则 ID。	1000

示例

正常返回示例

JSON格式

{
  "requestId": "请求ID",
  "data": {
    "routeRuleId": 1000
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	AddRouteRuleFail	Failed to add the rule.	添加流转规则失败
400	RouteRuleNameAlreadyExisted	The rule name already exists.	流转规则名称已存在

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

变更历史

更多信息，参考变更详情。