Updated on 2023-04-12 GMT+08:00

Adding a Subscription

Scenarios

To deliver messages published to a topic to endpoints, you must add the subscription endpoints to the topic. Endpoints can be email addresses, phone numbers, and HTTP/HTTPS URLs. After you add endpoints to the topic and the subscribers confirm the subscription, they are able to receive messages published to the topic.

You can add multiple subscriptions to each topic. This section describes how to add a subscription to a topic you created or a topic that you have permissions for and how to delete a subscription.

Adding a Subscription

  1. Log in to the management console.
  2. Click on the upper left to select the desired region and project.
  3. and select Simple Message Notification under Application Service.

    The SMN console is displayed.

  4. In the navigation pane, choose Topic Management > Subscriptions.
  5. In the upper right corner, click Add Subscription.

    The Add Subscription dialog box is displayed.

  6. Specify the required subscription information.
    1. Click beside the Topic Name box to select a topic.
    2. Specify the subscription protocol and endpoints.
      Table 1 Parameter descriptions

      Parameter

      Description

      Topic Name

      Name of the topic

      Protocol

      The following protocols are supported. They include SMS, Email, HTTP, HTTPS, DingTalk chatbot, WeCom chatbot, and Lark chatbot.

      NOTE:
      • DingTalk chatbot, WeCom chatbot, and Lark chatbot are in the open beta test (OBT). To use these functions, submit a service ticket to apply for the OBT.
      • After the OBT is enabled, the IAM user token will be invalid. You need to log in to the console again to use the token. When calling an API, you need to obtain a new token.
      • The number of WeCom, DingTalk, and Lark messages that can be sent is limited, and the recipient system may be faulty. As a result, messages may fail to be sent.

        In this case, SMN does not ensure successful message delivery.

      Endpoint

      Subscription endpoint. You can add up to 10 SMS, email, HTTP, or HTTPS endpoints, one in each line.

      • SMS: Enter one or more valid phone numbers.

        Example:

        +353876612345

        +353 876612345

        +353-876612345

        +353/876612345

      • Email: Enter one or more valid email addresses.

        Example:

        username@example.com

        username2@example.com

      • HTTP: Enter one or more public network URLs.

        Example:

        http://example.com/notification/action

      • HTTPS: Enter one or more public network URLs.

        Example:

        https://example.com/notification/action

  7. Click OK.

    The subscription you added is displayed in the subscription list.

    • 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 "Traffic Control on Subscription Confirmation" in Simple Message Notification User Guide.
    • SMN does not check whether subscription endpoints exist when you add subscriptions. However, subscribers will not receive notification messages until they confirm their subscriptions.
    • After you add a subscription, SMN sends a confirmation message to your subscription endpoint. You can confirm the subscription within 48 hours through the confirmation link via your mobile phone, mailbox, or other endpoints.