すべてのプロダクト
Search

このプロダクト

    ApsaraMQ for MQTT:クライアントステータス通知のルールの管理

    ドキュメントセンター

    ApsaraMQ for MQTT:クライアントステータス通知のルールの管理

    最終更新日:Jan 14, 2025

    ApsaraMQ for MQTT クライアントがオンラインまたはオフラインになると、ApsaraMQ for MQTT ブローカーは、設定したルールに基づいて、クライアントステータス通知を Alibaba Cloud サービスにプッシュします。Elastic Compute Service (ECS) インスタンスにデプロイされたバックエンドサービスアプリケーションは、Alibaba Cloud サービスからのクライアントステータス通知をサブスクライブして、ApsaraMQ for MQTT クライアントがオンラインまたはオフラインになったときに通知を受信できます。

    プロセス

    上下线事件流出

    制限

    項目

    制限

    説明

    単一インスタンスのルール数

    100

    デフォルト値がビジネス要件を満たしていない場合は、DingTalkグループ 35228338 に参加して、ApsaraMQ for MQTT テクニカルサポートにお問い合わせください。

    ルールの重複排除

    各内部リソースに対して、同じタイプのルールを 1 つだけ作成できます。

    たとえば、ApsaraMQ for MQTT の各グループ ID に対してクライアントステータス通知のルールを 1 つだけ作成でき、ApsaraMQ for MQTT の各トピックに対してデータ受信ルールとデータ送信ルールを 1 つずつ作成できます。

    リージョン

    リージョンをまたいでルールを作成することはできません。ルールのデータソースとデータデスティネーションが属するインスタンスは、同じリージョンに存在する必要があります。

    たとえば、データソースが中国 (杭州) リージョンの ApsaraMQ for MQTT として指定されているデータ送信ルールを作成する場合、データデスティネーションとして中国 (杭州) リージョンの ApsaraMQ for RocketMQ インスタンスのみを選択できます。

    ApsaraMQ for MQTT インスタンスバージョン

    カーネルバージョンが 3.x.x のインスタンスに対してのみルールを作成できます。

    ApsaraMQ for MQTT インスタンスのカーネルバージョンは、インスタンス一覧または ApsaraMQ for MQTT コンソール のインスタンス詳細ページで確認できます。

    ApsaraMQ for RocketMQ インスタンスバージョン

    ApsaraMQ for RocketMQ 4.0 インスタンスのみがサポートされています。

    データ受信ルールまたはデータ送信ルールを使用して ApsaraMQ for MQTT と ApsaraMQ for RocketMQ 間でデータを交換する場合、ApsaraMQ for RocketMQ 4.0 インスタンスのみを使用できます。

    クライアントステータス通知のルールの作成

    1. ApsaraMQ for MQTT コンソール にログオンします。左側のナビゲーションペインで、インスタンスリスト をクリックします。

    2. 上部のナビゲーションバーで、管理するインスタンスが存在するリージョンを選択します。[インスタンス] ページで、インスタンス名をクリックして インスタンスの詳細 ページに移動します。

    3. 左側のナビゲーションペインで、ルール管理 をクリックします。[ルール] ページの左上隅にある ルールの作成 をクリックします。

    4. ルールの作成 ページで、次の手順を実行します。

      1. 基本情報の設定 ステップで、次のパラメーターを構成し、次へ をクリックします。

        パラメーター

        例

        説明

        ルール ID

        111111

        ルールの ID。ID は、ルールのグローバルに一意な識別子です。

        • ルール ID には、文字、数字、ハイフン (-)、アンダースコア (_) のみを含めることができ、少なくとも 1 つの文字または数字を含める必要があります。

        • ルール ID は 3 ～ 64 文字である必要があります。値に 64 文字を超える文字が含まれている場合は、自動的に切り捨てられます。

        • ルールの ID は、ルールが作成された後に更新することはできません。

        説明

        rocketmq から移行

        ルールの説明。

        ステータス

        有効

        現在のルールを有効にするかどうかを指定します。有効な値：

        • 有効

        • 無効

        ルールタイプ

        クライアントステータス通知

        ルールのタイプ。有効な値：

      2. ルールソースの設定 ステップで、データソースを指定し、次へ をクリックします。

        パラメーター

        例

        説明

        グループ ID

        GID_Client_Status

        イベントデータのエクスポート元となるデバイスのグループ ID。グループ ID については、「用語」をご参照ください。

      3. ルール対象の設定 ステップで、データの転送先を指定し、作成 をクリックします。

        パラメーター

        例

        説明

        デスティネーションサービスタイプ

        Message Queue for Apache RocketMQ

        ApsaraMQ for MQTT クライアントのイベントデータを転送するクラウドサービス。

        説明

        ApsaraMQ for RocketMQ のみがサポートされています。

        Message Queue for Apache RocketMQ インスタンス

        MQ_INST_13801563067*****_BbyOD2jQ

        データの転送先となる ApsaraMQ for RocketMQ インスタンスの ID。

        説明

        ApsaraMQ for MQTT インスタンスと同じリージョンにあるインスタンスのみを選択できます。

        トピック

        TopicB

        データの転送先となる ApsaraMQ for RocketMQ トピック。この例では、ApsaraMQ for MQTT クライアントのオンラインイベントまたはオフラインイベントに関する通知がトピック B に転送されます。

      ルール管理 ページで、作成したクライアントステータス通知ルールを表示できます。

    説明 ApsaraMQ for MQTT と ApsaraMQ for RocketMQ 間のメッセージ構造マッピングの詳細については、「Message Queue for MQTT と Message Queue for Apache RocketMQ 間のメッセージ構造マッピング」をご参照ください。

    クライアントステータス通知のルールの編集

    1. ルール一覧で、編集するルールを見つけます。操作 列で、詳細 > 編集 を選択します。

    2. ルールの編集 ページで、ルール ID 以外のパラメーター値をすべて変更できます。

    3. パラメーター値を変更した後、保存 を ルール対象の設定 手順でクリックします。

    クライアントステータス通知のルールの削除

    1. ルール一覧で、削除するルールを見つけます。操作 列で、詳細 > 削除 を選択します。

    2. 表示されるメッセージで、[OK] をクリックします。

    クライアントステータス通知のルールを有効にする

    1. ルール一覧で、有効にするルールを見つけます。操作 列で、詳細 > 有効化 を選択します。

    2. 表示されるメッセージで、[OK] をクリックします。

    クライアントステータス通知のルールを無効にする

    1. ルール一覧で、無効にするルールを見つけます。操作 列で、詳細 > 無効化する を選択します。

    2. 表示されるメッセージで、[OK] をクリックします。