Skip to content

保留消息

当用户发布了一条保留消息时,部署会将这条消息保存在系统中,用户可以在当前保留消息列表页面查看到这条消息。当用户订阅了这条保留消息的主题时,部署会将这条消息发送给用户。保留消息的有效期默认为永不过期,除非用户手动删除这条消息。

点击左侧导航菜单中的监控 -> 保留消息,可以进入保留消息页面。在该页面可以查看当前系统中所有的保留消息。

保留消息列表

保留消息列表呈现当前系统中所有的保留消息。列表内包含了保留消息的主题、保留消息的质量等级 QoS、发布保留消息的时间、还有发布该保留消息的客户端 ID。

点击列表右上角的刷新按钮可以刷新当前保留消息列表。

retain

搜索保留消息

当列表中有大量保留消息时,您可以通过主题筛选保留消息,以显示您想要查看的保留消息。您可以在搜索框中输入特定的主题名称,或使用通配符进行搜索。

提示

Serverless 部署不支持搜索功能。

查看 Payload

您可以查看保留消息的 payload。在列表中,点击保留消息条目操作列中的查看 payload 图标,即可查看消息 payload。

查看 Payload 弹出窗口中,您可以查看保留消息 payload 的具体内容。您可以点击复制按钮快速复制 payload。在下拉框中,您还可以选择 payload 的格式化输出,这样可以更直观地查看一些特殊的 payload 格式,例如 JSON 或 Hex 格式。

retain

删除保留消息

您可以通过以下方式删除保留消息:

  1. 在保留消息的主题上发布一条空消息。

  2. 点击操作列中的删除图标,删除单条保留消息条目。

  3. 点击右上角的删除图标,删除列表中的所有保留消息。

    提示

    Serverless 部署不支持删除所有保留消息的功能。

TIP

关于保留消息的大小及存储条目限制,请查看配额和限制