SMN UMN 20221028 v2

Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: guoyanyan <guoyanyan3@huawei.com>
Co-committed-by: guoyanyan <guoyanyan3@huawei.com>

docs/smn/umn/PARAMETERS.txt

@@ -0,0 +1,3 @@
+version=""
+language="en-us"
+type=""

docs/smn/umn/en-us_topic_0000001366065676.html

@@ -0,0 +1,22 @@
+<a name="EN-US_TOPIC_0000001366065676"></a><a name="EN-US_TOPIC_0000001366065676"></a>
+
+<h1 class="topictitle1">Region and AZ</h1>
+<div id="en-us_topic_0184026189_body1565144987716"><div class="section" id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_section388255972712"><h4 class="sectiontitle">Concept</h4><p id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_p212716216381">A region and availability zone (AZ) identify the location of a data center. You can create resources in a specific region and AZ.</p>
+<ul id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_ul86578533460"><li id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_li14657175334618">A region is a physical data center, which is completely isolated to improve fault tolerance and stability. The region that is selected during resource creation cannot be changed after the resource is created.</li><li id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_li45875020473">An AZ is a physical location where resources use independent power supplies and networks. A region contains one or more AZs that are physically isolated but interconnected through internal networks. Because AZs are isolated from each other, any fault that occurs in an AZ will not affect other AZs.</li></ul>
+<p id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_p1479174514614"><a href="#EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_fig8747114281212">Figure 1</a> shows the relationship between regions and AZs.</p>
+<div class="fignone" id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_fig8747114281212"><a name="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_fig8747114281212"></a><a name="en-us_topic_0184026189_fig8747114281212"></a><span class="figcap"><b>Figure 1 </b>Regions and AZs</span><br><span><img class="vsd" id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_image12748194211128" src="en-us_image_0000001366545404.png"></span></div>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_section67281149192216"><h4 class="sectiontitle">Selecting a Region</h4><p id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_p68521454132212">Select a region closest to your target users for low network latency and quick access.</p>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_section193971112578"><h4 class="sectiontitle">Selecting an AZ</h4><p id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_p859161416717">When deploying resources, consider your applications' requirements on disaster recovery (DR) and network latency.</p>
+<ul id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_ul157203571473"><li id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_li7720175710711">For high DR capability, deploy resources in different AZs within the same region.</li><li id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_li109763595719">For low network latency, deploy resources in the same AZ.</li></ul>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_section1110135820407"><h4 class="sectiontitle">Regions and Endpoints</h4><p id="EN-US_TOPIC_0000001366065676__en-us_topic_0184026189_p361784821111">Before you use an API to call resources, specify its region and endpoint. For more details, see <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="smn_pd_20000.html">Overview</a></div>
+</div>
+</div>
+

docs/smn/umn/en-us_topic_0043394877.html

@@ -0,0 +1,13 @@
+<a name="en-us_topic_0043394877"></a><a name="en-us_topic_0043394877"></a>
+
+<h1 class="topictitle1">Simple Message Notification</h1>
+<div id="body1467621416806"><p id="en-us_topic_0043394877__p2068261434217">Simple Message Notification (SMN) is a reliable and flexible large-scale message notification service. It enables you to efficiently send messages to phone numbers, email addresses and HTTP/HTTPS servers and connect cloud services through notifications, reducing system complexity. </p>
+<p id="en-us_topic_0043394877__p147811538174410">SMN offers a publish/subscribe model to achieve one-to-multiple message subscriptions and notifications in a variety of message types. SMN involves two roles: publisher and subscriber. A publisher publishes messages to a topic, and SMN then delivers the messages to subscribers in the topic. The subscribers can be email addresses, phone numbers, message queues, and URLs.</p>
+<p id="en-us_topic_0043394877__p878115380445">A topic is a collection of messages and a logical access point, through which the publisher and the subscriber can interact with each other. Each topic has a unique topic name. The topic creator can configure topic policies to grant other users or cloud services permissions to perform certain operations to a topic, for example, querying subscriptions or publishing messages.</p>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="smn_pd_20000.html">Overview</a></div>
+</div>
+</div>
+

docs/smn/umn/en-us_topic_0043394889.html

