查询 获取任务端点 会返回所有未删除的任务。在大型项目中,这个未筛选的列表可能难以解析。

本指南介绍了如何使用查询参数来筛选任务并获取更易读的异步操作列表。

使用 /batches 路由 筛选批处理遵循与筛选任务相同的规则。请记住,许多 /batches 参数(例如 uids)是针对批处理中包含的任务,而不是批处理本身。

要求

  • 命令行终端
  • 正在运行的 Meilisearch 项目

使用单个参数筛选任务

使用获取任务端点来获取所有 canceled 任务

curl \
  -X GET 'MEILISEARCH_URL/tasks?statuses=failed'

使用逗号分隔多个值,以获取 canceledfailed 任务

curl \
  -X GET 'MEILISEARCH_URL/tasks?statuses=failed,canceled'

您可以根据 uidstatustypeindexUidcanceledBy 或日期筛选任务。有关任务筛选参数的完整列表,请查阅 API 参考。

组合筛选器

使用和号字符 (&) 组合筛选器,这等同于逻辑 AND

curl \
  -X GET 'MEILISEARCH_URL/tasks?indexUids=movies&types=documentAdditionOrUpdate,documentDeletion&statuses=processing'

此代码示例返回 movies 索引中所有类型为 documentAdditionOrUpdatedocumentDeletionstatusprocessing 的任务。

不支持不同筛选器之间的 OR 操作。 例如,您无法查看类型为 documentAddition 状态为 failed 的任务。