本文介绍了创建和管理队列以用于通过 Vault Java SDK 创建的自定义作业。您可以了解有关开发人员门户中的 Vault Java SDK 的更多信息。
SDK 作业队列允许您处理自定义队列中的消息(也称为任务),而不是处理一个系统队列中的所有消息。这样有助于提高性能,并有助于启用或禁用特定队列而不是同时启用或禁用所有队列。
访问 SDK 作业队列管理
从管理 > 操作 > SDK 作业队列查看和管理队列。您必须拥有授予管理:SDK 作业队列权限的安全配置文件才能使用队列。
如何创建 SDK 作业队列
要创建新队列:
- 从 SDK 作业队列页面中,单击创建。
- 为此队列输入标签。这是在 Vault UI 中向管理员显示的标签。
- Vault 会自动填充名称字段。这是从 Vault Java SDK 代码调用该队列时的队列名称。如果需要,您可以修改此名称。字符之间只允许使用小写字母、字母数字字符和下划线 (_)。
- 为此队列选择状态。只有活动队列可以已接收消息。
- 可选:为此队列输入描述。
- 单击保存。
创建 SDK 任务队列后,您可能想要将其添加到 SDK 作业元数据。
如何停用 SDK 作业队列
如果您希望 SDK 作业队列停止接收消息,必须将队列状态设置为非活动。设置为非活动后,队列无法接受任何新消息。
这不会阻止队列处理已经在队列中的消息。例如,如果在停用之前该队列中已有消息,则仍会处理这些消息。如果您希望停止处理队列中已经存在的消息,则必须禁用传递。
要停用队列:
- 在队列详细信息页面中,单击编辑。
- 将状态设置为非活动。
- 单击保存。
非活动队列会立即停止接受消息。如果您想重新激活队列,则可以使用相同的流程来执行此操作。一旦队列处于活动状态,将再次开始接受消息。
如何禁用传递
如果您希望 SDK 作业队列停止将现有消息传递到作业处理器,则必须禁用传递。这样不会阻止新消息进入队列。例如,传递状态设置为已禁用的活动队列仍将允许新消息进入队列,但没有任何消息会离开队列。
要禁用队列:
- 导航到您希望禁用传递的 SDK 作业队列。
- 从所有操作菜单中,选择禁用传递。
- 该队列现已禁用。在队列详细信息中,传递状态现在显示为已禁用。
如果您希望此队列再次开始传递消息到处理器,可以使用相同的流程启用该队列。
如何删除 SDK 作业队列中的所有消息
即使更改队列的状态或传递状态,也不会删除该队列中的任何消息。例如,传递状态设置为已禁用的非活动队列无法接收或处理消息,但队列中的任何消息仍然存在。如果您不再需要这些消息,可以重置队列。
重置队列是一项永久操作,不可撤销。
要重置队列:
- 导航到您要重置的 SDK 作业队列的详细信息页面。
- 单击重置队列。
- 阅读警告后,单击继续。
- 该流程完成后,您将收到绿色横幅通知,表明 Vault 已成功重置队列。