@@ -0,0 +1,61 @@
+<a name="en-us_topic_0043394889"></a><a name="en-us_topic_0043394889"></a>
+
+<h1 class="topictitle1">Message Template Management</h1>
+<div id="body1468834610704"><div class="section" id="en-us_topic_0043394889__section3499028611828"><h4 class="sectiontitle">Scenario</h4><p id="en-us_topic_0043394889__p6469251163720">Message templates contain fixed and changeable content and can be used to send messages quickly. When you publish a message using a template, you can specify values for variables in the template.</p>
+<p id="en-us_topic_0043394889__p8470185163716">Message templates are grouped by template name. You can create templates for different protocols using the same template name. You must specify the default protocol in any template name, or the system will not allow you to publish messages using that template name. When sending messages using a template, SMN tries to match different types of subscribers to the template protocols. If there is no template for a specified protocol, SMN will use the default template to send messages to subscribers of that protocol.</p>
+<p id="en-us_topic_0043394889__p747005143711">This section describes how to publish messages using a template.</p>
+</div>
+<div class="section" id="en-us_topic_0043394889__section66624127194914"><a name="en-us_topic_0043394889__section66624127194914"></a><a name="section66624127194914"></a><h4 class="sectiontitle">To Create a Message Template</h4><ol id="en-us_topic_0043394889__ol6268589194730"><li id="en-us_topic_0043394889__li1508056115226">Log in to the management console.</li><li id="en-us_topic_0043394889__li6027193112482">Click <span><img id="en-us_topic_0043394889__image19711341171519" src="en-us_image_0000001366225560.png"></span> on the upper left to select the desired region and project.</li><li id="en-us_topic_0043394889__en-us_topic_0206394368_en-us_topic_0043961401_en-us_topic_0043394871_li56417302194730">In the <strong id="en-us_topic_0043394889__b151887226114">Application</strong> category, click <strong id="en-us_topic_0043394889__b132311222714">Simple Message Notification</strong>.<p id="en-us_topic_0043394889__en-us_topic_0206394368_en-us_topic_0043961401_en-us_topic_0043394871_p1597355715256">The SMN console is displayed.</p>
+</li><li id="en-us_topic_0043394889__li15432909174849">In the navigation pane, choose <strong id="en-us_topic_0043394889__b842352706144724">Message Templates</strong>.</li><li id="en-us_topic_0043394889__li45015022153020">Click <strong id="en-us_topic_0043394889__b665081136233440">Create Message Template</strong>.<p id="en-us_topic_0043394889__p48227841153021">The <strong id="en-us_topic_0043394889__b84235270614261">Create Message Template</strong> box is displayed.</p>
+<div class="fignone" id="en-us_topic_0043394889__fig18154514124448"><span class="figcap"><b>Figure 1 </b>Create Message Template</span><br><span><img id="en-us_topic_0043394889__image1470595212176" src="en-us_image_0000001416865433.png" title="Click to enlarge" class="imgResize"></span></div>
+</li><li id="en-us_topic_0043394889__li31541025153249">Specify the template name, protocol, and content.
+<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0043394889__table9567729153632" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters required for creating a message template</caption><thead align="left"><tr id="en-us_topic_0043394889__row46643153153632"><th align="left" class="cellrowborder" valign="top" width="19.74%" id="mcps1.3.2.2.6.1.2.3.1.1"><p id="en-us_topic_0043394889__p45773798153632"><strong id="en-us_topic_0043394889__b633727016234">Parameter</strong></p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="80.25999999999999%" id="mcps1.3.2.2.6.1.2.3.1.2"><p id="en-us_topic_0043394889__p16690171153632"><strong id="en-us_topic_0043394889__b4355688916234">Description</strong></p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="en-us_topic_0043394889__row15993813153632"><td class="cellrowborder" valign="top" width="19.74%" headers="mcps1.3.2.2.6.1.2.3.1.1 "><p id="en-us_topic_0043394889__p43710295164421">Template Name</p>
+</td>
+<td class="cellrowborder" valign="top" width="80.25999999999999%" headers="mcps1.3.2.2.6.1.2.3.1.2 "><p id="en-us_topic_0043394889__p44258107153632">Template name, which:</p>
+<ul id="en-us_topic_0043394889__ul40971925153757"><li id="en-us_topic_0043394889__li50065056153757">Contains letters, numerals, underscores (_), and hyphens (-) and starts with a letter or numeral.</li><li id="en-us_topic_0043394889__li46057856153757">Is a character string 1 to 64 bytes long.</li><li id="en-us_topic_0043394889__li16528589153757">Cannot be modified once the template is created.</li></ul>
+</td>
+</tr>
+<tr id="en-us_topic_0043394889__row62778644153632"><td class="cellrowborder" valign="top" width="19.74%" headers="mcps1.3.2.2.6.1.2.3.1.1 "><p id="en-us_topic_0043394889__p27643693164446">Protocol</p>
+</td>
+<td class="cellrowborder" valign="top" width="80.25999999999999%" headers="mcps1.3.2.2.6.1.2.3.1.2 "><p id="en-us_topic_0043394889__p40584374104257">Endpoint protocol of the template, which cannot be changed once the template is created</p>
+<p id="en-us_topic_0043394889__p43586774153632">The value can be <strong id="en-us_topic_0043394889__b2108805878143347">Default</strong>, <strong id="en-us_topic_0043394889__b1095921216143347">SMS</strong>, <strong id="en-us_topic_0043394889__b218424467143347">HTTP</strong>, <strong id="en-us_topic_0043394889__b1369851447143347">HTTPS</strong>, <strong id="en-us_topic_0043394889__b84235270615203">DMS</strong>, or <strong id="en-us_topic_0043394889__b1100015765143347">Email</strong>.</p>
+<p id="en-us_topic_0043394889__p12468638104149">If you do not specify a protocol, the <strong id="en-us_topic_0043394889__b1862142081510">Default</strong> protocol is used.</p>
+</td>
+</tr>
+<tr id="en-us_topic_0043394889__row23418429162644"><td class="cellrowborder" valign="top" width="19.74%" headers="mcps1.3.2.2.6.1.2.3.1.1 "><p id="en-us_topic_0043394889__p32830814164510">Content</p>
+</td>
+<td class="cellrowborder" valign="top" width="80.25999999999999%" headers="mcps1.3.2.2.6.1.2.3.1.2 "><p id="en-us_topic_0043394889__p5697748316413">Template content</p>
+<p id="en-us_topic_0043394889__p29184378155831">You can use variables as placeholders. Before you send messages using the template, SMN replaces the variables with the message content you specify. A variable is a string of up to 21 characters. It may contain upper- or lower-case letters, numerals, hyphens (-), underscores (_), and periods (.) and must start with a letter or numeral.</p>
+<p id="en-us_topic_0043394889__p40948298155833">The message template must meet the following requirements:</p>
+<ul id="en-us_topic_0043394889__ul24327004104111"><li id="en-us_topic_0043394889__li33483129104111">The template supports plain text only.</li><li id="en-us_topic_0043394889__li16507566115216">The template content cannot be left blank and cannot exceed 256 KB.</li></ul>
+<ul id="en-us_topic_0043394889__ul36563140155946"><li id="en-us_topic_0043394889__li60632807155946">A template can contain up to 90 non-repeating variables or 256 variables counting the repeated ones.</li><li id="en-us_topic_0043394889__li1566440816017">When you send messages using a template, the message content you specify for each variable cannot exceed 1 KB.</li></ul>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="p" id="en-us_topic_0043394889__p2546525716048">For example, the template information is as follows:<ul id="en-us_topic_0043394889__en-us_topic_0044170770_ul5044007014355"><li id="en-us_topic_0043394889__en-us_topic_0044170770_li4443585114355"><strong id="en-us_topic_0043394889__en-us_topic_0044170770_b842352706163210">Template Name</strong>: <strong id="en-us_topic_0043394889__en-us_topic_0044170770_b842352706163239">tem_001</strong></li><li id="en-us_topic_0043394889__en-us_topic_0044170770_li143143414419"><strong id="en-us_topic_0043394889__en-us_topic_0044170770_b158535461116339">Protocol</strong>: <strong id="en-us_topic_0043394889__en-us_topic_0044170770_b842352706163315">Default</strong></li><li id="en-us_topic_0043394889__en-us_topic_0044170770_li42097216103353"><strong id="en-us_topic_0043394889__en-us_topic_0044170770_b842352706112333">Content</strong>: <strong id="en-us_topic_0043394889__en-us_topic_0044170770_b842352706112354">The Arts and Crafts Exposition will be held from {startdate} through {enddate}. We sincerely invite you to join us.</strong><div class="fignone" id="en-us_topic_0043394889__en-us_topic_0044170770_fig17426812318"><span class="figcap"><b>Figure 2 </b>Create Message Template</span><br><span><img id="en-us_topic_0043394889__en-us_topic_0044170770_image197421283237" src="en-us_image_0000001366385432.png" title="Click to enlarge" class="imgResize"></span></div>
+</li></ul>
+</div>
+</li><li id="en-us_topic_0043394889__li21708033194730">Click <strong id="en-us_topic_0043394889__b842352706174649">OK</strong>.<p id="en-us_topic_0043394889__p37694147103152">The template you created is displayed in the template list.</p>
+</li></ol>
+</div>
+<div class="section" id="en-us_topic_0043394889__section10611263152222"><h4 class="sectiontitle">To Modify a Template</h4><ol id="en-us_topic_0043394889__ol1812393152641"><li id="en-us_topic_0043394889__li65904631152641">Locate the template to be modified in the template list.</li><li id="en-us_topic_0043394889__li57443493164711">Click <strong id="en-us_topic_0043394889__b84235270664856">Modify</strong> under <strong id="en-us_topic_0043394889__b84235270664926">Operation</strong> to change its content.</li></ol>
+</div>
+<div class="section" id="en-us_topic_0043394889__section14249229153134"><h4 class="sectiontitle">To Delete a Template</h4><ol id="en-us_topic_0043394889__ol48274416112630"><li id="en-us_topic_0043394889__li31816566112630">Locate the template to be deleted in the template list.</li><li id="en-us_topic_0043394889__li1305757123220">Click <strong id="en-us_topic_0043394889__b842352706233026">Delete</strong> under <strong id="en-us_topic_0043394889__b531488668233044">Operation</strong>.</li></ol>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/smn/umn/en-us_topic_0043394891.html

