更新通知订阅。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求头
该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。
请求语法
POST /notify/subscription/update HTTP/1.1
请求参数
名称 | 类型 | 位置 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|---|
Object | Body | 否 | A short description of struct |
||
subscriptionId | Long | Body | 是 | 80002020 | 主键 |
subscriptionTitle | String | Body | 是 | newSubs244 | 通知订阅名称 |
scope | String | Body | 是 | SERVICE | 订阅范围类型 |
notifyObjectType | String | Body | 是 | USER | 通知对象类型 |
expiredType | String | Body | 是 | LONG_TERM | 订阅时效 |
period | String | Body | 否 | 20天 | 订阅时效 |
scopeObjectList | Array | Body | 是 | 订阅范围列表 |
|
id | Long | Body | 否 | 1 | 主键id |
scopeObjectId | Long | Body | 是 | 1 | 订阅范围对象id |
notifyObjectList | Array | Body | 是 | 通知对象列表 |
|
id | Long | Body | 否 | 10 | 主键id |
notifyObjectId | Long | Body | 是 | 19 | 通知对象id |
notifyStrategyList | Array | Body | 是 | 通知策略列表 |
|
instanceType | Long | Body | 是 | INCIDENT | 订阅实例类型,事件、报警、故障 |
strategies | Array | Body | 是 | 通知策略 |
|
id | String | Body | 否 | 10 | 报警等级 |
channels | String | Body | 否 | SMS,WEIXIN_GROUP | 故障等级 |
conditions | Array | Body | 否 | 影响程度 |
|
level | String | Body | 否 | P1 | 等级 |
effection | String | Body | 否 | HIGH | 影响程度 |
problemNotifyType | String | Body | 否 | PROBLEM_NOTIFY | 故障通知类型 |
action | String | Body | 否 | INCIDENT_TRIGGER | 事件动作 |
periodChannel | Object | Body | 否 | 分时段通知订阅渠道 |
|
workday | String | Body | 否 | SMS,WEIXIN_GROUP | 工作日通知订阅渠道 |
nonWorkday | String | Body | 否 | SMS,WEIXIN_GROUP | 非工作日通知订阅渠道 |
startTime | String | Body | 否 | 2021-04-04 10:10:11 | 生效开始时间 |
endTime | String | Body | 否 | 2022-05-09 10:10:23 | 失效时间 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
requestId | String | c26f36de-1ec8-496a-a828-880676c5ef81 | id of the request |
示例
请求示例
POST /notify/subscription/update HTTP/1.1
Host:gemp.cn-shanghai.aliyuncs.com
Content-Type:application/json
{
"subscriptionId" : 80002020,
"subscriptionTitle" : "newSubs244",
"scope" : "SERVICE",
"notifyObjectType" : "USER",
"expiredType" : "LONG_TERM",
"scopeObjectList" : [ {
"id" : 1,
"scopeObjectId" : 1
} ],
"notifyObjectList" : [ {
"id" : 10,
"notifyObjectId" : 19
} ],
"notifyStrategyList" : [ {
"strategies" : [ {
"id" : "10",
"channels" : "SMS,WEIXIN_GROUP",
"conditions" : [ {
"level" : "P1",
"effection" : "HIGH"
} ]
} ]
} ]
}
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateSubscriptionResponse>
<requestId>7C56D225-7C34-40BB-9624-C8BA449260E6</requestId>
</UpdateSubscriptionResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"requestId" : "7C56D225-7C34-40BB-9624-C8BA449260E6"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
403 | NotifySubsAlreadyExists | The specified subscription already exists. | 通知订阅已存在 |
404 | NotifySubsNotExists | The specified subscription does not exist. | 通知订阅不存在 |
访问错误中心查看更多错误码。
访问错误中心查看更多错误码。