本文介绍了创建和管理队列以用于通过 Vault Java SDK 创建的自定义作业。您可以了解有关开发人员门户中的 Vault Java SDK 的更多信息。

SDK 作业队列允许您处理自定义队列中的消息(也称为任务),而不是处理一个系统队列中的所有消息。这样有助于提高性能,并有助于启用或禁用特定队列而不是同时启用或禁用所有队列。

访问 SDK 作业队列管理

管理 > 操作 > SDK 作业队列查看和管理队列。您必须拥有授予管理:SDK 作业队列权限的安全配置文件才能使用队列。

如何创建 SDK 作业队列

要创建新队列:

  1. SDK 作业队列页面中,单击创建
  2. 为此队列输入标签。这是在 Vault UI 中向管理员显示的标签。
  3. Vault 会自动填充名称字段。这是从 Vault Java SDK 代码调用该队列时的队列名称。如果需要,您可以修改此名称。字符之间只允许使用小写字母、字母数字字符和下划线 (_)。
  4. 为此队列选择状态。只有活动队列可以已接收消息。
  5. 可选:为此队列输入描述
  6. 单击保存

创建 SDK 任务队列后,您可能想要将其添加到 SDK 作业元数据。

如何停用 SDK 作业队列

如果您希望 SDK 作业队列停止接收消息,必须将队列状态设置为非活动。设置为非活动后,队列无法接受任何新消息。

这不会阻止队列处理已经在队列中的消息。例如,如果在停用之前该队列中已有消息,则仍会处理这些消息。如果您希望停止处理队列中已经存在的消息,则必须禁用传递

要停用队列:

  1. 在队列详细信息页面中,单击编辑
  2. 状态设置为非活动
  3. 单击保存

非活动队列会立即停止接受消息。如果您想重新激活队列,则可以使用相同的流程来执行此操作。一旦队列处于活动状态,将再次开始接受消息。

如何禁用传递

如果您希望 SDK 作业队列停止将现有消息传递到作业处理器,则必须禁用传递。这样不会阻止新消息进入队列。例如,传递状态设置为已禁用活动队列仍将允许新消息进入队列,但没有任何消息会离开队列。

要禁用队列:

  1. 导航到您希望禁用传递的 SDK 作业队列。
  2. 所有操作菜单中,选择禁用传递
  3. 该队列现已禁用。在队列详细信息中,传递状态现在显示为已禁用

如果您希望此队列再次开始传递消息到处理器,可以使用相同的流程启用该队列。

如何删除 SDK 作业队列中的所有消息

即使更改队列的状态传递状态,也不会删除该队列中的任何消息。例如,传递状态设置为已禁用非活动队列无法接收或处理消息,但队列中的任何消息仍然存在。如果您不再需要这些消息,可以重置队列。

重置队列是一项永久操作,不可撤销。

要重置队列:

  1. 导航到您要重置的 SDK 作业队列的详细信息页面。
  2. 单击重置队列
  3. 阅读警告后,单击继续
  4. 该流程完成后,您将收到绿色横幅通知,表明 Vault 已成功重置队列。