@@ -0,0 +1,60 @@
+<a name="en-us_topic_0043394891"></a><a name="en-us_topic_0043394891"></a>
+
+<h1 class="topictitle1">Basic Mode</h1>
+<div id="body1604305022191"><p id="en-us_topic_0043394891__p103713210100">The topic creator has the right to configure topic policies. Using topic policies, you can specify which users and cloud services can perform which topic operations, for example, querying topic details and publishing messages. Topic creators always have permissions over a topic even if they grant topic permissions to other users.</p>
+<div class="section" id="en-us_topic_0043394891__section123941655999"><h4 class="sectiontitle">Configuring Topic Policies in Basic Mode</h4><ol id="en-us_topic_0043394891__ol59341341165252"><li id="en-us_topic_0043394891__li17052523145723">Log in to the management console.</li><li id="en-us_topic_0043394891__li6027193112482">Click <span><img id="en-us_topic_0043394891__en-us_topic_0043961401_image1893792703171224" src="en-us_image_0000001366545396.png"></span> on the upper left to select the desired region and project.</li><li id="en-us_topic_0043394891__li19254981145723">In the <strong id="en-us_topic_0043394891__en-us_topic_0043961402_en-us_topic_0043961401_b5246102962317">Application</strong> category, click <strong id="en-us_topic_0043394891__en-us_topic_0043961402_en-us_topic_0043961401_b1897015122017">Simple Message Notification</strong>.<p id="en-us_topic_0043394891__en-us_topic_0043961402_en-us_topic_0043961401_en-us_topic_0206394368_en-us_topic_0043961401_en-us_topic_0043394871_p1597355715256">The SMN console is displayed.</p>
+</li><li id="en-us_topic_0043394891__li46553485145723"><p id="en-us_topic_0043394891__en-us_topic_0043961401_p55288773174430"><a name="en-us_topic_0043394891__li46553485145723"></a><a name="li46553485145723"></a>In the navigation pane, choose <strong id="en-us_topic_0043394891__en-us_topic_0043961401_b842352706173443">Topics</strong>.</p>
+<p id="en-us_topic_0043394891__en-us_topic_0043961401_en-us_topic_0043394871_p36644308154158">The <strong id="en-us_topic_0043394891__en-us_topic_0043961401_b8423527069492">Topics</strong> page is displayed.</p>
+</li><li id="en-us_topic_0043394891__li5832090715590">Locate a topic, click <strong id="en-us_topic_0043394891__b5645917123511">More</strong> under <strong id="en-us_topic_0043394891__b3654171715359">Operation</strong>, and select <strong id="en-us_topic_0043394891__b13654117163512">Configure Topic Policy</strong>.</li><li id="en-us_topic_0043394891__li821712459553">In the <strong id="en-us_topic_0043394891__b88281318193513">Configure Topic Policy</strong> box, configure the topic policy in basic mode.<p id="en-us_topic_0043394891__p102952047125517">The basic mode simply specifies which users or cloud services have permissions to publish messages to a topic. For details, see <a href="#en-us_topic_0043394891__table41411027111244">Table 1</a>.</p>
+<p id="en-us_topic_0043394891__p317424116543">The advanced mode provides more flexible permission settings. For details, see section <a href="en-us_topic_0043394868.html">3.4.2 Advanced Mode</a>.</p>
+
+<div class="tablenoborder"><a name="en-us_topic_0043394891__table41411027111244"></a><a name="table41411027111244"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0043394891__table41411027111244" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Description for configuring topic policies in basic mode</caption><thead align="left"><tr id="en-us_topic_0043394891__row13344231111244"><th align="left" class="cellrowborder" valign="top" width="14.141414141414144%" id="mcps1.3.2.2.6.4.2.4.1.1"><p id="en-us_topic_0043394891__p33478231112118">Item</p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="22.222222222222225%" id="mcps1.3.2.2.6.4.2.4.1.2"><p id="en-us_topic_0043394891__p18000631111244">Parameter</p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="63.63636363636363%" id="mcps1.3.2.2.6.4.2.4.1.3"><p id="en-us_topic_0043394891__p48765019111244"><strong id="en-us_topic_0043394891__b56065301353">Description</strong></p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="en-us_topic_0043394891__row18473302111244"><td class="cellrowborder" rowspan="3" valign="top" width="14.141414141414144%" headers="mcps1.3.2.2.6.4.2.4.1.1 "><p id="en-us_topic_0043394891__p5383640695554">Users who can publish messages to this topic</p>
+</td>
+<td class="cellrowborder" valign="top" width="22.222222222222225%" headers="mcps1.3.2.2.6.4.2.4.1.2 "><p id="en-us_topic_0043394891__p47398656111244">Topic creator</p>
+</td>
+<td class="cellrowborder" valign="top" width="63.63636363636363%" headers="mcps1.3.2.2.6.4.2.4.1.3 "><p id="en-us_topic_0043394891__p14085905111244">Only the topic creator has permission to publish messages to the topic.</p>
+</td>
+</tr>
+<tr id="en-us_topic_0043394891__row11395712111244"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.6.4.2.4.1.1 "><p id="en-us_topic_0043394891__p43476026111244">All users</p>
+</td>
+<td class="cellrowborder" valign="top" headers="mcps1.3.2.2.6.4.2.4.1.2 "><p id="en-us_topic_0043394891__p31897252111244">All users have permission to publish messages to the topic.</p>
+</td>
+</tr>
+<tr id="en-us_topic_0043394891__row23505339111244"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.6.4.2.4.1.1 "><p id="en-us_topic_0043394891__p1329320191815">Specified user domains</p>
+</td>
+<td class="cellrowborder" valign="top" headers="mcps1.3.2.2.6.4.2.4.1.2 "><p id="en-us_topic_0043394891__p850910222516">Only specified users have permission to publish messages to the topic. Users are specified in the format <strong id="en-us_topic_0043394891__b10605131617369">urn:csp:iam::domainId:root</strong>.</p>
+<p id="en-us_topic_0043394891__p13818194012327">You only need to enter the domain ID and click <strong id="en-us_topic_0043394891__b075818143620">OK</strong>. The system completes all other required information for you. SMN does not limit the number of IDs you enter, but the total length of a topic policy cannot exceed 30 KB.</p>
+<p id="en-us_topic_0043394891__p9731817181012">All settings in the basic mode are also presented in the advanced policy. You can modify them in the advanced mode if necessary. For details, see section <a href="en-us_topic_0043394868.html">3.4.2 Advanced Mode</a>.</p>
+<p id="en-us_topic_0043394891__p1068720613235">To obtain a user's domain ID, log in to the SMN console and click <strong id="en-us_topic_0043394891__b830332622319">My Credentials</strong> in the username drop-down list on the upper right.</p>
+</td>
+</tr>
+<tr id="en-us_topic_0043394891__row6059372111244"><td class="cellrowborder" valign="top" width="14.141414141414144%" headers="mcps1.3.2.2.6.4.2.4.1.1 "><p id="en-us_topic_0043394891__p27095394111244">Services that can publish messages to this topic</p>
+</td>
+<td class="cellrowborder" valign="top" width="22.222222222222225%" headers="mcps1.3.2.2.6.4.2.4.1.2 "><p id="en-us_topic_0043394891__p1450115341985">The services that can publish messages vary according to regions.</p>
+</td>
+<td class="cellrowborder" valign="top" width="63.63636363636363%" headers="mcps1.3.2.2.6.4.2.4.1.3 "><p id="en-us_topic_0043394891__p1504539111244">The selected cloud services have operation permissions of the topic.</p>
+<div class="note" id="en-us_topic_0043394891__note52989799155357"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="en-us_topic_0043394891__p10394321932">By default, Cloud Eye and Anti-DDoS have permissions to publish messages to topics created by all users.</p>
+<p id="en-us_topic_0043394891__p7556617334">For details about how to use SMN in other cloud services, see user guides of the related services.</p>
+</div></div>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+</li></ol>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="smn_ug_0007.html">Configuring Topic Policies</a></div>
+</div>
+</div>
+

