恢复配置任务
查找尚未完成的配置作业,重试生成失败的指导内容,同时保留已成功生成的集合。
创建成功后,请立即保存配置作业的 id 和 engineId。如果客户端断开连接,或等待后仍无法确认结果,请使用 GET /v2/provisioning/jobs/:id。作业状态和各类型的状态决定了哪些内容需要恢复。
查找运行中的任务 #
GET /v2/organizations/:orgId/provisioning/jobs?status=running
X-API-Key: YOUR_API_KEYstatus=running 为必填项。响应中的 data 是一个数组,列出所有可见的运行中作业,不采用游标分页。添加 startedBy=me 可将结果限定为当前已认证用户启动的作业。服务密钥不关联用户身份,因此使用此筛选条件会返回空列表。
如果创建新引擎的响应丢失,还应检查 GET /v2/organizations/:orgId/engines 和控制面板,查找已创建的引擎。作业可能已完成,不再出现在运行中的作业列表中。重复发送创建请求可能会创建另一个引擎。
重试失败的类型 #
POST /v2/provisioning/jobs/:id/retry
X-API-Key: YOUR_API_KEY此请求无需请求体。它会返回同一引擎上的一个新作业,并沿用原始来源。只有失败且仍为空的类型会被选中;已完成的集合会保留。请保存返回的作业 ID,并跟踪作业直至完成。
NothingToProvision(409)表示已没有符合重试条件的失败类型,例如,其他操作已为其附加了集合。ProvisioningJobRunning(409)表示该引擎上已有任务正在运行。重试前,请先查看这些资源。
如果需要更改原始来源,请使用修正后的来源在现有引擎上提交新作业,并明确选择 Empty 或 Requested。重试路由会沿用原始输入。
处理限制和启动未完成的问题 #
ProvisioningLimitReached(429)包含 retryAt。请等到该时间后再提交。如果失败原因涉及积分、套餐或访问权限,则需要相应调整账户或权限。
即使请求返回服务器错误,工作流启动失败后仍可能留下一个新的空引擎。再次创建新引擎前,请先检查引擎列表。如果现有引擎正是您原本打算配置的引擎,请复用它。
作业结束后,请先在 Studio 中审核生成的指导内容,再使用这些内容进行翻译。