筛选任务

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

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

    筛选批次

    使用/batches 路由筛选批次遵循与筛选任务相同的规则。请注意,许多 /batches 参数(如 uids)的目标是批次中包含的任务,而不是批次本身。

    要求

    使用单个参数筛选任务

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

    curl \
      -X GET 'https://127.0.0.1:7700/tasks?statuses=failed'

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

    curl \
      -X GET 'https://127.0.0.1:7700/tasks?statuses=failed,canceled'

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

    组合筛选器

    使用与号字符(&)组合筛选器,等效于逻辑 AND

    curl \
      -X GET 'https://127.0.0.1:7700/tasks?indexUids=movies&types=documentAdditionOrUpdate,documentDeletion&statuses=processing'

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

    警告

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