docs/smn/umn/en-us_topic_0043394897.html

@@ -0,0 +1,17 @@
+<a name="en-us_topic_0043394897"></a><a name="en-us_topic_0043394897"></a>
+
+<h1 class="topictitle1">Subscription Management</h1>
+<div id="body1470621741591"></div>
+<div>
+<ul class="ullinks">
+<li class="ulchildlink"><strong><a href="smn_ug_0008.html">Adding a Subscription</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="smn_ug_0009.html">Requesting Subscription Confirmation</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="smn_ug_0010.html">Canceling a Subscription</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="smn_ug_0011.html">Deleting a Subscription</a></strong><br>
+</li>
+</ul>
+</div>
+

docs/smn/umn/en-us_topic_0043394914.html

@@ -0,0 +1,25 @@
+<a name="en-us_topic_0043394914"></a><a name="en-us_topic_0043394914"></a>
+
+<h1 class="topictitle1">Topic Management</h1>
+<div id="body1467621416806"></div>
+<div>
+<ul class="ullinks">
+<li class="ulchildlink"><strong><a href="en-us_topic_0043961401.html">Creating a Topic</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="smn_ug_42000.html">Modifying the Display Name of a Topic</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="smn_ug_0006.html">Adding Tags to a Topic</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="smn_ug_0007.html">Configuring Topic Policies</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="en-us_topic_0043961402.html">Adding a Subscription</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="smn_ug_0027.html">Publishing a Message</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="smn_ug_47000.html">Publishing a Message to a Topic Granted to You</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="smn_ug_48000.html">Deleting a Topic</a></strong><br>
+</li>
+</ul>
+</div>
+

docs/smn/umn/en-us_topic_0043961401.html

