调用CreateRouteRule创建流转规则-阿里云帮助中心

调试

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

请求语法

POST /routeRule/save HTTP/1.1
Content-Type:application/json

{
  "ruleName" : "String",
  "enableStatus" : "String",
  "relatedServiceId" : Long,
  "routeType" : "String",
  "incidentLevel" : "String",
  "assignObjectId" : Long,
  "assignObjectType" : "String",
  "effection" : "String",
  "timeWindow" : Long,
  "matchCount" : Integer,
  "timeWindowUnit" : "String",
  "routeChildRules" : [ {
    "monitorSourceId" : Long,
    "conditions" : [ {
      "key" : "String",
      "value" : "String",
      "operationSymbol" : "String"
    } ],
    "childConditionRelation" : Long
  } ],
  "notifyChannels" : [ "String" ],
  "clientToken" : "String",
  "childRuleRelation" : "String"
}

请求参数

表 1. 请求Body参数
参数名称	类型	是否必选	示例	说明
ruleName	String	是	规则名称	流转规则名字
enableStatus	String	否	启用禁用状态	启用状态
relatedServiceId	Long	是	100	关联服务ID
routeType	String	是	INCIDENT	路由类型：INCIDENT 触发事件 ALERT 仅触发报警
incidentLevel	String	是	P1	事件级别 P1 P2 P3 P4
assignObjectId	Long	是	65	事件分派对象ID（服务组ID 或用户ID）
assignObjectType	String	是	SERVICEGROUP	事件分派对象类型 SERVICEGROUP 服务组 USER 单个用户
effection	String	是	LOW	影响程度 LOW-一般 HIGH-严重
timeWindow	Long	是	2	时间窗口
matchCount	Integer	是	3	命中次数
timeWindowUnit	String	是	MINUTE	时间窗口单位 MINUTE 分钟
routeChildRules	Array	是		子规则数组
monitorSourceId	Long	是	1	监控源ID
conditions	Array	是		匹配条件列表
key	String	是	payload.summary	匹配key
value	String	是	123	匹配value
operationSymbol	String	是	equals	操作符
childConditionRelation	Long	否	0	0-与，1-或
notifyChannels	Array of String	是	[SMS,PHONE]	通知渠道 SMS 短信，PHONE 语音，EMAIL 邮件，WEBHOOK 群通知
clientToken	String	否	C4BE3837-1A13-413B-A225-2C88188E8A43	幂等号
childRuleRelation	String	是	AND	子规则关系AND，OR

响应体语法

HTTP/1.1 200 OK
Content-Type:application/json

{
  "requestId" : "String",
  "data" : {
    "routeRuleId" : Long
  }
}

响应参数

表 2. 响应Body参数
参数名称	类型	示例	说明
requestId	String	请求ID	请求
data	Object		返回结果
routeRuleId	Long	1000	规则ID

示例1

POST /routeRule/save HTTP/1.1
Host:gemp.cn-shanghai.aliyuncs.com
Content-Type:application/json

{
  "ruleName" : "规则名称",
  "enableStatus" : "启用禁用状态",
  "relatedServiceId" : 100,
  "routeType" : "INCIDENT",
  "incidentLevel" : "P1",
  "assignObjectId" : 65,
  "assignObjectType" : "SERVICEGROUP",
  "effection" : "LOW",
  "timeWindow" : 2,
  "matchCount" : 3,
  "timeWindowUnit" : "MINUTE",
  "routeChildRules" : [ {
    "monitorSourceId" : 1,
    "conditions" : [ {
      "key" : "payload.summary",
      "value" : "123",
      "operationSymbol" : "equals"
    } ],
    "childConditionRelation" : 0
  } ],
  "notifyChannels" : [ "[SMS,PHONE]" ],
  "clientToken" : "C4BE3837-1A13-413B-A225-2C88188E8A43",
  "childRuleRelation" : "AND"
}

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateRouteRuleResponse>
    <requestId>请求ID</requestId>
    <data>
        <routeRuleId>1000</routeRuleId>
    </data>
</CreateRouteRuleResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码


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

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

开发者资源

SDK
阿里云为您提供多种语言的SDK，帮助您快速通过API集成阿里云的产品和服务，推荐您使用SDK调用API，已免除您手动签名验证。
OpenAPI Explorer
快速检索，可视化调试API，在线命令行工具，同步动态生成可执行的SDK代码示例。
阿里云CLI
阿里云资产管理和配置工具，可通过命令方式同时管理多个阿里云产品和服务，简单快捷，是您上云好帮手。