# 运行、恢复和重试工作流作业

启动工作流作业，跟踪作业、节点、文件执行和结果，并在需要时暂停、恢复、重新运行、重试、取消或删除作业。本页不修改工作流定义；请在[管理工作流和模板](workflows-templates.md)中维护工作流和模板。

## 前提条件

准备可访问目标工作区的凭据和需要运行的工作流标识。有关服务地址、认证和通用请求格式，请参阅[调用前准备](../../api-call-basics.md)。

对已有作业执行暂停、恢复、重试、取消、重新运行或删除前，先从作业列表或详情取得目标作业标识。

## 调用顺序

1. 启动工作流作业，并保留作业标识；对于已有作业，先查询列表或详情确定当前对象。
2. 查询作业详情、节点、文件执行记录和作业结果，分别检查运行情况、节点情况、文件处理情况和输出。
3. 需要更新作业的当前状态信息时刷新状态；需要临时停止或继续时，依次使用暂停和恢复操作。
4. 出现需要再次处理的情况时，先查询重新运行计划，再从指定节点重新运行，或按单个、批量作业执行重试；必要时取消重新运行或作业。
5. 仅在确认不再需要保留作业时删除。

## API 操作

### 启动和查看作业

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 启动工作流作业 | [启动工作流作业](../../../../reference/api/ai-studio/data-processing/workflow-jobs/start-workflow-job.md) | 需要为工作流创建一次运行时使用。 |
| 查询工作流作业列表 | [查看工作流作业列表](../../../../reference/api/ai-studio/data-processing/workflow-jobs/list-workflow-jobs.md) | 查找作业或取得目标作业标识时使用。 |
| 查询工作流作业详情 | [查看工作流作业详情](../../../../reference/api/ai-studio/data-processing/workflow-jobs/get-workflow-job.md) | 检查单个作业当前信息时使用。 |
| 查询工作流作业节点 | [查看工作流作业节点](../../../../reference/api/ai-studio/data-processing/workflow-jobs/get-workflow-job-node.md) | 需要查看作业中的节点时使用。 |
| 查询文件执行记录 | [查看文件执行记录](../../../../reference/api/ai-studio/data-processing/workflow-jobs/list-file-executions.md) | 需要检查文件处理记录时使用。 |
| 查询工作流作业结果 | [查看工作流作业结果](../../../../reference/api/ai-studio/data-processing/workflow-jobs/get-workflow-job-result.md) | 需要取得或检查作业结果时使用。 |
| 刷新工作流作业状态 | [刷新工作流作业状态](../../../../reference/api/ai-studio/data-processing/workflow-jobs/refresh-workflow-job.md) | 需要刷新作业当前状态时使用。 |

### 控制作业

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 暂停工作流作业 | [暂停工作流作业](../../../../reference/api/ai-studio/data-processing/workflow-jobs/pause-workflow-job.md) | 需要暂时停止目标作业时使用。 |
| 恢复工作流作业 | [恢复工作流作业](../../../../reference/api/ai-studio/data-processing/workflow-jobs/resume-workflow-job.md) | 需要继续已暂停作业时使用。 |
| 取消工作流作业 | [取消工作流作业](../../../../reference/api/ai-studio/data-processing/workflow-jobs/cancel-workflow-job.md) | 不再需要继续执行目标作业时使用。 |
| 删除工作流作业 | [删除工作流作业](../../../../reference/api/ai-studio/data-processing/workflow-jobs/delete-workflow-job.md) | 确认不再需要保留该作业后使用。 |

### 重新运行和重试

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询节点重新运行计划 | [查看节点重新运行计划](../../../../reference/api/ai-studio/data-processing/workflow-reruns/get-node-rerun-plan.md) | 从指定节点重新运行前确认可用计划。 |
| 从指定节点重新运行 | [从指定节点重新运行](../../../../reference/api/ai-studio/data-processing/workflow-reruns/create-node-rerun.md) | 需要从选定节点重新开始处理时使用。 |
| 查询工作流重新运行列表 | [查看工作流重新运行列表](../../../../reference/api/ai-studio/data-processing/workflow-reruns/list-workflow-reruns.md) | 查找已有重新运行记录时使用。 |
| 查询工作流重新运行详情 | [查看工作流重新运行详情](../../../../reference/api/ai-studio/data-processing/workflow-reruns/get-workflow-rerun.md) | 检查单个重新运行当前信息时使用。 |
| 取消工作流重新运行 | [取消工作流重新运行](../../../../reference/api/ai-studio/data-processing/workflow-reruns/cancel-workflow-rerun.md) | 不再需要继续目标重新运行时使用。 |
| 重试工作流作业 | [重试工作流作业](../../../../reference/api/ai-studio/data-processing/workflow-retries/retry-workflow-job.md) | 需要重试单个作业时使用。 |
| 批量重试工作流作业 | [批量重试工作流作业](../../../../reference/api/ai-studio/data-processing/workflow-retries/batch-retry-workflow-jobs.md) | 需要同时重试多个作业时使用。 |

## 结果确认

启动、恢复、取消、重新运行或重试后，使用[查看工作流作业详情](../../../../reference/api/ai-studio/data-processing/workflow-jobs/get-workflow-job.md)或[查看工作流重新运行详情](../../../../reference/api/ai-studio/data-processing/workflow-reruns/get-workflow-rerun.md)检查当前信息；需要确认输出时，查看[查看工作流作业结果](../../../../reference/api/ai-studio/data-processing/workflow-jobs/get-workflow-job-result.md)。

## 限制和注意事项

- 启动、恢复、重试或重新运行表示已发起相应操作；作业详情、节点、文件执行记录和结果用于确认后续情况。
- 取消、删除和重新运行前，先确认目标作业及其输出的影响范围。

## 下一步

- [管理工作流和模板](workflows-templates.md)
- [管理工作流产物和数据血缘](workflow-artifacts-lineage.md)