@@ -0,0 +1,56 @@
+<a name="en-us_topic_0043961401"></a><a name="en-us_topic_0043961401"></a>
+
+<h1 class="topictitle1">Creating a Topic</h1>
+<div id="body1481095236901"><div class="section" id="en-us_topic_0043961401__section5231877317314"><h4 class="sectiontitle">Scenario</h4><p id="en-us_topic_0043961401__p61784484162238">A topic is a specified event to publish messages and subscribe to notifications. It serves as a message sending channel, where publishers and subscribers can interact with each other.</p>
+</div>
+<div class="section" id="en-us_topic_0043961401__section141512514421"><h4 class="sectiontitle">To Create a Topic</h4><ol id="en-us_topic_0043961401__o450d975fa59441da87e317a2a9102855"><li id="en-us_topic_0043961401__en-us_topic_0043394871_li1508056115226">Log in to the management console.</li><li id="en-us_topic_0043961401__li5151573555">Click <span><img id="en-us_topic_0043961401__image1893792703171224" src="en-us_image_0000001366545396.png"></span> on the upper left to select the desired region and project.</li><li id="en-us_topic_0043961401__en-us_topic_0206394368_en-us_topic_0043961401_en-us_topic_0043394871_li56417302194730">In the <strong id="en-us_topic_0043961401__b5246102962317">Application</strong> category, click <strong id="en-us_topic_0043961401__b1897015122017">Simple Message Notification</strong>.<p id="en-us_topic_0043961401__en-us_topic_0206394368_en-us_topic_0043961401_en-us_topic_0043394871_p1597355715256">The SMN console is displayed.</p>
+</li><li id="en-us_topic_0043961401__en-us_topic_0043394871_li4034985818049"><p id="en-us_topic_0043961401__p55288773174430"><a name="en-us_topic_0043961401__en-us_topic_0043394871_li4034985818049"></a><a name="en-us_topic_0043394871_li4034985818049"></a>In the navigation pane, choose <strong id="en-us_topic_0043961401__b842352706173443">Topics</strong>.</p>
+<p id="en-us_topic_0043961401__en-us_topic_0043394871_p36644308154158">The <strong id="en-us_topic_0043961401__b8423527069492">Topics</strong> page is displayed.</p>
+</li><li id="en-us_topic_0043961401__en-us_topic_0043394871_li53401209155118">Click <strong id="en-us_topic_0043961401__b3771120134220">Create Topic</strong>.<p id="en-us_topic_0043961401__p58381023987">The <strong id="en-us_topic_0043961401__b1964116240814">Create Topic</strong> box is displayed.</p>
+<div class="fignone" id="en-us_topic_0043961401__fig63880443104346"><span class="figcap"><b>Figure 1 </b>Create Topic</span><br><span><img id="en-us_topic_0043961401__image2150956185612" src="en-us_image_0000001416865373.png" title="Click to enlarge" class="imgResize"></span></div>
+</li><li id="en-us_topic_0043961401__en-us_topic_0043394871_li31541025153249">Enter a topic name and display name.
+<div class="tablenoborder"><a name="en-us_topic_0043961401__en-us_topic_0043394871_table9567729153632"></a><a name="en-us_topic_0043394871_table9567729153632"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0043961401__en-us_topic_0043394871_table9567729153632" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Information required for creating a topic</caption><thead align="left"><tr id="en-us_topic_0043961401__en-us_topic_0043394871_row46643153153632"><th align="left" class="cellrowborder" valign="top" width="21%" id="mcps1.3.2.2.6.1.2.3.1.1"><p id="en-us_topic_0043961401__en-us_topic_0043394871_p45773798153632"><strong id="en-us_topic_0043961401__en-us_topic_0043394871_b4942326616041">Parameter</strong></p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="79%" id="mcps1.3.2.2.6.1.2.3.1.2"><p id="en-us_topic_0043961401__en-us_topic_0043394871_p16690171153632"><strong id="en-us_topic_0043961401__en-us_topic_0043394871_b4386163916041">Description</strong></p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="en-us_topic_0043961401__en-us_topic_0043394871_row15993813153632"><td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.2.2.6.1.2.3.1.1 "><p id="en-us_topic_0043961401__en-us_topic_0043394871_p41631540153632">Topic Name</p>
+</td>
+<td class="cellrowborder" valign="top" width="79%" headers="mcps1.3.2.2.6.1.2.3.1.2 "><p id="en-us_topic_0043961401__en-us_topic_0043394871_p44258107153632">Topic name, which:</p>
+<ul id="en-us_topic_0043961401__en-us_topic_0043394871_ul40971925153757"><li id="en-us_topic_0043961401__en-us_topic_0043394871_li4690254191513">Contains only letters, numerals, hyphens (-), and underscores (_) and starts with a letter or numeral.</li><li id="en-us_topic_0043961401__en-us_topic_0043394871_li50065056153757">Is a string of 1 to 255 characters.</li><li id="en-us_topic_0043961401__en-us_topic_0043394871_li16528589153757">Must be unique and cannot be modified once the topic is created.</li></ul>
+</td>
+</tr>
+<tr id="en-us_topic_0043961401__row1798615142421"><td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.2.2.6.1.2.3.1.1 "><p id="en-us_topic_0043961401__p1025213190423">Display Name</p>
+</td>
+<td class="cellrowborder" valign="top" width="79%" headers="mcps1.3.2.2.6.1.2.3.1.2 "><p id="en-us_topic_0043961401__p1881782917426">Message sender name, which must be less than 192 bytes.</p>
+<div class="note" id="en-us_topic_0043961401__note13186621175918"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="en-us_topic_0043961401__p0186821165916">After you specify a display name, the sender in email messages will be presented as <em id="en-us_topic_0043961401__i42478810">Display name</em><strong id="en-us_topic_0043961401__b1009127020">&lt;username@example.com&gt;</strong>. Otherwise, the sender will be <strong id="en-us_topic_0043961401__b7110974">username@example.com</strong>.</p>
+</div></div>
+</td>
+</tr>
+<tr id="en-us_topic_0043961401__row101210019315"><td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.2.2.6.1.2.3.1.1 "><p id="en-us_topic_0043961401__p0121302312">Tag</p>
+</td>
+<td class="cellrowborder" valign="top" width="79%" headers="mcps1.3.2.2.6.1.2.3.1.2 "><p id="en-us_topic_0043961401__p712190143113">Tags consist of keys and values. They identify cloud resources so that you can easily categorize and search for your resources.</p>
+<ul id="en-us_topic_0043961401__ul584116317458"><li id="en-us_topic_0043961401__li18841831194519">A key or value is composed of letters, numerals, special characters -_@ and cannot start or end with a space. A key contains 36 characters at most, and a value contains 43 characters at most.</li><li id="en-us_topic_0043961401__li10841631124513">You can add up to 10 tags for each topic.</li></ul>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+</li><li id="en-us_topic_0043961401__en-us_topic_0043394871_li21708033194730">Click <strong id="en-us_topic_0043961401__b842352706144626">OK.</strong><p id="en-us_topic_0043961401__en-us_topic_0043394871_p9048733125612">The topic you created is displayed in the topic list. The system generates a topic URN, which is the unique resource identifier of the topic and cannot be changed.</p>
+</li><li id="en-us_topic_0043961401__li1720481917816">Click the name of the topic to view its details, including the subscriptions, URN, and display name.</li></ol>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0043394914.html">Topic Management</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/smn/umn/en-us_topic_0043961402.html

