取消批量操作 - Fluz

停止尚未完成的批量作业。尚未开始的条目将被取消；已在运行的条目将被允许完成。

cancelBulkOperation 会停止你提交的作业。它是尽力而为且不可逆的：仍处于 QUEUED 的条目会被取消，而已在 RUNNING 的条目会被允许完成并记录其结果。它不会回滚已完成的工作。

目前仅在 staging 可用。

要求

Authorization: Basic <API_KEY>
你的应用已启用批量 API 能力。
作业必须属于你的应用——未知或属于其他应用的作业 ID 将返回 not-found。

变更

mutation CancelBulkOperation($bulkJobId: UUID!) {
  cancelBulkOperation(bulkJobId: $bulkJobId) {
    jobId
    status
    succeededItemCount
    failedItemCount
    skippedItemCount
  }
}

{
  "bulkJobId": "9c1e6f2a-1d4b-4a2e-8f0c-2b7e5a9d1234"
}

响应

{
  "data": {
    "cancelBulkOperation": {
      "jobId": "9c1e6f2a-1d4b-4a2e-8f0c-2b7e5a9d1234",
      "status": "CANCELLED",
      "succeededItemCount": 4,
      "failedItemCount": 0,
      "skippedItemCount": 0
    }
  }
}

参数

参数	类型	描述
`bulkJobId`	`UUID!`	由 `submitBulkOperation` 返回的作业 ID。

响应字段

字段	描述
`status`	作业停止接受新工作后为 `CANCELLED`。已成功或失败的条目会保留其结果。
`succeededItemCount` / `failedItemCount` / `skippedItemCount`	最终的逐条目计数，包括在取消请求生效后仍然完成的条目。

错误

错误	HTTP	触发时机
`BulkApiAccessDenied`	403	你的应用未启用批量 API 能力。
`BulkJobNotFound`	404	作业 ID 未知或属于其他应用（有意不可区分）。

取消已完成或已取消的作业不是错误——它会返回未更改的作业（见下文）。

取消操作是幂等且可安全重试的。对于已完成（COMPLETED、COMPLETED_WITH_ERRORS、FAILED）或已 CANCELLED 的作业，调用将返回未更改的作业——永不报错，且从不撤销已完成的条目。由于进行中的条目被允许完成，如果你在取消后需要最终结算的计数，请使用跟踪批量作业进行轮询。