

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Deadline Cloud でジョブを変更する
<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`ステータスに切り替わります。依存関係を持つステップは、復元`PENDING`時に `READY`または のいずれかに切り替わります。  

```
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 – タスクのステータスを変更する**  
`update-task` Deadline 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
```