@@ -0,0 +1,36 @@
+<a name="en-us_topic_0043961402"></a><a name="en-us_topic_0043961402"></a>
+
+<h1 class="topictitle1">Adding a Subscription</h1>
+<div id="body1481095236905"><div class="section" id="en-us_topic_0043961402__section32629212144827"><h4 class="sectiontitle">Scenario</h4><p id="en-us_topic_0043961402__p55362121145924">To deliver messages published to a topic to subscription endpoints, you must add the endpoints to the topic.</p>
+</div>
+<div class="section" id="en-us_topic_0043961402__section66233919201117"><h4 class="sectiontitle">To Add a Subscription</h4><ol id="en-us_topic_0043961402__ol3129830020129"><li id="en-us_topic_0043961402__li64538836144937">Log in to the management console.</li><li id="en-us_topic_0043961402__li6027193112482">Click <span><img id="en-us_topic_0043961402__en-us_topic_0043961401_image1893792703171224" src="en-us_image_0000001366545396.png"></span> on the upper left to select the desired region and project.</li><li id="en-us_topic_0043961402__li55962959145012">In the <strong id="en-us_topic_0043961402__en-us_topic_0043961401_b5246102962317">Application</strong> category, click <strong id="en-us_topic_0043961402__en-us_topic_0043961401_b1897015122017">Simple Message Notification</strong>.<p id="en-us_topic_0043961402__en-us_topic_0043961401_en-us_topic_0206394368_en-us_topic_0043961401_en-us_topic_0043394871_p1597355715256">The SMN console is displayed.</p>
+</li><li id="en-us_topic_0043961402__li51905376145112"><p id="en-us_topic_0043961402__en-us_topic_0043961401_p55288773174430"><a name="en-us_topic_0043961402__li51905376145112"></a><a name="li51905376145112"></a>In the navigation pane, choose <strong id="en-us_topic_0043961402__en-us_topic_0043961401_b842352706173443">Topics</strong>.</p>
+<p id="en-us_topic_0043961402__en-us_topic_0043961401_en-us_topic_0043394871_p36644308154158">The <strong id="en-us_topic_0043961402__en-us_topic_0043961401_b8423527069492">Topics</strong> page is displayed.</p>
+</li><li id="en-us_topic_0043961402__li47990020184517">Locate the topic to which you want to add a subscription, click <strong id="en-us_topic_0043961402__b12521675114">More</strong> under <strong id="en-us_topic_0043961402__b185161685113">Operation</strong>, and select <strong id="en-us_topic_0043961402__b145161675111">Add Subscription</strong>.<p id="en-us_topic_0043961402__p23850576184517">The <strong id="en-us_topic_0043961402__b1887873872153813">Add Subscription</strong> box is displayed.</p>
+<div class="fignone" id="en-us_topic_0043961402__fig78719791833"><span class="figcap"><b>Figure 1 </b>Add Subscription</span><br><span><img id="en-us_topic_0043961402__image1114621915015" src="en-us_image_0000001417026805.png" title="Click to enlarge" class="imgResize"></span></div>
+</li><li id="en-us_topic_0043961402__li5569594161943">Specify the subscription protocol and endpoints. You can enter 10 endpoints at most, each on a separate line.<ul id="en-us_topic_0043961402__ul458944655113"><li id="en-us_topic_0043961402__li558724610515">Email<p id="en-us_topic_0043961402__p2058794675119"><a name="en-us_topic_0043961402__li558724610515"></a><a name="li558724610515"></a>Enter a valid email address, for example, <strong id="en-us_topic_0043961402__b842352706165231">username@example.com</strong>.</p>
+<p id="en-us_topic_0043961402__p45871146155114">Subscribers will receive a subscription confirmation email valid in 48 hours and must confirm the subscription to receive messages published to the topic.</p>
+</li><li id="en-us_topic_0043961402__li1458814617515">HTTP/HTTPS<p id="en-us_topic_0043961402__p1458774610514"><a name="en-us_topic_0043961402__li1458814617515"></a><a name="li1458814617515"></a>Enter a public network URL, for example, <strong id="en-us_topic_0043961402__b84235270617152">http://example.com/notification/action</strong>. HTTP/HTTPS subscribers must confirm their subscriptions. For details about HTTP/HTTPS messages, see section <a href="smn_ug_a9001.html">A.6.1 Introduction</a>.</p>
+</li><li id="en-us_topic_0043961402__li18588174614513">SMS<p id="en-us_topic_0043961402__p584912791111"><a name="en-us_topic_0043961402__li18588174614513"></a><a name="li18588174614513"></a>Enter a valid mobile number preceded by a plus sign (+) and a country code, for example, +4900000000.</p>
+<p id="en-us_topic_0043961402__p185887466511">Subscribers will receive a subscription confirmation message valid in 48 hours and must confirm the subscription to receive messages published to the topic.</p>
+</li><li id="en-us_topic_0043961402__li1358854611516">DMS<p id="en-us_topic_0043961402__p185881946175119"><a name="en-us_topic_0043961402__li1358854611516"></a><a name="li1358854611516"></a>Subscription endpoints are message queues. This type of subscriptions does not need confirmation. Click <span><img id="en-us_topic_0043961402__image6222155720296" src="en-us_image_0148410841.png"></span> to select subscription endpoints. Ensure that the queue policy grants the <strong id="en-us_topic_0043961402__b8423527061693">DMS:ProduceMessages</strong> permission to SMN. For details, see "Managing Queue Policies" in the <em id="en-us_topic_0043961402__i842352697152551">Distributed Message Service User Guide</em>.</p>
+</li></ul>
+</li><li id="en-us_topic_0043961402__li10786811173119">Click <strong id="en-us_topic_0043961402__b842352706174649">OK</strong>.<p id="en-us_topic_0043961402__p46184451175514">The subscription you added is displayed in the subscription list.</p>
+<div class="note" id="en-us_topic_0043961402__note12466114784612"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="en-us_topic_0043961402__ul223164154714"><li id="en-us_topic_0043961402__li92311248474">To prevent malicious users from attacking subscription endpoints, SMN limits the number of confirmation messages that can be sent to an endpoint within a specified period of time. For details, see section <a href="smn_ug_a4000.html">A.4 Control on Subscription Confirmation Traffic</a>.</li><li id="en-us_topic_0043961402__li17231643473">SMN does not check whether subscription endpoints exist when you add subscriptions. However, subscribers will not receive notification messages until they confirm their subscriptions.</li><li id="en-us_topic_0043961402__li1023112417479">The token is valid only for 48 hours. Therefore, subscribers must confirm subscriptions within that time.</li></ul>
+</div></div>
+</li></ol>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0043394914.html">Topic Management</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/smn/umn/en-us_topic_0043961403.html

