# 消息通知服务 SMN > 依据用户的需求主动推送通知消息 ## 产品介绍 - [图解消息通知服务](https://support.huaweicloud.com/productdesc-smn/smn_01_0001.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [什么是消息通知服务](https://support.huaweicloud.com/productdesc-smn/zh-cn_topic_0043394877.md): 消息通知服务(Simple Message Notification,SMN)是可靠的、可扩展的、海量的消息处理服务。它可以依据用户的需求主动推送通知消息,最终用户可以通过短信、电子邮件等方式接收。SMN的主题订阅模型,旨在提供一对多的消息订阅以及通知功能,能够实现一站式集成多种推送通知方式。在SMN中有两种类型的客户端,即发布者和订阅者 - [产品优势](https://support.huaweicloud.com/productdesc-smn/smn_pd_23000.md): 对比其他传统消息中间件组件,消息通知服务的核心优势如表1所示。 - [应用场景](https://support.huaweicloud.com/productdesc-smn/smn_pd_22000.md): 系统告警系统告警是由预定义阈值触发的通知,通过邮件、短信、FunctionGraph(函数)、HTTP和HTTPS等多种通知方式发送给特定用户。举例来说,很多云服务都使用SMN,从而可使您在事件发生(如云审计服务检测到云服务资源发生关键操作)时能立即接收到通知。系统告警是由预定义阈值触发的通知,通过邮件、短信、FunctionGraph( - [产品功能](https://support.huaweicloud.com/productdesc-smn/smn_pd_29000.md): 本页面介绍了SMN服务支持的主要功能。关于各功能支持的地域(Region)信息,可通过控制台查询详情。消息通知服务费用构成:外网下行流量+消息通知费用不同场景下的费用构成如下:发送短信通知费用构成:短信通知条数发送电子邮件费用构成:电子邮件+外网下行流量发送HTTP(S)费用构成:HTTP(S)+外网下行流量主题是消息发布或客户端订阅通知 - [身份认证与访问控制](https://support.huaweicloud.com/productdesc-smn/smn_pd_25002.md): IAM权限策略:统一身份认证(Identity and Access Management,简称IAM)是华为云提供权限管理、访问控制和身份认证的基础服务,您可以使用IAM创建和管理用户、用户组,通过授权来允许或拒绝他们对云服务和资源的访问,通过设置安全策略提高账号和资源的安全性,同时IAM为您提供多种安全的访问凭证。消息通知服务支持通过 - [数据保护技术](https://support.huaweicloud.com/productdesc-smn/smn_pd_25003.md): 存储在消息通知服务中的订阅信息将会被SHA256方式加密保存。订阅信息包括:手机号码邮件地址Http/Https地址即时通信工具群机器人地址传输中数据保护指在数据传输(发往和离开消息通知服务时)期间保护数据。向消息通知服务发送消息时,您可以使用Https协议请求消息通知服务接口进行传输加密。消息通知服务向外部系统发送消息时,也支持Http - [审计与日志](https://support.huaweicloud.com/productdesc-smn/smn_pd_25004.md): 云审计服务(Cloud Trace Service,CTS),是华为云安全解决方案中专业的日志审计服务,提供对各种云资源操作记录的收集、存储和查询功能,可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。用户开通云审计服务后,CTS可记录消息通知服务的操作事件用于审计。CTS的详细介绍和开通配置方法,请参见入门指引。消息通知服 - [服务韧性](https://support.huaweicloud.com/productdesc-smn/smn_pd_25005.md): 为避免个别客户大量发送消息,影响消息通知服务对整体客户的服务能力,消息通知服务对消息发送有下列限制,超过限制将不可发送消息。主题流控针对单个主题的流控,不区分协议类型,控制该主题消息的并发量,统计周期固定1分钟,默认3k/分钟。针对单个主题的流控,不区分协议类型,控制该主题消息的并发量,统计周期固定1分钟,默认3k/分钟。租户短信流控针对 - [认证证书](https://support.huaweicloud.com/productdesc-smn/smn_pd_25006.md): 华为云服务及平台通过了多项国内外权威机构(ISO/SOC/PCI等)的安全合规认证,用户可自行申请下载合规资质证书。合规证书下载华为云还提供以下资源来帮助用户满足合规性要求,具体请查看资源中心。资源中心华为云安全服务提供了网络安全专用产品安全检测证书、软件著作权等证书,供用户下载和参考。具体请查看合规资质证书。网络安全专用产品安全检测证书 - [约束与限制](https://support.huaweicloud.com/productdesc-smn/smn_01_0004.md): 当您通过消息通知服务SMN发送邮件、短信等消息时,您需要确保传输的内容符合当地法律法规要求。SMN使用异步方式推送消息,不保证消息送达的时效性。如果业务要求消息准实时送达,请慎重考虑是否使用SMN服务。SMN服务发送消息的邮箱地址和发送短信/语音的号码地址不固定,有切换的可能。请勿将邮箱地址和发送短信/语音的号码地址作白名单限制,否则可能 - [访问消息通知服务的方式](https://support.huaweicloud.com/productdesc-smn/smn_pd_25000.md): 云平台提供了Web化的服务管理平台,即管理控制台和基于HTTPS请求的API(Application programming interface)管理方式。管理控制台方式管理控制台提供Web界面,供您管理计算、存储和其他云资源。您可以使用管理控制台方式访问消息通知服务。管理控制台提供Web界面,供您管理计算、存储和其他云资源。您可以使用管 - [计费说明](https://support.huaweicloud.com/productdesc-smn/smn_price.md): 华为云消息通知服务仅按实际用量付费,没有最低消费。华为云消息通知服务对消息通知费用、外网下行流量计费,具体的计费详情请参见价格详情。所有的用量统计按照自然月计算。部分云服务通过SMN直接发送消息到电子邮箱地址或手机号,这种情况下,账单中的资源名称一列为空。消息通知服务费用构成:外网下行流量+消息通知费用不同场景下的费用构成如下:发送短信通 - [权限管理](https://support.huaweicloud.com/productdesc-smn/smn_ug_0034.md): 如果您需要对华为云上购买的SMN资源,为企业中的员工设置不同的访问权限,以达到不同员工之间的权限隔离,您可以使用统一身份认证服务(Identity and Access Management,简称IAM)进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能,可以帮助您安全的控制华为云资源的访问。如果华为账号已经能满足您的要 - [与其他服务的关系](https://support.huaweicloud.com/productdesc-smn/smn_pd_24000.md): 其他云服务可以集成SMN,为云服务提供事件通知的能力,使这些服务可以向租户或者消息处理系统发送事件通知。对接SMN的云服务使用SMN的详细信息请参见相应服务的用户指南。现列举几个云服务使用SMN的例子,如图1所示。 - [基本概念](https://support.huaweicloud.com/productdesc-smn/smn_pd_28000.md): 项目用于将OpenStack的资源(计算资源、存储资源和网络资源)进行分组和隔离。项目可以是一个部门或者一个项目组。一个账户中可以创建多个项目。SMN支持发送的消息类型,包括邮件、HTTP(S)、短信、FunctionGraph(函数)、FunctionGraph(工作流)。消息发布者,向主题发送消息的对象。消息订阅者,从主题接收消息的订 - [区域和可用区](https://support.huaweicloud.com/productdesc-smn/zh-cn_topic_0000001409933861.md): 区域和可用区用来描述数据中心的位置,您可以在特定的区域、可用区创建资源。区域(Region):从地理位置和网络时延维度划分,同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region,通用Region指面向公共租户提供通用云服务的Region;专属Reg ## 快速入门 - [通过SMN发布JSON消息](https://support.huaweicloud.com/qs-smn/smn_json.md): 消息通知服务能够根据用户的需求,向订阅终端主动推送消息。消息通知服务支持发布JSON消息,可通过一次消息发布,向不同类型的订阅者发布不同内容的消息。本章节以创建主题并发布JSON消息为例,指导您快速上手消息通知服务。注册账号并实名认证。在使用消息通知服务之前,请先注册华为账号并开通华为云、实名认证。如果您已开通华为云并进行实名认证,请忽略 - [通过SMN发布模板消息](https://support.huaweicloud.com/qs-smn/smn_template.md): 消息通知服务能够根据用户的需求,向订阅终端主动推送消息。消息通知服务支持发布模板消息,该功能用于以下场景:在用户发送的通知消息中,大部分内容是固定的,只有少数内容随着每次事件指标变化而变化。在这种场景下,用户可以通过创建一个消息模板,用模板变量代替变化的内容。这样在每次发布消息通知时,选择消息模板并设置模板变量便可完成特定的消息通知。本章 ## 用户指南 - [通过IAM角色或策略授予使用SMN的权限](https://support.huaweicloud.com/usermanual-smn/smn_ug_0037.md): 如果您需要对您所拥有的SMN进行角色与策略的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),通过IAM,您可以:根据企业的业务组织,在您的华为云账号中,给企业中不同职能部门的员工创建IAM用户,让员工拥有唯一安全凭证,并使用SMN资源。根据企业用户的职能,设置不同的访问权限 - [通过IAM身份策略授予使用SMN的权限](https://support.huaweicloud.com/usermanual-smn/smn_ug_0038.md): 如果您需要对您所拥有的SMN进行身份策略的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),通过IAM,您可以:根据企业的业务组织,在您的华为云账号中,给企业中不同职能部门的员工创建用户或用户组,让员工拥有唯一安全凭证,并使用SMN资源。根据企业用户的职能,设置不同的访问权限 - [主题概述](https://support.huaweicloud.com/usermanual-smn/smn_ug_0081.md): 主题作为消息的集合,是一个逻辑访问点和通信渠道,拥有唯一的主题名称。主题创建者可以设置主题策略,授权其他云服务或者用户操作该主题,例如查询主题订阅者列表、发布消息等。 - [创建主题](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0043961401.md): 主题是消息发布或客户端订阅通知的特定事件类型。它作为发送消息和订阅通知的信道,为发布者和订阅者提供一个可以相互交流的通道。登录SMN控制台。在左侧导航栏,选择“主题管理” > “主题”。进入主题页面。进入主题页面。在主题页面,单击“创建主题”。创建主题在“主题名称”框中,输入主题名称,在“显示名”框中输入相关描述,如表1所示。创建主题参数 - [修改显示名](https://support.huaweicloud.com/usermanual-smn/smn_ug_42000.md): 您已经创建了一个主题,您现在可以修改显示名。登录SMN控制台。在左侧导航栏,选择“主题管理” > “主题”。进入主题页面。进入主题页面。在主题列表中,选择一个主题,单击右侧“操作”栏的“更多”,在下拉列表中选择“修改显示名”。在弹出的对话框中输入新的显示名。或者单击“主题名称”,在主题详情页中,单击显示名右侧的“”图标,输入新的显示名。推 - [新增/修改/删除主题标签](https://support.huaweicloud.com/usermanual-smn/smn_ug_0006.md): 标签由标签“键”和标签“值”组成,用于标识云资源,可对云资源进行分类和搜索。一个标签的“键”可以拥有多个标签“值”。一个云资源不能拥有重复的标签“键”。一个标签的“键”可以拥有多个标签“值”。一个云资源不能拥有重复的标签“键”。登录SMN控制台。在左侧导航栏,选择“主题管理” > “主题”。进入主题页面。进入主题页面。在主题列表中,选择一 - [设置主题策略](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0043394891.md): 只有和主题创建者处于同一个账号下的全部用户拥有权限通过此主题发送消息。通过主题策略的设置,您可授权或拒绝云服务、组织或其他用户对主题资源进行特定类型操作,如查询主题详情、发布消息等。授权其他用户后,主题创建者依然可以操作该主题。登录SMN控制台。在左侧导航栏,选择“主题管理” > “主题”。进入主题页面。进入主题页面。在主题列表中,选择一 - [订阅主题](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0043961402.md): 要接收发布至主题的消息,您必须向该主题添加订阅者。登录SMN控制台。在左侧导航栏,选择“主题管理” > “主题”。进入主题页面。进入主题页面。在主题列表中,选择您要向其添加订阅者的主题,在右侧“操作”栏单击“添加订阅”。或者单击“主题名称”,在主题详情页的右上角选择“添加订阅”。此时将显示“添加订阅”对话框。添加订阅或者单击“主题名称”, - [发布主题消息简介](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0044170758.md): 消息通知服务提供了以下三种通用的方式。向主题发布文本消息向主题发布JSON消息向主题发布模板消息向主题发布文本消息向主题发布JSON消息向主题发布模板消息一旦一条新的消息已经发布,消息通知服务试图将消息发布至每个已经向主题确认订阅的终端节点。如果使用短信协议接收消息,对于内容很长的消息,短信长度限制为490字,超出则可能被运营商拦截。向短 - [向主题发布文本消息](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0043961403.md): 文本消息是指将消息内容以文本的形式发送到订阅终端。所有的订阅终端必须确认订阅才能收到推送消息,未确认的订阅终端不会收到消息。登录SMN控制台。在左侧导航栏,选择“主题管理” > “主题”。进入主题页面。进入主题页面。在主题列表中,选择您要向其发布消息的主题,在右侧“操作”栏单击“发布消息”。或者单击“主题名称”,在主题详情页中,单击右上角 - [向主题发布JSON消息](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0044170767.md): 如果您需要向不同的订阅协议发送不同的内容,可以向主题发布JSON消息,它可以定义分别向短信、邮件、FunctionGraph(函数)、FunctionGraph(工作流)和HTTP(S)订阅协议发送不同内容。所有的订阅终端必须确认订阅才能收到推送消息,未确认的订阅终端不会收到消息。登录SMN控制台。在左侧导航栏,选择“主题管理” > “主 - [向主题发布模板消息](https://support.huaweicloud.com/usermanual-smn/zh-cn_topic_0044170770.md): 消息模板指消息的固定格式。如果您要发布的消息内容丰富,并且这条消息需要多次发布,每次发布时需要变更的内容极少,此时您可以套用已创建的消息模板向订阅者发送消息。在相同的消息模板名称下面,可创建一个或多个不同协议类型的消息模板来适配不同协议的订阅者,但必须包含一个Default协议类型的模板。不同协议类型的消息模板可以设置不同的模板内容,使用 - [删除主题](https://support.huaweicloud.com/usermanual-smn/smn_ug_48000.md): 本节操作介绍在管理控制台删除主题的操作步骤。登录SMN控制台。在左侧导航栏,选择“主题管理” > “主题”。进入主题页面。进入主题页面。在主题列表中,选择一个主题,单击右侧“操作”栏的“更多”,在下拉列表中选择“删除”。确认待删除主题信息后,输入“DELETE”。删除主题单击“确定”,完成删除。删除主题时,将会删除该主题的所有订阅。 - [导出主题](https://support.huaweicloud.com/usermanual-smn/smn_ug_49000.md): 您可以将当前账号下拥有的所有主题的信息,以.xlsx文件的形式导出至本地。该文件记录了主题的名称、ID、企业项目、主题URN、创建时间、显示名等信息。登录SMN控制台。在左侧导航栏,选择“主题管理” > “主题”。进入主题页面。进入主题页面。在主题列表页左上角,单击“导出”,导出列表。可以选择以下方式:导出全部数据到XLSX:导出当前账号 - [管理消息传输日志](https://support.huaweicloud.com/usermanual-smn/smn_ug_0036.md): 如果您想了解您发布至主题的消息的发送情况,您可以使用消息传输日志功能。该功能支持查看短信、邮件、FunctionGraph(函数)、FunctionGraph(工作流)、HTTP、HTTPS等协议的消息发送情况。配置消息传输日志时需要您对接云日志服务,并且已经创建需要关联的云日志组和日志流。关于云日志服务的详细配置和操作方法,请参见《云日 - [订阅概述](https://support.huaweicloud.com/usermanual-smn/smn_ug_0083.md): 订阅是您将订阅者注册到主题的操作。要接收发布至主题的消息,您必须订阅一个订阅终端到该主题。终端节点可以是手机号码、邮箱地址、函数或HTTP(S)终端。为终端节点订阅主题且确认订阅后,终端节点能够接收到向该主题发布的所有消息。您可以拥有多个主题,每个主题有多个订阅者。 - [添加订阅](https://support.huaweicloud.com/usermanual-smn/smn_ug_0008.md): 当您需要向创建的主题添加订阅者操作,或者向已获取授权的主题添加订阅者时,可参考本章节。登录SMN控制台。在左侧导航栏,选择“主题管理” > “订阅”。在订阅页面,单击“添加订阅”,开始添加消息订阅。此时将显示“添加订阅”页面。添加订阅此时将显示“添加订阅”页面。向指定主题添加订阅。单击“主题名称”输入框右侧的“选择主题”,在弹出的选择主题 - [请求订阅](https://support.huaweicloud.com/usermanual-smn/smn_ug_0009.md): 如果订阅者未收到订阅请求消息,用户可以再次请求订阅,请求订阅的流控规则请见订阅确认流控说明。可一次向一个或多个订阅终端发送确认请求。登录SMN控制台。在左侧导航栏,选择“主题管理” > “订阅”。在订阅列表中,选择一个或多个“状态”为“未确认”的订阅。单击订阅列表上方的“请求订阅”,确定发送该订阅的确认请求。或者单击订阅操作列的“请求订阅 - [取消订阅](https://support.huaweicloud.com/usermanual-smn/smn_ug_0010.md): 订阅者订阅了主题之后,会收到系统发出的确认请求消息。只有订阅者确认订阅才能收到消息。当订阅者不需要收到消息时,可取消订阅。目前SMN服务的订阅管理能力对终端订阅者开放,终端订阅者必须保护好自己的订阅链接,避免被其他人窃取后无法收到或收到非本人期望得到的通知信息。不同的订阅协议对应不同的取消订阅方式:短信取消订阅:因为短信长度有限,无法每次 - [修改订阅](https://support.huaweicloud.com/usermanual-smn/smn_ug_0810.md): 订阅添加成功后,您可以根据需求,修改订阅信息。当前支持修改备注信息和订阅筛选策略。登录SMN控制台。在左侧导航栏,选择“主题管理” > “主题”。进入主题页面。进入主题页面。在主题列表中,选择一个主题,单击主题名称,进入主题详情页面。在主题详情页面下方区域的“订阅总数”,查看该主题的订阅列表。单击待修改订阅“操作”列下的“编辑订阅”,修改 - [删除订阅](https://support.huaweicloud.com/usermanual-smn/smn_ug_0011.md): 当消息订阅者无需接收某主题推送的消息时,您可删除该订阅终端。支持批量删除。登录SMN控制台。在左侧导航栏,选择“主题管理” > “主题”。进入主题页面。进入主题页面。在主题列表中,选择一个主题,单击主题名称,进入主题详情页面。在主题详情页面下方区域的“订阅总数”,查看该主题的订阅列表。选择一个或者多个订阅终端,单击订阅列表上方的“删除”。 - [导出订阅](https://support.huaweicloud.com/usermanual-smn/smn_ug_0059.md): 您可以将当前账号下拥有的所有订阅的信息,以.xlsx文件的形式导出至本地。该文件记录了订阅的订阅URN、协议、订阅终端、订阅状态、请求头、备注、主题名称等信息。登录SMN控制台。在左侧导航栏,选择“主题管理” > “订阅”。进入订阅页面。进入订阅页面。在订阅列表页左上角,单击“导出”,导出列表。可以选择以下方式:导出全部数据到XLSX:导 - [订阅确认流控说明](https://support.huaweicloud.com/usermanual-smn/smn_ug_a4000.md): 为了控制用户对订阅者进行恶意的攻击,云平台对添加订阅时发送订阅确认消息进行了流控。流控策略既适用于从控制台发送订阅确认消息也适用于通过调用API发送订阅确认消息。根据不同的协议有不同的流控策略:对于一个邮件订阅者,1个小时最多允许发送20次订阅确认消息,2天最多允许发送40次订阅确认消息。如果超过1小时的流控阈值,则SMN会在接下来的1小 - [订阅筛选策略使用样例](https://support.huaweicloud.com/usermanual-smn/smn_ug_a9005.md): 本文主要介绍在添加订阅时如何配置订阅筛选策略,用于限定消息发布范围。订阅筛选策略应用于消息属性。当订阅者设置了筛选策略,且发布消息时设置了消息属性,则在消息发布时会根据订阅筛选策略判断消息是否推送给订阅者。本示例筛选属性采用企业团队、职位岗位维度:company:企业团队(group_a、group_b、group_c)position: - [消息模板概述](https://support.huaweicloud.com/usermanual-smn/smn_ug_0085.md): 消息模板指消息的固定格式,发布消息时可以使用已创建的消息模板向订阅者发送消息。使用模板发送消息,发送时会自动替换模板变量为对应的参数值。消息模板通过消息名称进行分组,消息名称下面可以根据不同的协议创建不同的模板。每个模板名称下面都必须要创建一个Default模板。当按照模板格式推送消息时,不同协议订阅者优先会选择模板名称下面对应的协议模板 - [创建消息模板](https://support.huaweicloud.com/usermanual-smn/smn_ug_0086.md): 消息模板指消息的固定格式,发布消息时可以使用已创建的消息模板向订阅者发送消息。使用模板发送消息,发送时会自动替换模板变量为对应的参数值。本节操作介绍在管理控制台创建消息模板的操作步骤。登录SMN控制台。在左侧导航栏,选择“主题管理” >“消息模板”。在消息模板页面。单击“创建消息模板”,开始创建消息模板。此时将显示“创建消息模板”页面。创 - [修改消息模板](https://support.huaweicloud.com/usermanual-smn/smn_ug_0087.md): 本节操作介绍在管理控制台修改消息模板的操作步骤。登录SMN控制台。在左侧导航栏,选择“主题管理” >“消息模板”。在消息模板页面模板列表中,选择需要修改的消息模板名称。单击右侧“操作”栏的“修改”,修改“模板内容”。请以{xxx}作为占位符创建模板。在使用该模板发送消息时,{xxx}可以被替换成具体内容。{xxx}中的xxx只能包含大写字 - [删除消息模板](https://support.huaweicloud.com/usermanual-smn/smn_ug_0088.md): 本节操作介绍在管理控制台删除消息模板的操作步骤。登录SMN控制台。在左侧导航栏,选择“主题管理” >“消息模板”。在消息模板页面模板列表中,选择需要删除的消息模板名称,单击右侧“操作”栏的“删除”。删除消息模板确认待删除消息模板信息后,输入“DELETE”。单击“确定”,完成删除。 - [订阅用户概述](https://support.huaweicloud.com/usermanual-smn/smn_ug_0084.md): SMN的终端节点订阅主题且确认订阅后,终端节点才能够接收到向该主题发布的所有消息。当用户在多个区域均需要创建同样的订阅时,终端节点会多次收到确认订阅信息,且需要在每一条订阅消息内确认订阅。为防止这种场景下对终端节点的消息干扰,建议使用订阅用户功能,一次创建用户后即可导入其他区域的订阅。订阅用户是提供跨区域统一管理订阅者信息的功能。订阅者可 - [创建订阅用户](https://support.huaweicloud.com/usermanual-smn/smn_ug_0045.md): 订阅用户是提供跨区域统一管理订阅者信息的功能。订阅者可以先创建多个订阅用户,当主题需要添加订阅时,再将订阅用户批量添加到该主题上。当订阅者需要创建订阅用户时,可参考本章节。当前国内局点的订阅用户数据存储在“华北-北京四”,海外局点的订阅用户数据存储在“中国-香港”。登录SMN控制台。在左侧导航栏,选择“订阅用户”。在订阅用户页面,单击“创 - [请求订阅用户](https://support.huaweicloud.com/usermanual-smn/smn_ug_0046.md): 创建订阅用户完成后,用户需要向订阅终端发送请求订阅,请求订阅的流控规则请见订阅确认流控说明。可一次向一个订阅终端发送确认请求。登录SMN控制台。在左侧导航栏,选择“订阅用户”。在订阅用户列表中,选择一个为“未确认”的订阅用户。单击订阅用户列表“操作列”的“请求订阅”。在弹出的“请求订阅”窗口中,单击“确定”,发送该订阅的确认请求。请求订阅 - [修改订阅用户分组](https://support.huaweicloud.com/usermanual-smn/smn_ug_0047.md): 用户可针对订阅用户的分组进行修改,从而更好地管理订阅用户。登录SMN控制台。在左侧导航栏,选择“订阅用户”。在订阅用户列表中,选择一个订阅用户,单击“操作列”的“修改分组”。在弹出的“修改分组”窗口中,对分组进行修改。修改订阅用户分组修改完成后,单击“确定”。一个订阅用户最多创建10个分组。一个订阅用户最多创建10个分组。 - [删除订阅用户](https://support.huaweicloud.com/usermanual-smn/smn_ug_0048.md): 当用户不需要某一个订阅用户时,可对该订阅用户进行删除操作。登录SMN控制台。在左侧导航栏,选择“订阅用户”。在订阅用户列表中,选择一个订阅用户,单击“操作列”的“删除”。在弹出的“删除订阅用户”窗口的输入框中,输入“DELETE”,单击“确定”,完成删除。删除订阅用户 - [SMN支持的监控指标说明](https://support.huaweicloud.com/usermanual-smn/smn_ug_11001.md): 本节定义了消息通知服务上报云监控的监控指标的命名空间,监控指标列表,各项监控指标的具体含义与使用说明,用户可以通过云监控检索消息通知服务产生的监控指标和告警信息。SYS.SMN消息通知服务支持的监控指标如表1所示。 - [SMN支持事件监控的事件说明](https://support.huaweicloud.com/usermanual-smn/smn_ug_11004.md): 事件监控提供了事件类型数据上报、查询和告警的功能。方便您将业务中的各类重要事件或对云资源的操作事件收集到云监控服务,并在事件发生时进行告警。SYS.SMN - [查看监控指标数据](https://support.huaweicloud.com/usermanual-smn/smn_ug_11002.md): 为了使用户更好地掌握自己的主题推送结果状态,云平台提供了云监控。通过本节,您可以了解如何查看消息通知服务的监控指标详情。消息通知服务中有创建过的主题。当主题下没有监控指标对应的订阅类型时,与之对应的监控指标上报值为0。当主题下没有监控指标对应的订阅类型时,与之对应的监控指标上报值为0。登录CES控制台。单击页面左侧导航栏的“云服务监控”, - [设置监控告警规则](https://support.huaweicloud.com/usermanual-smn/smn_ug_11003.md): 通过设置主题告警规则,用户可自定义监控目标与通知策略,及时了解主题下订阅推送结果,从而起到预警作用。登录CES控制台。选择“告警 > 告警规则”。在“告警规则”界面,单击“创建告警规则”创建主题的告警规则,或者选择已有的主题的告警规则进行修改,设置主题的告警规则。规则参数设置完成后,单击“立即创建”。更多关于设置告警规则的信息,请参见《云 - [设置事件告警规则](https://support.huaweicloud.com/usermanual-smn/smn_ug_11005.md): 事件监控提供了事件类型数据上报、查询和告警的功能。方便您将业务中的各类重要事件或对云资源的操作事件收集到云监控服务,了解云产品的运行状态。您可以针对业务中的各类重要事件或对云资源的操作事件设置事件告警规则。当指定事件发生时,云监控服务自动发送告警通知,帮助您实时得知云资源的异常状态,并及时处理异常情况。登录CES控制台。单击页面左侧的“事 - [SMN支持审计的关键操作列表](https://support.huaweicloud.com/usermanual-smn/smn_ug_0012.md): 在您的账户中启用云审计服务后,SMN服务的API被调用时,日志文件可能会跟踪记录该操作,并依据时间和数据的变化将日志文件转储到对象存储桶。如果您在没有登录的情况下调用SMN的取消订阅(Unsubscribe)操作,云审计则不会记录这些操作。例如,当您需要取消订阅时,在电子邮件通知中单击取消订阅的链接,此时会在未登录的情况下调用Unsubs - [查看SMN审计事件](https://support.huaweicloud.com/usermanual-smn/smn_ug_0013.md): 云审计服务能够为您提供云服务资源的操作记录,记录的信息包括发起操作的用户身份、IP地址、具体的操作内容的信息,以及操作返回的响应信息。根据这些操作记录,您可以很方便地实现安全审计、问题跟踪、资源定位,帮助您更好地规划和利用已有资源、甄别违规或高危操作。本节介绍如何在云审计服务控制台查看或导出最近7天的操作记录。事件即云审计服务追踪并保存的 - [关于配额](https://support.huaweicloud.com/usermanual-smn/smn_ug_0032.md): 为防止资源滥用,平台限定了各服务资源的配额,对用户的资源数量和容量做了限制。如您最多可以创建多少台弹性云服务器、多少块云硬盘。如果当前资源配额限制无法满足使用需要,您可以申请扩大配额。登录管理控制台。单击管理控制台左上角的,选择区域和项目。在页面右上角,选择“资源 > 我的配额”。系统进入“服务配额”页面。我的配额系统进入“服务配额”页面 - [JSON格式消息说明](https://support.huaweicloud.com/usermanual-smn/smn_ug_a1000.md): JSON格式主要用来处理用户想对不同的订阅者类型发送不同的消息,目前支持的协议Default、HTTP、HTTPS、email、FunctionGraph(函数)、FunctionGraph(工作流),其中Default是必须的,Email的内容将发给邮件类型的订阅者,其它协议依次如下所示:推荐将Default设置为通用的消息内容,对于特 - [模板格式消息说明](https://support.huaweicloud.com/usermanual-smn/smn_ug_a2000.md): 模板格式消息指固定格式的消息,可以通过tag的方式来处理变量的部分。通过模板发送消息,建议消息大小不超过256KB,模板格式消息如下所示: - [不同协议消息说明](https://support.huaweicloud.com/usermanual-smn/smn_ug_a3000.md): 不同的订阅协议接收到的消息包含的内容可能有所不同。邮件和HTTP(S)终端收到的消息包含:消息主题、消息内容和取消订阅的链接。短信终端接收到的消息只包含消息内容。FunctionGraph(函数)终端收到的消息包含消息属性、消息标题、消息内容、主题URN等信息。消息样例类似如下。字段说明如表1所示。{ "record": - [国家(或地区)码](https://support.huaweicloud.com/usermanual-smn/smn_ug_a5000.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [授权操作与SMN接口的映射关系](https://support.huaweicloud.com/usermanual-smn/smn_ug_a6000.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [HTTP(S)终端节点使用样例简介](https://support.huaweicloud.com/usermanual-smn/smn_ug_a9001.md): 向该订阅终端发布消息时,消息通知服务自动组装消息,用户可以接收到的由消息通知服务发送至HTTP(S)终端的消息共分为两种,管理类消息和业务类消息。管理类消息即确认订阅消息和取消订阅消息。业务类消息即推送消息。用户接收到的整条消息包含两部分内容,分别是消息头和消息体。消息体和消息头具体的参数配置请参考本章节。 - [HTTP(S)消息格式](https://support.huaweicloud.com/usermanual-smn/smn_ug_a9002.md): 接收SMN服务发送的HTTP(S)消息时,终端证书的CN名称请参考业界规范,部分特殊字符可能导致https消息发送失败。在互联网上传递未加密的http协议消息内容存在信息泄漏风险,推荐用户终端添加订阅时对接通道优先使用https类型。描述SMN服务向HTTP(S)终端发送消息的格式,您可以通过消息头部信息中的消息类型来区分消息格式。消息格 - [校验消息签名](https://support.huaweicloud.com/usermanual-smn/smn_ug_a9003.md): 为了确保安全,提供订阅确认、取消订阅、通知消息和订阅用户消息的签名认证,在消息的接收方需要对SMN发送的消息进行校验,消息类型包括订阅确认消息、取消订阅通知消息、通知消息、订阅用户确认订阅消息和订阅用户取消订阅消息。使用SMN消息中的信息,您可以通过签名串验证消息的合法性。验证SMN发送的HTTP(S)请求的流程如下:SMN将根据您终端节 - [示例代码](https://support.huaweicloud.com/usermanual-smn/smn_ug_a9004.md): 验证消息是否有效,其中signing_cert_url、signature是从HTTP(S)消息格式描述获取的值,message为特定消息的签名键值。以下为示例代码,仅供参考。使用Java 8 版本以下的用户,可以使用第三方jar包commons-codec.jar进行Base64解码。并将上述样例代码中的"byte[] sigByte - [校验HTTP(S)签名证书](https://support.huaweicloud.com/usermanual-smn/smn_ug_a9000.md): SMN服务推送的HTTP(S)协议消息体内携带signing_cert_url字段,该字段用于标识消息签名证书的外部下载路径。通过该外部路径获取证书时,存在中间人攻击导致证书内容被篡改的安全风险。为保障签名校验安全性,建议您直接采用本页面公示的HTTP(S)消息签名证书(cert.pem)完成消息签名校验工作。本页面公示的HTTP(S)消 ## API参考 - [使用前必读](https://support.huaweicloud.com/api-smn/zh-cn_topic_0036017316.md): 欢迎使用消息通知服务(Simple Message Notification,SMN)。消息通知服务是可靠的、可扩展的、海量的消息处理服务。它可以依据您的需求主动推送通知消息,最终您可以通过短信、电子邮件、应用等方式接收。您也可以在应用之间通过SMN实现应用的功能集成,降低系统的复杂性。您可以使用本文档提供的API对消息通知服务进行相关操 - [API概览](https://support.huaweicloud.com/api-smn/smn_api_20000.md): 通过使用消息通知服务所提供的接口,您可以完整的使用消息通知服务的所有功能。例如创建Topic、添加订阅。 - [构造请求](https://support.huaweicloud.com/api-smn/smn_api_31000.md): 本节介绍REST API请求的组成,并以调用IAM服务的管理员创建IAM用户接口说明如何调用API。您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com/videos/102987。请求URI由如下部分组成:{URI-scheme}://{Endpoint}/{resource-pat - [认证鉴权](https://support.huaweicloud.com/api-smn/smn_api_33000.md): 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比Token认证要高。Token认证:通过Token认证调用请求。AK/SK认证:通过AK(Access Key ID)/SK(Secr - [返回结果](https://support.huaweicloud.com/api-smn/smn_api_34000.md): 请求发送以后,您会收到响应,其中包含状态码、响应消息头和消息体。状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。对于管理员创建IAM用户接口,如果调用后返回状态码为201,则表示请求成功。对应请求消息头,响应同样也有消息头,如Content-type。对于管理员创建IAM用户接口,返回如图 - [快速入门](https://support.huaweicloud.com/api-smn/smn_api_40000.md): 本节通过调用一系列SMN的API实现通过主题发布消息。API的调用方法请参见如何调用API。通过IAM服务获取到的Token有效期为24小时,需要使用同一个Token鉴权时,可以先将Token缓存,避免频繁调用。当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息 - [添加订阅用户 - CreateSubscriptionUser](https://support.huaweicloud.com/api-smn/CreateSubscriptionUser.md): 添加订阅用户。如果订阅用户的状态为未确认,则会向订阅用户发送一条确认订阅消息。订阅用户点击订阅链接确认订阅后,则订阅用户的状态变更为已确认,同时会向订阅用户发送一条取消订阅消息,便于订阅用户随时可以取消订阅。订阅用户点击取消订阅链接后,则订阅用户的状态变更为已取消,同时会向订阅用户发送一条重新订阅消息,便于订阅用户可以重新订阅。该接口属于 - [查询订阅用户列表 - ListSubscriptionUser](https://support.huaweicloud.com/api-smn/ListSubscriptionUser.md): 查询订阅用户列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:subscriptio - [删除订阅用户 - DeleteSubscriptionUser](https://support.huaweicloud.com/api-smn/DeleteSubscriptionUser.md): 删除订阅用户。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:subscriptionU - [更新订阅用户 - UpdateSubscriptionUser](https://support.huaweicloud.com/api-smn/UpdateSubscriptionUser.md): 更新订阅用户。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:subscriptionU - [查询主题列表 - ListTopics](https://support.huaweicloud.com/api-smn/smn_api_51004.md): 分页查询Topic列表,Topic列表按照Topic创建时间进行降序排列。分页查询可以指定offset以及limit。如果不存在Topic,则返回空列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权 - [创建主题 - CreateTopic](https://support.huaweicloud.com/api-smn/smn_api_51001.md): 创建Topic,单用户默认配额为3000。高并发场景下,可能会出现Topic数量超过3000仍创建成功的情况,此为正常现象。接口是幂等的,接口调用返回成功时,若已存在同名的Topic,返回的status code为200,否则返回的status code为201请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户 - [查询主题详情 - ListTopicDetails](https://support.huaweicloud.com/api-smn/ListTopicDetails.md): 查询Topic的详细信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:g - [更新主题 - UpdateTopic](https://support.huaweicloud.com/api-smn/UpdateTopic.md): 更新显示名。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:updateTo - [删除主题 - DeleteTopic](https://support.huaweicloud.com/api-smn/DeleteTopic.md): 删除主题。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:deleteWri - [查询主题策略 - ListTopicAttributes](https://support.huaweicloud.com/api-smn/ListTopicAttributes.md): 查询主题的策略信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:list - [删除所有主题策略 - DeleteTopicAttributes](https://support.huaweicloud.com/api-smn/DeleteTopicAttributes.md): 删除所有主题策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:delet - [更新主题策略 - UpdateTopicAttribute](https://support.huaweicloud.com/api-smn/UpdateTopicAttribute.md): 更新主题的策略信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:upda - [删除指定名称的主题策略 - DeleteTopicAttributeByName](https://support.huaweicloud.com/api-smn/DeleteTopicAttributeByName.md): 删除指定名称的主题策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:de - [查询主题的发送详情 - ListTopicMessageStatistics](https://support.huaweicloud.com/api-smn/ListTopicMessageStatistics.md): 查询Topic的发送数据详情,最多支持查询31天内所有计量数据请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别 - [查询主题列表及主题关联资源信息 - ListTopicsWithAssociatedResources](https://support.huaweicloud.com/api-smn/ListTopicsWithAssociatedResources.md): 查询Topic及Topic关联资源信息列表,关联资源信息随业务演进会持续扩展。Topic列表默认按照创建时间进行降序排列。分页查询可以指定offset以及limit。如果不存在Topic,则返回空列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果 - [批量删除订阅 - BatchDeleteSubscriptions](https://support.huaweicloud.com/api-smn/BatchDeleteSubscriptions.md): 批量删除订阅,每个订阅终端的删除结果在响应体中依次展示。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [查询订阅者列表 - ListSubscriptions](https://support.huaweicloud.com/api-smn/ListSubscriptions.md): 分页返回请求者的所有的订阅列表,订阅列表按照订阅创建时间进行升序排列。分页查询可以指定offset以及limit。如果订阅者不存在,返回空列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使 - [批量删除指定主题的订阅 - BatchDeleteSubscriptionsByTopic](https://support.huaweicloud.com/api-smn/BatchDeleteSubscriptionsByTopic.md): 批量删除指定主题的订阅,每个订阅终端的删除结果在响应体中依次展示。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件 - [查询指定Topic的订阅者列表 - ListSubscriptionsByTopic](https://support.huaweicloud.com/api-smn/ListSubscriptionsByTopic.md): 分页获取特定Topic的订阅列表,订阅列表按照订阅创建时间进行升序排列。分页查询可以指定offset以及limit。如果指定Topic不存在订阅者,返回空列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限 - [订阅 - AddSubscription](https://support.huaweicloud.com/api-smn/AddSubscription.md): 为指定Topic添加一个订阅者,如果订阅者的状态为未确认,则向订阅者发送一个确认的消息。待订阅者进行ConfirmSubscription确认后,该订阅者才能收到Topic发布的消息。单Topic默认可添加10000个订阅者,高并发场景下,可能会出现订阅者数量超过10000仍添加成功的情况,此为正常现象。接口是幂等的,如果添加已存在的订阅 - [取消订阅 - CancelSubscription](https://support.huaweicloud.com/api-smn/CancelSubscription.md): 删除指定的订阅者。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:delet - [删除指定主题的订阅 - DeleteSubscriptionsByTopic](https://support.huaweicloud.com/api-smn/DeleteSubscriptionsByTopic.md): 删除指定主题的订阅请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:delet - [更新订阅者 - UpdateSubscription](https://support.huaweicloud.com/api-smn/UpdateSubscription.md): 更新订阅者备注。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:update - [导入订阅 - AddSubscriptionFromSubscriptionUser](https://support.huaweicloud.com/api-smn/AddSubscriptionFromSubscriptionUser.md): 为指定的Topic添加订阅者,订阅者信息来源为订阅用户列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名 - [确认订阅 - ConfirmSubscription](https://support.huaweicloud.com/api-smn/ConfirmSubscription.md): 确认订阅主题消息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET /rest/v2/notifications/subscription - [取消订阅 - UnsubscribeSubscription](https://support.huaweicloud.com/api-smn/UnsubscribeSubscription.md): 取消订阅主题请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET /rest/v2/notifications/subscription/un - [订阅主题 - SubscribeTopic](https://support.huaweicloud.com/api-smn/SubscribeTopic.md): 订阅终端确认订阅主题消息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET /v2/notifications/subscriptions - [取消订阅主题 - UnsubscribeTopic](https://support.huaweicloud.com/api-smn/UnsubscribeTopic.md): 订阅终端取消订阅主题消息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET /v2/notifications/subscriptions - [查询消息模板列表 - ListMessageTemplates](https://support.huaweicloud.com/api-smn/ListMessageTemplates.md): 分页查询模板列表,模板列表按照创建时间进行升序排列。分页查询可以指定offset以及limit。如果不存在模板,则返回空列表。额外的查询参数分别有message_template_name和protocol。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限 - [创建消息模板 - CreateMessageTemplate](https://support.huaweicloud.com/api-smn/CreateMessageTemplate.md): 创建一个模板,用户可以按照模板去发送消息,这样可以减少请求的数据量。单用户默认可创建100个消息模板,高并发场景下,可能会出现消息模板数量超过100仍创建成功的情况,此为正常现象。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具 - [查询消息模板详情 - ListMessageTemplateDetails](https://support.huaweicloud.com/api-smn/ListMessageTemplateDetails.md): 查询模板详情,包括模板内容。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:templa - [更新消息模板 - UpdateMessageTemplate](https://support.huaweicloud.com/api-smn/UpdateMessageTemplate.md): 修改消息模板的内容。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:template:u - [删除消息模板 - DeleteMessageTemplate](https://support.huaweicloud.com/api-smn/DeleteMessageTemplate.md): 删除消息模板。删除模板之前的消息请求都可以使用该模板发送,删除之后无法再使用该模板发送消息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级 - [消息发布 - PublishMessage](https://support.huaweicloud.com/api-smn/PublishMessage.md): 将消息发送给Topic的所有订阅端点。当返回消息ID时,该消息已被保存并开始尝试将其推送给Topic的订阅者。为确保您的消息能够成功推送到各个订阅者,请确保您的消息内容符合当地法律法规要求。三种消息发送方式messagemessage_structuremessage_template_name只需要设置其中一个,如果同时设置,生效的优先 - [发布探测消息 - PublishHttpDetect](https://support.huaweicloud.com/api-smn/PublishHttpDetect.md): 基于主题发送http/https探测消息,探测当前http/https 终端是否可用,SMN出口是否能够正常访问该终端。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前AP - [获取http探测结果 - ShowHttpDetectResult](https://support.huaweicloud.com/api-smn/ShowHttpDetectResult.md): 根据http探测发送返回的task_id查询探测结果。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET /v2/{project_id}/ - [查询资源实例 - ListResourceInstances](https://support.huaweicloud.com/api-smn/ListResourceInstances.md): 使用标签过滤实例。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:tag:listRea - [批量添加删除资源标签 - BatchCreateOrDeleteResourceTags](https://support.huaweicloud.com/api-smn/BatchCreateOrDeleteResourceTags.md): 为指定实例批量添加或删除标签。一个资源上最多有10个标签。此接口为幂等接口:创建时如果请求体中存在重复key则报错。创建时,不允许重复key,如果数据库存在就覆盖。删除时,如果删除的标签不存在,默认处理成功,删除时不对标签字符集范围做校验。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IA - [查询资源标签 - ListResourceTags](https://support.huaweicloud.com/api-smn/ListResourceTags.md): 查询指定实例的标签信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:tag:list - [添加资源标签 - CreateResourceTag](https://support.huaweicloud.com/api-smn/CreateResourceTag.md): 一个资源上最多有10个标签。此接口为幂等接口:创建时,如果创建的标签已经存在(key相同),则覆盖。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权 - [查询项目标签 - ListProjectTags](https://support.huaweicloud.com/api-smn/ListProjectTags.md): 查询租户在指定Region和实例类型的所有标签集合。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授 - [删除资源标签 - DeleteResourceTag](https://support.huaweicloud.com/api-smn/DeleteResourceTag.md): 幂等接口:删除时,不对标签做校验。删除的key不存在报404,key不能为空或者空字符串。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别 - [查询SMN支持的API版本号信息 - ListVersions](https://support.huaweicloud.com/api-smn/ListVersions.md): 查询SMN开放API支持的版本号。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET /状态码:200状态码:400状态码:403状态码:4 - [查询SMN API V2版本信息 - ListVersion](https://support.huaweicloud.com/api-smn/ListVersion.md): 查询SMN API V2版本信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET /v2状态码:200状态码:400状态码:403状态码 - [绑定云日志 - CreateLogtank](https://support.huaweicloud.com/api-smn/CreateLogtank.md): 为指定Topic绑定一个云日志,用于记录主题消息发送状态等信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键 - [查询云日志 - ListLogtank](https://support.huaweicloud.com/api-smn/ListLogtank.md): 查询指定Topic绑定的云日志。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topi - [更新云日志 - UpdateLogtank](https://support.huaweicloud.com/api-smn/UpdateLogtank.md): 更新指定Topic绑定的云日志。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topi - [解绑云日志 - DeleteLogtank](https://support.huaweicloud.com/api-smn/DeleteLogtank.md): 解绑指定Topic绑定的云日志。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topi - [批量创建订阅过滤策略 - BatchCreateSubscriptionsFilterPolices](https://support.huaweicloud.com/api-smn/BatchCreateSubscriptionsFilterPolices.md): 创建订阅者的消息过滤策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:u - [批量更新订阅过滤策略 - BatchUpdateSubscriptionsFilterPolices](https://support.huaweicloud.com/api-smn/BatchUpdateSubscriptionsFilterPolices.md): 更新订阅者的消息过滤策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:u - [批量删除订阅过滤策略 - BatchDeleteSubscriptionsFilterPolices](https://support.huaweicloud.com/api-smn/BatchDeleteSubscriptionsFilterPolices.md): 删除订阅者的消息过滤策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:u - [创建通知策略 - CreateNotifyPolicy](https://support.huaweicloud.com/api-smn/CreateNotifyPolicy.md): 创建通知策略请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:createNo - [查询通知策略 - ShowNotifyPolicy](https://support.huaweicloud.com/api-smn/ShowNotifyPolicy.md): 查询通知策略请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:getNotif - [修改通知策略 - UpdateNotifyPolicy](https://support.huaweicloud.com/api-smn/UpdateNotifyPolicy.md): 修改通知策略,该接口仅支持全量修改,不支持部分修改。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授 - [删除通知策略 - DeleteNotifyPolicy](https://support.huaweicloud.com/api-smn/DeleteNotifyPolicy.md): 删除通知策略请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:deleteNo - [查询协议列表 - ListProtocols](https://support.huaweicloud.com/api-smn/ListProtocols.md): 查询SMN支持的协议列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET /v2/notifications/protocols状态码: - [查询授权云服务列表 - ListCloudService](https://support.huaweicloud.com/api-smn/ListCloudService.md): 查询授权云服务列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET /v2/notifications/cloud_service状态码 - [查询授权服务列表 - ListCloudServices](https://support.huaweicloud.com/api-smn/ListCloudServices.md): 查询授权服务列表请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET /v2/notifications/cloud-services状态码: - [下载证书 - DownloadHttpCert](https://support.huaweicloud.com/api-smn/DownloadHttpCert.md): 下载http消息校验证书请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET /smn/{certificate_id}无状态码:200状态码 - [下载HTTP签名证书 - DownloadHttpSignCert](https://support.huaweicloud.com/api-smn/DownloadHttpSignCert.md): 下载HTTP签名证书请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET /v2/notifications/certifications/d - [主题绑定KMS密钥 - CreateKmsKey](https://support.huaweicloud.com/api-smn/CreateKmsKey.md): 为主题绑定KMS密钥。KMS密钥于绑定后五分钟生效,生效后该主题下发布的消息(确认订阅消息、取消订阅消息、主题消息)均使用指定密钥的数据密钥进行加解密,并将消息内容在SMN服务内部加密传输。执行绑定KMS密钥时,用户需要先在IAM处创建名为smn_kms_agency的委托,并将资源操作权限授权给SMN服务。SMN会使用该委托进行创建数据 - [查询主题下KMS密钥 - ShowKmsKey](https://support.huaweicloud.com/api-smn/ShowKmsKey.md): 查询主题下密钥ID。执行绑定KMS密钥时,用户需要先在IAM处创建名为smn_kms_agency的委托,并将资源操作权限授权给SMN服务。SMN会使用该委托进行查询密钥信息操作。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具 - [更新主题下KMS密钥 - UpdateKmsKey](https://support.huaweicloud.com/api-smn/UpdateKmsKey.md): 更新密钥ID。执行更新KMS密钥时,用户需要先在IAM处创建名为smn_kms_agency的委托,并将对应的资源操作权限授权给SMN服务。SMN会使用该委托进行查询密钥状态和创建数据密钥操作。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色 - [删除主题下KMS密钥 - DeleteKmsKey](https://support.huaweicloud.com/api-smn/DeleteKmsKey.md): 删除主题绑定的密钥。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项smn:topic:dele - [示例1:使用主题发布消息](https://support.huaweicloud.com/api-smn/smn_api_70001.md): 本章节指导用户通过API发布消息。API的调用方法请参见如何调用API。获取用户Token:通过用户名/密码的方式进行认证来获取IAM用户Token。创建主题:创建Topic。订阅:为指定Topic添加订阅者。消息发布:将消息发送给Topic的所有订阅终端。您可以在API Explorer中调试该接口。Token认证,具体操作请参考认证鉴 - [示例2:使用消息模板方式发布消息](https://support.huaweicloud.com/api-smn/smn_api_70002.md): 本章节指导用户通过API使用消息模板方式发布消息。API的调用方法请参见如何调用API。获取用户Token:通过用户名/密码的方式进行认证来获取IAM用户Token。创建主题:创建Topic。订阅:为指定Topic添加订阅者。创建消息模板:创建一个模板,用户可以按照模板去发送消息,这样可以减少请求的数据量。消息发布:将消息发送给Topic - [权限及授权项说明](https://support.huaweicloud.com/api-smn/smn_api_80001.md): 如果您需要对您所拥有的SMN进行精细的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),如果华为账号所具备的权限功能已经能满足您的要求,您可以跳过本章节,不影响您使用SMN服务的其他功能。通过IAM,您可以通过授权控制主体(IAM用户、用户组、IAM委托或信任委托)对华为云资 - [策略授权参考](https://support.huaweicloud.com/api-smn/smn_api_80014.md): 本章节介绍SMN策略授权场景下支持的策略授权项。策略包含系统策略和自定义策略,如果系统策略不满足授权要求,管理员可以创建自定义策略,并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应,授权项列表说明如下:权限:允许或拒绝某项操作。对应API接口:自定义策略实际调用的API接口。授权项:自定义策略中支持的Acti - [身份策略授权参考](https://support.huaweicloud.com/api-smn/smn_api_80015.md): 云服务在IAM预置了常用授权项,称为系统身份策略。如果IAM系统身份策略无法满足授权要求,管理员可以根据各服务支持的授权项,创建IAM自定义身份策略来进行精细的访问控制,IAM自定义身份策略是对系统身份策略的扩展和补充。除IAM服务外,Organizations服务中的服务控制策略(Service Control Policy,以下简称S - [主题操作](https://support.huaweicloud.com/api-smn/smn_api_80002.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [模板操作](https://support.huaweicloud.com/api-smn/smn_api_80004.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [标签操作](https://support.huaweicloud.com/api-smn/smn_api_80007.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [发布消息操作](https://support.huaweicloud.com/api-smn/smn_api_80005.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [Application操作(废弃)](https://support.huaweicloud.com/api-smn/smn_api_80008.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [Application直发消息操作(废弃)](https://support.huaweicloud.com/api-smn/smn_api_80010.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [获取项目ID](https://support.huaweicloud.com/api-smn/smn_api_66000.md): 在调用接口的时候,部分URL中需要填入项目ID,所以需要获取到项目ID。有如下两种获取方式:调用API获取项目ID从控制台获取项目ID项目ID可以通过调用查询指定条件下的项目列表API获取。获取项目ID的接口为“GET https://{Endpoint}/v3/projects”,其中{Endpoint}为IAM的终端节点,可以从地区和 - [application消息体格式(废弃)](https://support.huaweicloud.com/api-smn/smn_api_61000.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [查询Application(废弃)](https://support.huaweicloud.com/api-smn/ListApplications_0.md): 查询应用平台列表。您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。GET /v2/{project_id}/notifications/applications状态码: 200状态码: 400状态码: 403状态码: 404状态码: 500状 - [创建Application(废弃)](https://support.huaweicloud.com/api-smn/CreateApplication_0.md): 创建平台应用。您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。POST /v2/{project_id}/notifications/applications状态码: 201状态码: 400状态码: 403状态码: 404状态码: 500创建 - [查询Application属性(废弃)](https://support.huaweicloud.com/api-smn/ListApplicationAttributes_0.md): 获取应用平台属性。您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。GET /v2/{project_id}/notifications/applications/{application_urn}状态码: 200状态码: 400状态码: 40 - [更新Application(废弃)](https://support.huaweicloud.com/api-smn/UpdateApplication_0.md): 更新应用平台。您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。PUT /v2/{project_id}/notifications/applications/{application_urn}状态码: 200状态码: 400状态码: 403状 - [删除Application(废弃)](https://support.huaweicloud.com/api-smn/DeleteApplication_0.md): 删除平台应用。您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。DELETE /v2/{project_id}/notifications/applications/{application_urn}状态码: 200状态码: 400状态码: 4 - [查询Application的Endpoint列表(废弃)](https://support.huaweicloud.com/api-smn/ListApplicationEndpoints_0.md): 查询平台的endpoint列表。您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。GET /v2/{project_id}/notifications/applications/{application_urn}/endpoints状态码: 2 - [创建Application endpoint(废弃)](https://support.huaweicloud.com/api-smn/CreateApplicationEndpoint_0.md): 创建应用平台的endpoint终端。您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。POST /v2/{project_id}/notifications/applications/{application_urn}/endpoints状态码 - [查询Application的Endpoint属性(废弃)](https://support.huaweicloud.com/api-smn/ListApplicationEndpointAttributes_0.md): 获取endpoint的属性。您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。GET /v2/{project_id}/notifications/endpoints/{endpoint_urn}状态码: 200状态码: 400状态码: 403 - [更新Application endpoint(废弃)](https://support.huaweicloud.com/api-smn/UpdateApplicationEndpoint_0.md): 更新设备属性。您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。PUT /v2/{project_id}/notifications/endpoints/{endpoint_urn}状态码: 200状态码: 400状态码: 403状态码: 40 - [删除Application endpoint(废弃)](https://support.huaweicloud.com/api-smn/DeleteApplicationEndpoint_0.md): 删除设备。您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。DELETE /v2/{project_id}/notifications/endpoints/{endpoint_urn}状态码: 200状态码: 400状态码: 403状态码: 4 - [App消息发布(废弃)](https://support.huaweicloud.com/api-smn/PublishAppMessage_0.md): 将消息直发给endpoint设备。您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。POST /v2/{project_id}/notifications/endpoints/{endpoint_urn}/publish状态码: 200状态码: - [订阅确认V2接口(废弃)](https://support.huaweicloud.com/api-smn/topic_300000008_0.md): 用途订阅确认接口接口邮件模板生命周期管理接口(废弃)联系人生命周期管理接口(废弃)P12证书转Cert证书(废弃) - [Topic属性表](https://support.huaweicloud.com/api-smn/smn_api_a1000.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [异常响应](https://support.huaweicloud.com/api-smn/smn_api_63001.md): 异常响应要素说明名称参数类型说明request_idString请求的IDcodeString参考错误码messageString参考错误码异常响应举例{ "request_id": "aad0860d089c482b943971f802a6718e", "code": "SMN.0006", "message": - [状态码](https://support.huaweicloud.com/api-smn/smn_api_63002.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [错误码](https://support.huaweicloud.com/api-smn/ErrorCode.md): 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。更多服务错误码请参见API错误中心。 - [国家码和地区码](https://support.huaweicloud.com/api-smn/smn_api_a3000.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 ## SDK参考 - [SDK概述](https://support.huaweicloud.com/sdkreference-smn/smn_sdk_0101.md): 本文介绍了SMN服务提供的SDK,列举了最新版本SDK的获取地址。如果您需要了解SDK的隐私数据处理策略,请参见华为云SDK隐私声明。API Explorer能根据需要动态生成SDK代码功能,降低您使用SDK的难度,推荐使用。在开始使用之前,请确保您安装的是最新版本的SDK。使用过时的版本可能会导致兼容性问题或无法使用最新功能。您可以在S ## CLI参考 - [如何使用CLI](https://support.huaweicloud.com/clir-smn/smn_cli_01.md): 华为云命令行工具服务(Koo Command Line Interface,KooCLI,原名HCloud CLI)是为发布在API Explorer上的云服务API提供的命令行管理工具。您可以通过此工具调用API Explorer中SMN开放的API,管理和使用您的SMN资源。关于KooCLI的详细信息,请参见什么是KooCLI。在使用 - [CLI命令参考](https://support.huaweicloud.com/clir-smn/smn_cli_02.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 ## 常见问题 - [消息通知服务有哪些优势?](https://support.huaweicloud.com/smn_faq/index.md): 消息通知服务的突出优势有以下三点:消息通知体系需要大量投入资源进行开发以及维护,使用SMN服务可以大幅降低成本。无需考虑消息通知体系的可靠性以及扩容问题。消息通知服务接入简单、学习成本低。 - [消息通知服务支持的传输协议有哪些?](https://support.huaweicloud.com/smn_faq/smn_faq_0003.md): 消息通知服务支持的协议有“邮件”、“短信”、“HTTP”和“HTTPS”、“FunctionGraph(函数)”、“FunctionGraph(工作流)”等。“邮件”:消息以电子邮件形式发送到订阅的邮箱地址。“短信”:消息以短信文本消息发送到订阅的电话号码。“HTTP”、“HTTPS”: 消息以HTTP/HTTPS请求的形式发送到订阅的U - [消息通知服务的主题名称有何格式要求?](https://support.huaweicloud.com/smn_faq/smn_faq_0005.md): 主题名称不能超过255个字符,允许使用字母数字字符以及连字符(-)和下划线(_)。一个账户中的主题名称必须唯一,删除主题后,可以重新使用该主题名称。创建主题后,主题名称为主题的唯一标识,一旦创建后不能再修改主题名称。SMN将为该主题分配唯一的URN,其中包括服务名称(SMN)、区域名称、项目ID和主题名称。URN将作为创建主题时使用的AP - [消息通知服务创建/订阅/发布主题常见问题](https://support.huaweicloud.com/smn_faq/smn_faq_0006.md): 每个用户默认可创建3000个主题。每个主题默认可添加10000个订阅者。向主题发布消息没有限量。每个用户默认可创建100个消息模板。单个主题支持多种传输协议定义,目前支持HTTP/HTTPS、邮件、FunctionGraph(函数)、FunctionGraph(工作流)以及短信传输协议。暂不支持主题传输协议的设置。订阅终端地址不允许修改。 - [如何获取用户的账号ID?](https://support.huaweicloud.com/smn_faq/smn_faq_0021.md): 登录管理控制台。鼠标悬停在右上角的用户名,选择下拉列表中的“我的凭证”。在“API凭证”页面的项目列表中查看账号ID。 - [消息通知服务有哪些优势?](https://support.huaweicloud.com/smn_faq/index.md): 消息通知服务的突出优势有以下三点:消息通知体系需要大量投入资源进行开发以及维护,使用SMN服务可以大幅降低成本。无需考虑消息通知体系的可靠性以及扩容问题。消息通知服务接入简单、学习成本低。 - [消息通知服务支持的传输协议有哪些?](https://support.huaweicloud.com/smn_faq/smn_faq_0003.md): 消息通知服务支持的协议有“邮件”、“短信”、“HTTP”和“HTTPS”、“FunctionGraph(函数)”、“FunctionGraph(工作流)”等。“邮件”:消息以电子邮件形式发送到订阅的邮箱地址。“短信”:消息以短信文本消息发送到订阅的电话号码。“HTTP”、“HTTPS”: 消息以HTTP/HTTPS请求的形式发送到订阅的U - [消息通知服务的主题名称有何格式要求?](https://support.huaweicloud.com/smn_faq/smn_faq_0005.md): 主题名称不能超过255个字符,允许使用字母数字字符以及连字符(-)和下划线(_)。一个账户中的主题名称必须唯一,删除主题后,可以重新使用该主题名称。创建主题后,主题名称为主题的唯一标识,一旦创建后不能再修改主题名称。SMN将为该主题分配唯一的URN,其中包括服务名称(SMN)、区域名称、项目ID和主题名称。URN将作为创建主题时使用的AP - [消息通知服务创建/订阅/发布主题常见问题](https://support.huaweicloud.com/smn_faq/smn_faq_0006.md): 每个用户默认可创建3000个主题。每个主题默认可添加10000个订阅者。向主题发布消息没有限量。每个用户默认可创建100个消息模板。单个主题支持多种传输协议定义,目前支持HTTP/HTTPS、邮件、FunctionGraph(函数)、FunctionGraph(工作流)以及短信传输协议。暂不支持主题传输协议的设置。订阅终端地址不允许修改。 - [如何获取用户的账号ID?](https://support.huaweicloud.com/smn_faq/smn_faq_0021.md): 登录管理控制台。鼠标悬停在右上角的用户名,选择下拉列表中的“我的凭证”。在“API凭证”页面的项目列表中查看账号ID。 - [消息通知服务的使用如何收费和计费?](https://support.huaweicloud.com/smn_faq/smn_faq_0004.md): 华为云消息通知服务仅按实际用量付费,没有最低消费。华为云消息通知服务对消息通知费用、外网下行流量计费,具体的计费详情请参见价格详情。消息通知服务费用构成:外网下行流量+消息通知费用不同场景下的费用构成如下:发送短信通知费用构成:短信通知条数发送电子邮件费用构成:电子邮件+外网下行流量发送HTTP(S)费用构成:HTTP(S)+外网下行流量 - [消息通知服务的使用如何收费和计费?](https://support.huaweicloud.com/smn_faq/smn_faq_0004.md): 华为云消息通知服务仅按实际用量付费,没有最低消费。华为云消息通知服务对消息通知费用、外网下行流量计费,具体的计费详情请参见价格详情。消息通知服务费用构成:外网下行流量+消息通知费用不同场景下的费用构成如下:发送短信通知费用构成:短信通知条数发送电子邮件费用构成:电子邮件+外网下行流量发送HTTP(S)费用构成:HTTP(S)+外网下行流量 - [以短信方式接收消息的限制是什么?](https://support.huaweicloud.com/smn_faq/smn_faq_0009.md): 短信方式的字数计算规则如下表所示。短信类别字数计算规则备注国内短信(接收方为中国大陆号码)(如:中文、中文+英文)使用Unicode编码字符,汉字、字母、数字、标点符号(不区分全角/半角)以及空格等,都按1个字计算。短信字数=短信模板内容字数 + 签名字数。(以实际发送字数为准)短信字数<=70个字数,按照70个字数一条短信计算。短信字数 - [是否会保证将消息传送到订阅的终端节点?](https://support.huaweicloud.com/smn_faq/smn_faq_0014.md): SMN向终端节点推送消息时,使用异步方式送达,不保证消息送达的时效性。如果业务要求消息准实时送达,请慎重考虑是否使用SMN服务。如果订阅终端节点可以送达,消息通知服务会确保消息传送到订阅终端节点。如果订阅终端节点无法送达,消息通知服务会将发送失败的消息保存到失败的消息队列尾部,等待下次被发送。如果发送失败次数超过6次,消息将直接丢弃,不再 - [向主题推送消息后,订阅者为什么没有收到消息?](https://support.huaweicloud.com/smn_faq/smn_faq_0016.md): 在排除终端设备本身的问题,比如信号不好。最可能原因是您未完成确认订阅或信息被拦截。优先排查信息是否被拦截,查看您的短信/邮件/语音通知是否被处理为垃圾信息。如果仍然不能解决您的问题,请联系技术支持。如果是订阅确认短信,请优先排查被拦截的短信。如果是消息通知短信,请您先确认已完成订阅确认,再排查被拦截短信。优先排查垃圾邮件,查看您的邮件是否 - [为什么用户接收到的邮件中图片无法显示?](https://support.huaweicloud.com/smn_faq/smn_faq_0019.md): 部分邮箱为帮助保护您的隐私,默认禁止自动从Internet下载图片,导致邮件中图片无法显示,您需要在您的邮箱中设置允许自动下载图片即可正常显示图片。以邮箱Outlook2019版本举例如何设置允许自动下载图片功能。具体步骤如下:打开Outlook,单击左上角的“文件”。找到“选项”,单击“选项”,打开选项界面。找到“信任中心”,单击“信任 - [使用消息通知服务发送短信的号码或显示名可以保持一致吗?](https://support.huaweicloud.com/smn_faq/smn_faq_0020.md): 可以。发送短信的号码或显示名一般不会变,只有通道变化号码或显示名才会变,通道变化是由于遇到运营商管控。 - [钉钉机器人、钉钉企业内部机器人、飞书机器人、企业微信机器人如何获取订阅终端?](https://support.huaweicloud.com/smn_faq/smn_faq_0027.md): 钉钉机器人、钉钉企业内部机器人、飞书机器人和企业微信机器人在添加订阅时,输入的订阅终端地址获取方式如下。钉钉机器人在钉钉的群设置中选择“智能群助手”,添加机器人时选择“自定义”,创建完成后即可获得webhook地址。(钉钉已不再支持新用户创建自定义机器人,详情请参考钉钉开发文档。SMN支持存量自定义机器人添加订阅。)在钉钉的群设置中选择“ - [以短信方式接收消息的限制是什么?](https://support.huaweicloud.com/smn_faq/smn_faq_0009.md): 短信方式的字数计算规则如下表所示。短信类别字数计算规则备注国内短信(接收方为中国大陆号码)(如:中文、中文+英文)使用Unicode编码字符,汉字、字母、数字、标点符号(不区分全角/半角)以及空格等,都按1个字计算。短信字数=短信模板内容字数 + 签名字数。(以实际发送字数为准)短信字数<=70个字数,按照70个字数一条短信计算。短信字数 - [是否会保证将消息传送到订阅的终端节点?](https://support.huaweicloud.com/smn_faq/smn_faq_0014.md): SMN向终端节点推送消息时,使用异步方式送达,不保证消息送达的时效性。如果业务要求消息准实时送达,请慎重考虑是否使用SMN服务。如果订阅终端节点可以送达,消息通知服务会确保消息传送到订阅终端节点。如果订阅终端节点无法送达,消息通知服务会将发送失败的消息保存到失败的消息队列尾部,等待下次被发送。如果发送失败次数超过6次,消息将直接丢弃,不再 - [向主题推送消息后,订阅者为什么没有收到消息?](https://support.huaweicloud.com/smn_faq/smn_faq_0016.md): 在排除终端设备本身的问题,比如信号不好。最可能原因是您未完成确认订阅或信息被拦截。优先排查信息是否被拦截,查看您的短信/邮件/语音通知是否被处理为垃圾信息。如果仍然不能解决您的问题,请联系技术支持。如果是订阅确认短信,请优先排查被拦截的短信。如果是消息通知短信,请您先确认已完成订阅确认,再排查被拦截短信。优先排查垃圾邮件,查看您的邮件是否 - [为什么用户接收到的邮件中图片无法显示?](https://support.huaweicloud.com/smn_faq/smn_faq_0019.md): 部分邮箱为帮助保护您的隐私,默认禁止自动从Internet下载图片,导致邮件中图片无法显示,您需要在您的邮箱中设置允许自动下载图片即可正常显示图片。以邮箱Outlook2019版本举例如何设置允许自动下载图片功能。具体步骤如下:打开Outlook,单击左上角的“文件”。找到“选项”,单击“选项”,打开选项界面。找到“信任中心”,单击“信任 - [使用消息通知服务发送短信的号码或显示名可以保持一致吗?](https://support.huaweicloud.com/smn_faq/smn_faq_0020.md): 可以。发送短信的号码或显示名一般不会变,只有通道变化号码或显示名才会变,通道变化是由于遇到运营商管控。 - [钉钉机器人、钉钉企业内部机器人、飞书机器人、企业微信机器人如何获取订阅终端?](https://support.huaweicloud.com/smn_faq/smn_faq_0027.md): 钉钉机器人、钉钉企业内部机器人、飞书机器人和企业微信机器人在添加订阅时,输入的订阅终端地址获取方式如下。钉钉机器人在钉钉的群设置中选择“智能群助手”,添加机器人时选择“自定义”,创建完成后即可获得webhook地址。(钉钉已不再支持新用户创建自定义机器人,详情请参考钉钉开发文档。SMN支持存量自定义机器人添加订阅。)在钉钉的群设置中选择“