篩選任務

    查詢 get tasks 端點 會回傳所有未被刪除的任務。這個未經篩選的列表在大型專案中可能難以解析。

    本指南將說明如何使用查詢參數來篩選任務,並取得更易讀的非同步操作列表。

    篩選批次

    使用 /batches 路由 篩選批次的規則與篩選任務相同。請注意,許多 /batches 參數(例如 uids)針對的是批次中包含的任務,而不是批次本身。

    需求

    使用單一參數篩選任務

    使用 get tasks 端點來擷取所有 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 索引中,類型為 documentAdditionOrUpdatedocumentDeletion,且 statusprocessing 的所有任務。

    警告

    不支援不同篩選條件之間的 OR 運算。例如,您無法檢視類型為 documentAddition 狀態為 failed 的任務。