@@ -0,0 +1,55 @@
+<a name="en-us_topic_0043961403"></a><a name="en-us_topic_0043961403"></a>
+
+<h1 class="topictitle1">Publishing a Text Message</h1>
+<div id="body1481095238094"><div class="section" id="en-us_topic_0043961403__section3152890014563"><h4 class="sectiontitle">Scenario</h4><p id="en-us_topic_0043961403__p31291543142459">After you publish a text message to a topic, SMN will deliver the message to all confirmed subscription endpoints in the topic.</p>
+</div>
+<div class="section" id="en-us_topic_0043961403__section30431634133546"><h4 class="sectiontitle">Prerequisites</h4><p id="en-us_topic_0043961403__p23609712133556">Subscribers in the topic must have confirmed the subscription, or they will not be able to receive any messages.</p>
+</div>
+<div class="section" id="en-us_topic_0043961403__section48379737125756"><h4 class="sectiontitle">To Publish a Text Message</h4><ol id="en-us_topic_0043961403__ol2431622213355"><li id="en-us_topic_0043961403__li64538836144937">Log in to the management console.</li><li id="en-us_topic_0043961403__li6027193112482">Click <span><img id="en-us_topic_0043961403__en-us_topic_0043961401_image1893792703171224" src="en-us_image_0000001366545396.png"></span> on the upper left to select the desired region and project.</li><li id="en-us_topic_0043961403__li55962959145012">In the <strong id="en-us_topic_0043961403__en-us_topic_0043961401_b5246102962317">Application</strong> category, click <strong id="en-us_topic_0043961403__en-us_topic_0043961401_b1897015122017">Simple Message Notification</strong>.<p id="en-us_topic_0043961403__en-us_topic_0043961401_en-us_topic_0206394368_en-us_topic_0043961401_en-us_topic_0043394871_p1597355715256">The SMN console is displayed.</p>
+</li><li id="en-us_topic_0043961403__li51905376145112"><p id="en-us_topic_0043961403__en-us_topic_0043961401_p55288773174430"><a name="en-us_topic_0043961403__li51905376145112"></a><a name="li51905376145112"></a>In the navigation pane, choose <strong id="en-us_topic_0043961403__en-us_topic_0043961401_b842352706173443">Topics</strong>.</p>
+<p id="en-us_topic_0043961403__en-us_topic_0043961401_en-us_topic_0043394871_p36644308154158">The <strong id="en-us_topic_0043961403__en-us_topic_0043961401_b8423527069492">Topics</strong> page is displayed.</p>
+</li><li id="en-us_topic_0043961403__li1751941213355">In the topic list, locate the topic to which you need to publish a message and click <strong id="en-us_topic_0043961403__b84235270693032">Publish Message</strong> under <strong id="en-us_topic_0043961403__b84235270693057">Operation</strong>.</li><li id="en-us_topic_0043961403__li15444192392315">Configure the required parameters according to <a href="#en-us_topic_0043961403__table616755201736">Table 1</a>. The topic name is provided by default and cannot be changed.
+<div class="tablenoborder"><a name="en-us_topic_0043961403__table616755201736"></a><a name="table616755201736"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0043961403__table616755201736" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters required for publishing a message</caption><thead align="left"><tr id="en-us_topic_0043961403__row584325251736"><th align="left" class="cellrowborder" valign="top" width="30.259999999999998%" id="mcps1.3.3.2.6.2.2.3.1.1"><p id="en-us_topic_0043961403__p354141231736"><strong id="en-us_topic_0043961403__b593529816129">Parameter</strong></p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="69.74000000000001%" id="mcps1.3.3.2.6.2.2.3.1.2"><p id="en-us_topic_0043961403__p470923481736"><strong id="en-us_topic_0043961403__b1099715916129">Description</strong></p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="en-us_topic_0043961403__row24022921736"><td class="cellrowborder" valign="top" width="30.259999999999998%" headers="mcps1.3.3.2.6.2.2.3.1.1 "><p id="en-us_topic_0043961403__p603679291736">Subject</p>
+</td>
+<td class="cellrowborder" valign="top" width="69.74000000000001%" headers="mcps1.3.3.2.6.2.2.3.1.2 "><p id="en-us_topic_0043961403__p519144811736">(Optional) The message subject is a string of less than 512 bytes.</p>
+</td>
+</tr>
+<tr id="en-us_topic_0043961403__row645771531736"><td class="cellrowborder" valign="top" width="30.259999999999998%" headers="mcps1.3.3.2.6.2.2.3.1.1 "><p id="en-us_topic_0043961403__p633668671736">Message Format</p>
+</td>
+<td class="cellrowborder" valign="top" width="69.74000000000001%" headers="mcps1.3.3.2.6.2.2.3.1.2 "><p id="en-us_topic_0043961403__p16675104132026">The message format can be <strong id="en-us_topic_0043961403__b842352706151447">Text</strong>, <strong id="en-us_topic_0043961403__b842352706151510">JSON</strong>, or <strong id="en-us_topic_0043961403__b84235270615161">Template</strong>. In this context, you need to select <strong id="en-us_topic_0043961403__b1892485612159">Text</strong>.</p>
+<ul id="en-us_topic_0043961403__ul37120136132048"><li id="en-us_topic_0043961403__li13251437132048"><strong id="en-us_topic_0043961403__b84235270616514">Text</strong>: common text message</li><li id="en-us_topic_0043961403__li21474914132053"><strong id="en-us_topic_0043961403__b842352706165215">JSON</strong>: JSON message</li><li id="en-us_topic_0043961403__li58807944132058"><strong id="en-us_topic_0043961403__b3824744584352">Template</strong>: template message. For details, see <a href="en-us_topic_0043394889.html">5 Message Template Management</a>.</li></ul>
+</td>
+</tr>
+<tr id="en-us_topic_0043961403__row45964848125529"><td class="cellrowborder" valign="top" width="30.259999999999998%" headers="mcps1.3.3.2.6.2.2.3.1.1 "><p id="en-us_topic_0043961403__p5280417412564">Message</p>
+</td>
+<td class="cellrowborder" valign="top" width="69.74000000000001%" headers="mcps1.3.3.2.6.2.2.3.1.2 "><p id="en-us_topic_0043961403__p55246607125529">This is the message content, which cannot be left blank nor exceed 256 KB.</p>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="p" id="en-us_topic_0043961403__p6570291710358">The following figure shows an example text message.<div class="fignone" id="en-us_topic_0043961403__fig804716611238"><span class="figcap"><b>Figure 1 </b>Text message example</span><br><span><img id="en-us_topic_0043961403__image1444410190114" src="en-us_image_0000001366225576.png" title="Click to enlarge" class="imgResize"></span></div>
+</div>
+</li><li id="en-us_topic_0043961403__li1708676313355">Click <strong id="en-us_topic_0043961403__b842352706174649">OK</strong>.<p id="en-us_topic_0043961403__p1116173015454">SMN delivers your message to all subscription endpoints. For details about messages for different protocols, see <a href="smn_ug_a3000.html">A.3 Messages of Different Protocols</a>.</p>
+</li></ol>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="smn_ug_0027.html">Publishing a Message</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/smn/umn/en-us_topic_0044170758.html

@@ -0,0 +1,15 @@
+<a name="en-us_topic_0044170758"></a><a name="en-us_topic_0044170758"></a>
+
+<h1 class="topictitle1">Introduction</h1>
+<div id="body1481255437606"><div class="p" id="en-us_topic_0044170758__p11493381142225">SMN enables you to publish messages in the following formats:<ul id="en-us_topic_0044170758__ul4077673914238"><li id="en-us_topic_0044170758__li715318614238">Text</li><li id="en-us_topic_0044170758__li36079174142310">JSON</li><li id="en-us_topic_0044170758__li35351467142313">Template</li></ul>
+</div>
+<p id="en-us_topic_0044170758__p40153247145618">After you publish a message to a topic, SMN will deliver the message to all confirmed subscription endpoints in the topic.</p>
+<p id="en-us_topic_0044170758__p5020065214149">For SMS endpoints, if an SMS message is oversized, the system divides it into multiple parts when sending it to subscribers. However, you must note that SMN only sends the first two parts of the SMS message and does not send any additional parts. You are charged based on the actual number of messages sent to the subscribers.</p>
+<p id="en-us_topic_0044170758__p2894751141412">You must ensure that firewall policies of the HTTP or HTTPS endpoints allow SMN to send messages from the Internet. An SMN HTTP or HTTPS message consists of a message header and body. For details, see <a href="smn_ug_a9002.html">A.6.2 HTTP/HTTPS Message Format</a>.</p>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="smn_ug_0027.html">Publishing a Message</a></div>
+</div>
+</div>
+

docs/smn/umn/en-us_topic_0044170767.html

