

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在截止日期云中修改作业
<a name="build-jobs-modifying"></a>

您可以使用以下 AWS Command Line Interface (AWS CLI) `update` 命令修改作业的配置，或者设置作业、步骤或任务的目标状态：``
+ `aws deadline update-job`
+ `aws deadline update-step`
+ `aws deadline update-task`

在以下命令示例中，将每个`update`命令替换*`user input placeholder`*为您自己的信息。

**Example — 重新排队作业**  
除非存在步骤依赖关系，否则作业中的所有任务都会切换到`READY`状态。具有依赖关系的步骤在恢复时切换到任一`READY`或`PENDING`。  

```
aws deadline update-job \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--target-task-run-status PENDING
```

**Example — 取消作业**  
作业中所有没有状态`SUCCEEDED`或已标记`FAILED`的任务`CANCELED`。  

```
aws deadline update-job \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--target-task-run-status CANCELED
```

**Example — 将任务标记为失败**  
作业中所有处于该状态的任务`SUCCEEDED`都保持不变。所有其他任务都已标记`FAILED`。  

```
aws deadline update-job \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--target-task-run-status FAILED
```

**Example — 将工作标记为成功**  
作业中的所有任务都将变为`SUCCEEDED`状态。  

```
aws deadline update-job \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--target-task-run-status SUCCEEDED
```

**Example — 暂停作业**  
作业中处于`SUCCEEDED``CANCELED`、或`FAILED`状态的任务不会改变。所有其他任务都已标记`SUSPENDED`。  

```
aws deadline update-job \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--target-task-run-status SUSPENDED
```

**Example — 更改作业的优先级**  
更新队列中任务的优先级以更改其调度顺序。优先级较高的作业通常先安排。  

```
aws deadline update-job \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--priority 100
```

**Example — 更改允许的失败任务数**  
更新在取消剩余任务之前该任务可以执行的最大失败任务数。  

```
aws deadline update-job \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--max-failed-tasks-count 200
```

**Example — 更改允许的任务重试次数**  
更新任务失败前任务的最大重试次数。已达到最大重试次数的任务在增加该值之前无法重新排队。  

```
aws deadline update-job \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--max-retries-per-task 10
```

**Example — 存档作业**  
将作业的生命周期状态更新为`ARCHIVED`。无法安排或修改已存档的作业。您只能存档处于`FAILED`、`CANCELED``SUCCEEDED`、或`SUSPENDED`状态的作业。  

```
aws deadline update-job \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--lifecycle-status ARCHIVED
```

**Example — 更改作业的名称**  
更新作业的显示名称。任务名称的长度最多为 128 个字符。  

```
aws deadline update-job \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--name "New Job Name"
```

**Example — 更改职位描述**  
更新任务描述。描述的长度最多可为 2048 个字符。要删除现有描述，请传递一个空字符串。  

```
aws deadline update-job \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--description "New Job Description"
```

**Example — 重新排队步骤**  
除非存在步骤依赖关系，否则步骤中的所有任务都会切换到`READY`状态。具有依赖关系的步骤中的任务会切换到`READY`或`PENDING`，任务将恢复。  

```
aws deadline update-step \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--step-id stepID \
--target-task-run-status PENDING
```

**Example — 取消步骤**  
步骤中所有没有状态`SUCCEEDED`或已标记`FAILED`的任务`CANCELED`。  

```
aws deadline update-step \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--step-id stepID \
--target-task-run-status CANCELED
```

**Example — 将步骤标记为失败**  
步骤中所有状态为的任务`SUCCEEDED`均保持不变。所有其他任务都已标记`FAILED`。  

```
aws deadline update-step \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--step-id stepID \
--target-task-run-status FAILED
```

**Example — 将步骤标记为成功**  
该步骤中的所有任务都已标记`SUCCEEDED`。  

```
aws deadline update-step \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--step-id stepID \
--target-task-run-status SUCCEEDED
```

**Example — 暂停步骤**  
处于`SUCCEEDED``CANCELED`、或`FAILED`状态的步骤中的任务不会更改。所有其他任务都已标记`SUSPENDED`。  

```
aws deadline update-step \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--step-id stepID \
--target-task-run-status SUSPENDED
```

**Example — 更改任务的状态**  
当您使用 De `update-task` adline Cloud CLI 命令时，任务会切换到指定的状态。  

```
aws deadline update-task \
--farm-id farmID \
--queue-id queueID \
--job-id jobID \
--step-id stepID \
--task-id taskID \
--target-task-run-status SUCCEEDED | SUSPENDED | CANCELED | FAILED | PENDING
```