本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 在截止日期雲端中修改任務 您可以使用下列 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`、`SUCCEEDED`、 `CANCELED`或 `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`截止日期雲端 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 ```