@@ -0,0 +1,32 @@
+<a name="en-us_topic_0044170767"></a><a name="en-us_topic_0044170767"></a>
+
+<h1 class="topictitle1">Publishing a JSON Message</h1>
+<div id="body1481255439111"><div class="section" id="en-us_topic_0044170767__section3152890014563"><h4 class="sectiontitle">Scenario</h4><p id="en-us_topic_0044170767__p47861138143834">In a JSON message, you can specify different message content for different protocols, including SMS, email, DMS, HTTP, and HTTPS.</p>
+</div>
+<div class="section" id="en-us_topic_0044170767__section96171713434"><h4 class="sectiontitle">Prerequisites</h4><p id="en-us_topic_0044170767__en-us_topic_0043961403_p23609712133556">Subscribers in the topic must have confirmed the subscription, or they will not be able to receive any messages.</p>
+</div>
+<div class="section" id="en-us_topic_0044170767__section48379737125756"><h4 class="sectiontitle">To Publish a JSON Message</h4><ol id="en-us_topic_0044170767__ol2431622213355"><li id="en-us_topic_0044170767__li64538836144937">Log in to the management console.</li><li id="en-us_topic_0044170767__li6027193112482">Click <span><img id="en-us_topic_0044170767__en-us_topic_0043961401_image1893792703171224" src="en-us_image_0000001366545396.png"></span> on the upper left to select the desired region and project.</li><li id="en-us_topic_0044170767__li55962959145012">In the <strong id="en-us_topic_0044170767__en-us_topic_0043961401_b5246102962317">Application</strong> category, click <strong id="en-us_topic_0044170767__en-us_topic_0043961401_b1897015122017">Simple Message Notification</strong>.<p id="en-us_topic_0044170767__en-us_topic_0043961401_en-us_topic_0206394368_en-us_topic_0043961401_en-us_topic_0043394871_p1597355715256">The SMN console is displayed.</p>
+</li><li id="en-us_topic_0044170767__li51905376145112"><p id="en-us_topic_0044170767__en-us_topic_0043961401_p55288773174430"><a name="en-us_topic_0044170767__li51905376145112"></a><a name="li51905376145112"></a>In the navigation pane, choose <strong id="en-us_topic_0044170767__en-us_topic_0043961401_b842352706173443">Topics</strong>.</p>
+<p id="en-us_topic_0044170767__en-us_topic_0043961401_en-us_topic_0043394871_p36644308154158">The <strong id="en-us_topic_0044170767__en-us_topic_0043961401_b8423527069492">Topics</strong> page is displayed.</p>
+</li><li id="en-us_topic_0044170767__li1751941213355">In the topic list, locate the topic to which you need to publish a message and click <strong id="en-us_topic_0044170767__en-us_topic_0043961403_b84235270693032">Publish Message</strong> under <strong id="en-us_topic_0044170767__en-us_topic_0043961403_b84235270693057">Operation</strong>.</li><li id="en-us_topic_0044170767__li15596146145715">Configure the required parameters according to <a href="en-us_topic_0043961403.html#en-us_topic_0043961403__table616755201736">Table 1</a>. The topic name is provided by default and cannot be changed.<p id="en-us_topic_0044170767__p17146113443520">Select <strong id="en-us_topic_0044170767__b6705144516359">JSON</strong> for <strong id="en-us_topic_0044170767__b9544105373518">Message Format</strong>. Then, manually type the JSON message in the <strong id="en-us_topic_0044170767__b258871513620">Message</strong> box or click <strong id="en-us_topic_0044170767__b741822011361">Generate JSON Message</strong> to generate it automatically. The total size of a JSON message cannot exceed 256 KB.</p>
+<ul id="en-us_topic_0044170767__ul91694809306"><li id="en-us_topic_0044170767__li154164629306">If you choose to manually type the JSON message, see <a href="smn_ug_a1000.html">A.1 JSON Message Format</a> for detailed requirements.</li><li id="en-us_topic_0044170767__li407739099306">If you choose to automatically generate the JSON message, proceed with steps <a href="#en-us_topic_0044170767__li59465700211512">7</a> through <a href="#en-us_topic_0044170767__li3542952114596">10</a>.</li></ul>
+</li><li id="en-us_topic_0044170767__li59465700211512"><a name="en-us_topic_0044170767__li59465700211512"></a><a name="li59465700211512"></a>Click <strong id="en-us_topic_0044170767__b528224952113029">Generate JSON Message</strong>.</li><li id="en-us_topic_0044170767__li18063796124032">Enter your message content, for example, "This is a default message.", in the <strong id="en-us_topic_0044170767__b84235270611324">Message</strong> box and select the desired message protocols.<p id="en-us_topic_0044170767__p27666737124039">The size of a JSON message varies depending on the protocol combinations. As you type in the message content, the system will calculate the number of bytes you have entered, the size of the JSON message, and how many bytes are left. The total size of a JSON message includes braces, quotation marks, spaces, line breaks, and message content. For details about how to calculate the size of a JSON message, see <a href="smn_ug_a1000.html#smn_ug_a1000__section11977745123756">Calculation on the JSON Message Size</a> in <a href="smn_ug_a1000.html">A.1 JSON Message Format</a>.</p>
+<div class="fignone" id="en-us_topic_0044170767__fig1130720419115"><span class="figcap"><b>Figure 1 </b>Generate JSON Message</span><br><span><img id="en-us_topic_0044170767__image8734587214" src="en-us_image_0000001366545412.png" title="Click to enlarge" class="imgResize"></span></div>
+</li><li id="en-us_topic_0044170767__li12314987211144">Click <strong id="en-us_topic_0044170767__b815873211018">OK</strong>. The system generates a JSON message.<div class="fignone" id="en-us_topic_0044170767__fig3832434220122"><span class="figcap"><b>Figure 2 </b>JSON message</span><br><span><img id="en-us_topic_0044170767__image1571216566220" src="en-us_image_0000001417145493.png" title="Click to enlarge" class="imgResize"></span></div>
+</li><li id="en-us_topic_0044170767__li3542952114596"><a name="en-us_topic_0044170767__li3542952114596"></a><a name="li3542952114596"></a>Modify the message content for each protocol so that different messages are sent to endpoints of different protocols. The system generates JSON-formatted content that includes a default message and message for each protocol. When SMN fails to match any specific message protocol, it sends the default message. For detailed JSON message format, see <a href="smn_ug_a1000.html">A.1 JSON Message Format</a>.</li><li id="en-us_topic_0044170767__li1708676313355">Click <strong id="en-us_topic_0044170767__en-us_topic_0043961403_b842352706174649">OK</strong>.<p id="en-us_topic_0044170767__p1504056193713">SMN delivers your message to all subscription endpoints. For details about messages for different protocols, see <a href="smn_ug_a3000.html">A.3 Messages of Different Protocols</a>.</p>
+</li></ol>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="smn_ug_0027.html">Publishing a Message</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>