文档首页/ 消息通知服务 SMN/ API参考（联盟区域）/ API/ 订阅过滤策略操作/ 批量更新订阅过滤策略
更新时间：2025-12-30 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量更新订阅过滤策略

功能介绍

更新订阅者的消息过滤策略。

调用方法

请参见如何调用API。

URI

PUT /v2/{project_id}/notifications/subscriptions/filter_polices

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。获取项目ID请参考 获取项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

polices

是

Array of polices objects

批量处理订阅者策略列表。
表4 polices

参数

是否必选

参数类型

描述

subscription_urn

是

String

订阅者的唯一的资源标识，可通过查询订阅者列表获取该标识。

filter_polices

是

Array of SubscriptionsFilterPolicy objects

订阅者的过滤策略。策略name不能重复
表5 SubscriptionsFilterPolicy

参数

是否必选

参数类型

描述

name

是

String

过滤策略名称。

包含小写英文字母([a-z])、数字([0-9])、下划线(_)，下划线不得开始、结尾或连续出现），长度限制{1,32}，不能是smn_开头。

string_equals

是

Array of strings

字符串精确匹配数组。数组长度[1, 10]，数组内容不能重复，值不能为null或者空字符串“ ”，长度限制[1,32]，中英文、数字、下划线

响应参数

状态码：200

表6 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

batch_result

Array of BatchResult objects

批量结果
表7 BatchResult

参数

参数类型

描述

code

String

执行结果code

message

String

执行结果message

subscription_urn

String

订阅者urn

状态码：400

表8 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

状态码：403

表9 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

状态码：404

表10 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

状态码：500

表11 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

请求示例

更新订阅消息过滤策略

PUT https://{SMN_Endpoint}/v2/{project_id}/notifications/subscriptions/filter_polices

{
  "polices" : [ {
    "subscription_urn" : "urn:smn:regionId:762bdb3251034f268af0e395c53ea09b:test_topic_v1:2e778e84408e44058e6cbc6d3c377837",
    "filter_polices" : [ {
      "name" : "alarm",
      "string_equals" : [ "os", "process" ]
    }, {
      "name" : "service",
      "string_equals" : [ "api", "db" ]
    } ]
  } ]
}

响应示例

状态码：200

OK

{
  "request_id" : "be368401641b406d8c28a79915ba3589",
  "batch_result" : [ {
    "code" : "SMN.00011027",
    "message" : "Parameter: subscription_urn is invalid.",
    "subscription_urn" : "urn:smn:regionId:98386b0630aa41d990d4729497fcd7ba:test:90b22be1efab4cd6924703c5b228e59f"
  }, {
    "code" : "SMN.00011027",
    "message" : "Parameter: subscription_urn is invalid.",
    "subscription_urn" : "urn:smn:regionId:98386b0630aa41d990d4729497fcd7ba:test:c872b769e60d45f682f1da44eb4dbee3"
  } ]
}

状态码

状态码

描述

200

OK

400

Bad Request

403

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。