检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询主题详情 功能介绍 查询Topic的详细信息。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/notifications/topics/{topic_urn} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
订阅操作 查询订阅者列表 查询指定Topic的订阅者列表 订阅 取消订阅 更新订阅者 父主题: API
新增/修改/删除主题标签 操作场景 标签由标签“键”和标签“值”组成,用于标识云资源,可对云资源进行分类和搜索。 一个标签的“键”可以拥有多个标签“值”。 一个云资源不能拥有重复的标签“键”。 创建主题标签 登录管理控制台。 在管理控制台左上角单击图标,选择区域和项目。 在页面左上角单击图标
删除资源标签 功能介绍 幂等接口:删除时,不对标签做校验。删除的key不存在报404,key不能为空或者空字符串。 调用方法 请参见如何调用API。 URI DELETE /v2/{project_id}/{resource_type}/{resource_id}/tags/{key
删除通知策略 功能介绍 删除通知策略 调用方法 请参见如何调用API。 URI DELETE /v2/{project_id}/notifications/topics/{topic_urn}/notify-policy/{notify_policy_id} 表1 路径参数 参数
附录 Topic属性表 通用请求返回值 错误码 Cmpp发送状态描述表 国家码和地区码
权限及授权项说明 如果您需要对您所拥有的消息通知服务(Simple Message Notification)进行精细的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),如果华为云账号已经能满足您的要求,不需要创建独立的
创建用户并授权使用SMN 如果您需要对您所拥有的SMN进行精细的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),通过IAM,您可以: 根据企业的业务组织,在您的华为云账号中,给企业中不同职能部门的员工创建IAM用户,
约束与限制 当您通过消息通知服务SMN发送邮件、短信等消息时,您需要确保传输的内容符合当地法律法规要求。 SMN使用异步方式推送消息,不保证消息送达的时效性。如果业务要求消息准实时送达,请慎重考虑是否使用SMN服务。 SMN服务发送消息的邮箱地址和发送短信/语音的号码地址不固定,有切换的可能
授权操作与SMN接口的映射关系 表1 授权操作与SMN接口的映射关系 授权操作 接口名称 接口功能 SMN:UpdateTopic UpdateTopic 修改主题的属性,目前仅支持修改topic的display_name字段。 SMN:DeleteTopic DeleteTopic
HTTP(S)消息格式 操作场景 接收SMN服务发送的HTTP(S)消息时,终端证书的CN名称请参考业界规范,部分特殊字符可能导致https消息发送失败。 在互联网上传递未加密的http协议消息内容存在信息泄漏风险,推荐用户终端添加订阅时对接通道优先使用https类型。 描述SMN
向主题发布文本消息 操作场景 文本消息是指将消息内容以文本的形式发送到订阅终端。 前提条件 所有的订阅终端必须确认订阅才能收到推送消息,未确认的订阅终端不会收到消息。 操作步骤 登录管理控制台。 在管理控制台左上角单击图标,选择区域和项目。 在页面左上角单击图标,选择“管理与监管”
模板格式消息说明 模板格式消息指固定格式的消息,可以通过tag的方式来处理变量的部分。 通过模板发送消息,建议消息大小不超过256KB,模板格式消息如下所示: { "message_template_name":"confirm_message", "tags":{
权限管理 如果您需要对华为云上创建或购买的SMN资源,为企业中的员工设置不同的访问权限,以达到不同员工之间的权限隔离,您可以使用统一身份认证服务(Identity and Access Management,简称IAM)进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能
消息模板管理 操作场景 消息模板指消息的固定格式,发布消息时可以使用已创建的消息模板向订阅者发送消息。使用模板发送消息,发送时会自动替换模板变量为对应的参数值。 消息模板通过消息名称进行分组,消息名称下面可以根据不同的协议创建不同的模板。每个模板名称下面都必须要创建一个Default
状态码 表1 正常返回值 返回值 说明 200 任务提交成功 201 创建成功 表2 异常返回值 返回值 说明 400 Bad Request 请求参数错误。 401 Unauthorized 鉴权失败。 403 Forbidden 没有权限对资源访问。 404 Not Found
API概览 通过使用消息通知服务所提供的接口,您可以完整的使用消息通知服务的所有功能。例如创建Topic、添加订阅。 表1 接口说明 类型 说明 主题操作 包含创建主题、更新主题、删除主题等接口。 订阅操作 包含查询订阅列表、订阅、取消订阅等接口。 模板操作 包含创建消息模板、更新消息模板
记录消息通知服务 记录消息通知服务简介 支持审计的关键操作列表 查询审计事件
主题操作 查询主题列表 创建主题 查询主题详情 更新主题 删除主题 查询主题策略 删除所有主题策略 更新主题策略 删除指定名称的主题策略 父主题: API
请求订阅 操作场景 创建订阅用户完成后,用户需要向订阅终端发送请求订阅,请求订阅的流控规则请见订阅确认流控说明。可一次向一个订阅终端发送确认请求。 操作步骤 登录管理控制台。 在管理控制台左上角单击图标,选择区域和项目。 在页面左上角单击图标,选择“管理与监管” > “消息通知服务