查询 get tasks 端点 会返回所有未被删除的任务。在大型项目中,这个未经过滤的列表可能难以解析。

本指南将向您展示如何使用查询参数来筛选任务,获取更易读的异步操作列表。

前提条件

  • 命令行终端
  • 运行中的 Meilisearch 项目

使用单一参数筛选任务

使用 get tasks 端点获取所有 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 索引中所有类型为 documentAdditionOrUpdatedocumentDeletion 且状态为 processing(处理中)的任务。