すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:保持されたメッセージ

最終更新日:Jun 19, 2026

保持されたメッセージとは、トピックの新しいサブスクライバーが、サブスクライブ前に発行された最新のステータスメッセージを確実に受信できるようにする機能です。サーバーが Retain フラグ を設定したメッセージをトピックに発行すると、IoT Platform はそのメッセージを保存し、現在のサブスクライバーに配信します。その後トピックをサブスクライブしたデバイスも、この 保持されたメッセージ を受信します。保持されたメッセージは MQTT 3.1.1 標準で定義されています。Alibaba Cloud IoT Platform は、MQTT 5.0 接続でこの機能をサポートしています。

保持されたメッセージimage..png

  • 保持されたメッセージの更新:

    • 同じトピックに新しいメッセージを発行すると、既存の保持されたメッセージのペイロードが上書きされます。

    • Retain フラグ を使用すると、メッセージがトピックに保持されるため、デバイスが発行時にオフラインであっても、後でサブスクライブした際にそのメッセージを受信できます。

  • 保持されたメッセージの削除:

    • 同じトピックに空のペイロードを持つメッセージを発行すると、保持されたメッセージが削除されます。

    • 保持されたメッセージは、メッセージの有効期限が経過すると削除されます。この機能は、温度制御データなど、一定期間後に無効になるメッセージに有効です。この機能を使用するには、メッセージの有効期限属性を設定する必要があります。

    • 保持されたメッセージは セッションの有効期限 の影響を受けず、セッションが期限切れになっても保持され続けます。

シナリオ

保持されたメッセージは、オフラインデバイスの設定に最適です。例えば、広告画面は省エネのために夜間は休止状態になり、日中に起動します。そのコンテンツは毎日更新されます。サーバーから更新をプッシュする方が、デバイスが変更をポーリングするよりも効率的です。しかし、デバイスがオフラインの間にサーバーが更新をプッシュした場合、メッセージを配信できません。保持されたメッセージは、デバイスが次回オンラインになったときに最新のメッセージを確実に受信できるようにすることで、この問題を解決します。image..png