

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Modificar un trabajo en Deadline Cloud
<a name="build-jobs-modifying"></a>

Puede usar los siguientes `update` comandos AWS Command Line Interface (AWS CLI) para modificar la configuración de un trabajo o para establecer el estado objetivo de un trabajo, paso o tarea: ``
+ `aws deadline update-job`
+ `aws deadline update-step`
+ `aws deadline update-task`

En los siguientes ejemplos de `update` comandos, sustituya cada uno *`user input placeholder`* por su propia información.

**Example — Volver a poner en cola un trabajo**  
Todas las tareas del trabajo cambian al `READY` estado, a menos que haya dependencias entre pasos. Los pasos con dependencias cambian a uno `READY` o a `PENDING` medida que se restauran.  

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

**Example — Cancelar un trabajo**  
Todas las tareas del trabajo que no tienen el estado `SUCCEEDED` o `FAILED` están marcadas`CANCELED`.  

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

**Example — Marcar un trabajo fallido**  
Todas las tareas del trabajo que tienen ese estado `SUCCEEDED` permanecen sin cambios. Todas las demás tareas están marcadas`FAILED`.  

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

**Example — Marcar un trabajo como exitoso**  
Todas las tareas del trabajo se trasladan al `SUCCEEDED` estado.  

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

**Example — Suspender un trabajo**  
Las tareas del trabajo en el `FAILED` estado `SUCCEEDED``CANCELED`, o no cambian. Todas las demás tareas están marcadas`SUSPENDED`.  

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

**Example — Cambiar la prioridad de un trabajo**  
Actualiza la prioridad de un trabajo en una cola para cambiar el orden en que está programado. Por lo general, los trabajos de mayor prioridad se programan primero.  

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

**Example — Cambiar el número de tareas fallidas permitidas**  
Actualiza el número máximo de tareas fallidas que puede tener el trabajo antes de que se cancelen las tareas restantes.  

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

**Example — Cambia el número de reintentos de tareas permitidos**  
Actualiza el número máximo de reintentos de una tarea antes de que se produzca un error en la tarea. Una tarea que ha alcanzado el número máximo de reintentos no se puede volver a poner en cola hasta que se aumente este valor.  

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

**Example — Archivar un trabajo**  
Actualiza el estado del ciclo de vida del trabajo a`ARCHIVED`. Los trabajos archivados no se pueden programar ni modificar. Solo puede archivar un trabajo que se encuentre en el `SUSPENDED` estado `FAILED``CANCELED`,`SUCCEEDED`, o.  

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

**Example — Cambiar el nombre de un trabajo**  
Actualiza el nombre para mostrar de un trabajo. El nombre del trabajo puede tener hasta 128 caracteres.  

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

**Example — Cambiar la descripción de un trabajo**  
Actualiza la descripción de un trabajo. La descripción puede tener una longitud máxima de 2048 caracteres. Para eliminar la descripción existente, pase una cadena vacía.  

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

**Example — Volver a poner en cola un paso**  
Todas las tareas del paso cambian al `READY` estado, a menos que haya dependencias entre pasos. Las tareas de los pasos con dependencias cambian a uno `READY` o `PENDING` varios pasos y la tarea se restaura.  

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

**Example — Cancelar un paso**  
Todas las tareas del paso que no tienen el estado `SUCCEEDED` o `FAILED` están 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 un paso como fallido**  
Todas las tareas del paso que tienen ese estado `SUCCEEDED` permanecen sin cambios. Todas las demás tareas están marcadas`FAILED`.  

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

**Example — Marcar un paso como exitoso**  
Todas las tareas del paso están 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 un paso**  
Las tareas del paso en el `FAILED` estado `SUCCEEDED``CANCELED`, o no cambian. Todas las demás tareas están marcadas`SUSPENDED`.  

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

**Example — Cambiar el estado de una tarea**  
Al utilizar el comando CLI de `update-task` Deadline Cloud, la tarea cambia al estado 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
```