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.

# Elementos de valores de parámetros para paquetes de trabajos
<a name="build-job-bundle-parameters"></a>

Puede usar el archivo de parámetros para establecer los valores de algunos de los parámetros del trabajo en la plantilla de trabajo o los argumentos de la solicitud de [CreateJob](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html)operación del paquete de trabajos, de modo que no necesite establecer valores al enviar un trabajo. La interfaz de usuario para el envío de trabajos le permite modificar estos valores.

Puede definir la plantilla de trabajo en formato YAML (`parameter_values.yaml`) o formato JSON (`parameter_values.json`). Los ejemplos de esta sección se muestran en formato YAML.

En YAML, el formato del archivo es:

```
parameterValues:
- name: <string>
  value: <integer>, <float>, or <string>
- name: <string>
  value: <integer>, <float>, or <string>ab
... {{repeating as necessary}}
```

Cada elemento de la `parameterValues` lista debe ser uno de los siguientes:
+ Un parámetro de trabajo definido en la plantilla de trabajo.
+ Un parámetro de trabajo definido en un entorno de colas para la cola a la que se envía el trabajo.
+ Parámetro especial que se transfiere a la `CreateJob` operación al crear un trabajo.
  + `deadline:priority`— El valor debe ser un número entero. Se pasa a la `CreateJob` operación como parámetro de [prioridad](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-priority).
  + `deadline:targetTaskRunStatus`— El valor debe ser una cadena. Se pasa a la `CreateJob` operación como parámetro de [targetTaskRunestado](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-targetTaskRunStatus).
  + `deadline:maxFailedTasksCount`— El valor debe ser un número entero. Se pasa a la `CreateJob` operación como parámetro [maxFailedTasksCount](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-maxFailedTasksCount).
  + `deadline:maxRetriesPerTask`— El valor debe ser un número entero. Se pasa a la `CreateJob` operación como parámetro de [maxRetriesPertarea](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-maxRetriesPerTask).
  + `deadline:maxWorkercount`— El valor debe ser un número entero. Se pasa a la `CreateJob` operación como [maxWorkerCount](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-maxRetriesPerTask)parámetro.

Una plantilla de trabajo es siempre una plantilla y no un trabajo específico que ejecutar. Un archivo de valores de parámetros permite que un paquete de trabajos actúe como plantilla si algunos parámetros no tienen valores definidos en este archivo, o como un envío de trabajo específico si todos los parámetros tienen valores.

Por ejemplo, el [ejemplo de blender\_render](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles/blender_render) no tiene un archivo de parámetros y su plantilla de trabajo define parámetros sin valores predeterminados. Esta plantilla debe usarse como plantilla para crear trabajos. Después de crear un trabajo con este paquete de trabajos, Deadline Cloud escribe un nuevo paquete de trabajos en el directorio del historial de trabajos. 

Por ejemplo, cuando envías un trabajo con el siguiente comando:

```
deadline bundle gui-submit blender_render/
```

El nuevo paquete de trabajos contiene un `parameter_values.yaml` archivo que contiene los parámetros especificados:

```
% cat ~/.deadline/job_history/\(default\)/2024-06/2024-06-20-01-JobBundle-Demo/parameter_values.yaml
parameterValues:
- name: deadline:targetTaskRunStatus
  value: READY
- name: deadline:maxFailedTasksCount
  value: 10
- name: deadline:maxRetriesPerTask
  value: 5
- name: deadline:priority
  value: 75
- name: BlenderSceneFile
  value: /private/tmp/bundle_demo/bmw27_cpu.blend
- name: Frames
  value: 1-10
- name: OutputDir
  value: /private/tmp/bundle_demo/output
- name: OutputPattern
  value: output_####
- name: Format
  value: PNG
- name: CondaPackages
  value: blender
- name: RezPackages
  value: blender
```

Puede crear el mismo trabajo con el siguiente comando:

```
deadline bundle submit ~/.deadline/job_history/\(default\)/2024-06/2024-06-20-01-JobBundle-Demo/
```

**nota**  
El paquete de trabajos que envíe se guarda en el directorio del historial de trabajos. Puede encontrar la ubicación de ese directorio con el siguiente comando:  

```
deadline config get settings.job_history_dir
```