

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Modificar um trabalho no Deadline Cloud
<a name="build-jobs-modifying"></a>

Você pode usar os seguintes `update` comandos AWS Command Line Interface (AWS CLI) para modificar a configuração de um trabalho ou definir o status de destino de um trabalho, etapa ou tarefa: ``
+ `aws deadline update-job`
+ `aws deadline update-step`
+ `aws deadline update-task`

Nos exemplos de `update` comandos a seguir, substitua cada um *`user input placeholder`* por suas próprias informações.

**Example — Solicitar um trabalho**  
Todas as tarefas na tarefa mudam para o `READY` status, a menos que haja dependências de etapas. As etapas com dependências mudam para uma `READY` ou à `PENDING` medida que são restauradas.  

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

**Example — Cancelar um trabalho**  
Todas as tarefas no trabalho que não têm o status `SUCCEEDED` ou `FAILED` estão marcadas`CANCELED`.  

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

**Example — Marcar que um trabalho falhou**  
Todas as tarefas no trabalho que têm o status permanecem `SUCCEEDED` inalteradas. Todas as outras tarefas estão marcadas`FAILED`.  

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

**Example — Marque um trabalho bem-sucedido**  
Todas as tarefas do trabalho são transferidas para o `SUCCEEDED` estado.  

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

**Example — Suspender um emprego**  
As tarefas no trabalho no `FAILED` estado `SUCCEEDED``CANCELED`, ou não mudam. Todas as outras tarefas estão marcadas`SUSPENDED`.  

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

**Example — Mudar a prioridade de um trabalho**  
Atualiza a prioridade de um trabalho em uma fila para alterar a ordem em que ele está agendado. Os trabalhos de maior prioridade geralmente são agendados primeiro.  

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

**Example — Alterar o número de tarefas com falha permitidas**  
Atualiza o número máximo de tarefas com falha que o trabalho pode ter antes que as tarefas restantes sejam canceladas.  

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

**Example — Alterar o número de novas tentativas de tarefas permitidas**  
Atualiza o número máximo de tentativas de uma tarefa antes que a tarefa falhe. Uma tarefa que tenha atingido o número máximo de novas tentativas não pode ser colocada novamente na fila até que esse valor seja aumentado.  

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

**Example — Arquivar um trabalho**  
Atualiza o status do ciclo de vida do trabalho para. `ARCHIVED` Os trabalhos arquivados não podem ser agendados nem modificados. Você só pode arquivar um trabalho que esteja no `SUSPENDED` estado `FAILED``CANCELED`,`SUCCEEDED`,, ou.  

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

**Example — Alterar o nome de um emprego**  
Atualiza o nome de exibição de um trabalho. O nome do trabalho pode ter até 128 caracteres.  

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

**Example — Alterar a descrição de um trabalho**  
Atualiza a descrição de um trabalho. A descrição pode ter até 2048 caracteres. Para remover a descrição existente, passe uma string vazia.  

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

**Example — Recoloque uma etapa na fila**  
Todas as tarefas na etapa mudam para o `READY` estado, a menos que haja dependências de etapas. As tarefas em etapas com dependências mudam para `READY` ou`PENDING`, e a tarefa é restaurada.  

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

**Example — Cancelar uma etapa**  
Todas as tarefas na etapa que não têm o status `SUCCEEDED` ou `FAILED` estão marcadas`CANCELED`.  

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

**Example — Marcar uma etapa que falhou**  
Todas as tarefas na etapa que têm o status permanecem `SUCCEEDED` inalteradas. Todas as outras tarefas estão marcadas`FAILED`.  

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

**Example — Marque uma etapa bem-sucedida**  
Todas as tarefas na etapa estão marcadas`SUCCEEDED`.  

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

**Example — Suspender uma etapa**  
As tarefas na etapa do `FAILED` estado `SUCCEEDED``CANCELED`,, ou não mudam. Todas as outras tarefas estão marcadas`SUSPENDED`.  

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

**Example — Alterar o status de uma tarefa**  
Quando você usa o comando da CLI do `update-task` Deadline Cloud, a tarefa muda para o status especificado.  

```
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
```