修改消息模板
功能介绍
该接口用于修改通知模板,根据名称进行修改。
URI
PUT /v2/{project_id}/{domain_id}/lts/events/notification/templates
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方式请参见:获取项目ID,获取账号ID,日志组ID、日志流ID 最小长度:32 最大长度:32 |
domain_id |
是 |
String |
账号ID,获取方式请参见:获取项目ID,获取账号ID,日志组ID、日志流ID 最小长度:32 最大长度:32 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token,获取方式请参见:获取用户Token 最小长度:1000 最大长度:2000 |
Content-Type |
是 |
String |
该字段填为:application/json;charset=UTF-8。 最小长度:30 最大长度:30 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
通知规则名称,创建后不可修改 最小长度:1 最大长度:100 |
type |
否 |
Array of strings |
通知方式 |
desc |
否 |
String |
模板描述,必填,只含有汉字、数字、字母、下划线不能以下划线开头和结尾,长度为0--1024 最小长度:0 最大长度:1024 |
source |
是 |
String |
模板来源,目前必填为LTS,否则会筛选不出来 最小长度:3 最大长度:3 |
locale |
是 |
String |
语言类型
|
templates |
是 |
Array of UpdateSubTemplate objects |
模板正文,为一个数组 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
sub_type |
是 |
String |
模板子类型,例如sms,email |
content |
是 |
String |
子模版正文,$符号后所跟变量仅支持以下变量,不同告警类型所支持的变量亦不相同。目前关键词告警类型的变量如下:
说明:
变量后面的分号";"为英文符号,必须添加,否则模板会出现替换失败的情况。 |
topic |
否 |
String |
邮件主题,只有sub_type=email时生效 |
响应参数
状态码:201
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
通知规则名称 |
type |
Array of strings |
通知方式 |
desc |
String |
模板描述 |
source |
String |
模板来源 |
locale |
String |
语言 |
templates |
Array of SubTemplateResBody objects |
模板正文,为一个数组 |
参数 |
参数类型 |
描述 |
---|---|---|
sub_type |
String |
模板子类型,例如sms,email |
content |
String |
子模版正文,$符号后所跟变量仅支持以下变量,根据不同告警类型(关键词告警和sql告警),所支持的变量亦不相同。 |
topic |
String |
邮件主题,只有sub_type=email时生效 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
调用失败响应信息描述。 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
调用失败响应信息描述。 |
请求示例
修改消息模板
PUT https://{endpoint}/v2/{project_id}/{domain_id}/lts/events/notification/templates { "name" : "alarm-template", "desc" : "test", "source" : "LTS", "locale" : "en-us", "templates" : [ { "sub_type" : "sms", "content" : "告警级别:${event_severity};\n发生时间:${starts_at};\n资源标识:${resources};\n统计类型:关键词统计;\n表达式:$event.annotations.condition_expression;\n当前值: $event.annotations.current_value;\n统计周期:$event.annotations.frequency;" }, { "sub_type" : "email", "content" : "告警级别:${event_severity};\n发生时间:${starts_at};\n告警源:$event.metadata.resource_provider;\n资源类型:$event.metadata.resource_type;\n资源标识:${resources};\n统计类型:关键词统计;\n表达式:$event.annotations.condition_expression;\n当前值: $event.annotations.current_value;\n统计周期:$event.annotations.frequency;\n查询时间:$event.annotations.results[0].time;\n查询日志:$event.annotations.results[0].raw_results;" } ] }
响应示例
状态码:201
请求响应成功。
{ "desc" : "description", "locale" : "en-us", "name" : "postman-test1", "source" : "LTS", "templates" : [ { "content" : "告警级别:${event_severity};\n发生时间:${starts_at};\n资源标识:${resources};\n统计类型:关键词统计;\n表达式:$event.annotations.condition_expression;\n当前值: $event.annotations.current_value;\n统计周期:$event.annotations.frequency;", "sub_type" : "sms" }, { "content" : "告警级别:${event_severity};\n发生时间:${starts_at};\n告警源:$event.metadata.resource_provider;\n资源类型:$event.metadata.resource_type;\n资源标识:${resources};\n统计类型:关键词统计;\n表达式:$event.annotations.condition_expression;\n当前值: $event.annotations.current_value;\n统计周期:$event.annotations.frequency;\n查询时间:$event.annotations.results[0].time;\n查询日志:$event.annotations.results[0].raw_results;", "sub_type" : "email" } ] }
状态码:400
BadRequest 非法请求 建议根据error_msg直接修改该请求。
{ "error_code" : "LTS.2016", "error_msg" : "desc is invalid!" }
状态码:500
表明服务端能被请求访问到,但是服务内部出错。
{ "error_code" : "LTS.2016", "error_msg" : "Failed to update notification template" }
状态码
状态码 |
描述 |
---|---|
201 |
请求响应成功。 |
400 |
BadRequest 非法请求 建议根据error_msg直接修改该请求。 |
500 |
表明服务端能被请求访问到,但是服务内部出错。 |
错误码
请参见错误码。