

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á.

# Elementos de valores de parâmetros para pacotes de tarefas
<a name="build-job-bundle-parameters"></a>

Você pode usar o arquivo de parâmetros para definir os valores de alguns dos parâmetros do trabalho no modelo de trabalho ou argumentos da solicitação de [CreateJob](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html)operação no pacote de trabalhos para que você não precise definir valores ao enviar um trabalho. A interface do usuário para envio de trabalhos permite que você modifique esses valores.

Você pode definir o modelo de trabalho no formato YAML (`parameter_values.yaml`) ou no formato JSON (`parameter_values.json`). Os exemplos nesta seção são mostrados no formato YAML.

No YAML, o formato do arquivo é:

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

Cada elemento da `parameterValues` lista deve ser um dos seguintes:
+ Um parâmetro de trabalho definido no modelo de trabalho.
+ Um parâmetro de trabalho definido em um ambiente de fila para a fila para a qual você envia o trabalho.
+ Um parâmetro especial passado para a `CreateJob` operação ao criar um trabalho.
  + `deadline:priority`— O valor deve ser um número inteiro. Ele é passado para a `CreateJob` operação como parâmetro de [prioridade](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-priority).
  + `deadline:targetTaskRunStatus`— O valor deve ser uma string. Ele é passado para a `CreateJob` operação como o parâmetro [targetTaskRunStatus](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-targetTaskRunStatus).
  + `deadline:maxFailedTasksCount`— O valor deve ser um número inteiro. Ele é passado para a `CreateJob` operação como o parâmetro [maxFailedTasksCount](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-maxFailedTasksCount).
  + `deadline:maxRetriesPerTask`— O valor deve ser um número inteiro. Ele é passado para a `CreateJob` operação como o parâmetro [maxRetriesPerTask](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-maxRetriesPerTask).
  + `deadline:maxWorkercount`— O valor deve ser um número inteiro. Ele é passado para a `CreateJob` operação como [maxWorkerCount](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-maxRetriesPerTask)parâmetro.

Um modelo de trabalho é sempre um modelo em vez de um trabalho específico a ser executado. Um arquivo de valores de parâmetros permite que um pacote de tarefas atue como um modelo se alguns parâmetros não tiverem valores definidos nesse arquivo ou como um envio de trabalho específico se todos os parâmetros tiverem valores.

Por exemplo, a [amostra blender\_render](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles/blender_render) não tem um arquivo de parâmetros e seu modelo de trabalho define parâmetros sem valores padrão. Esse modelo deve ser usado como modelo para criar trabalhos. Depois de criar um trabalho usando esse pacote de trabalhos, o Deadline Cloud grava um novo pacote de trabalhos no diretório do histórico de trabalhos. 

Por exemplo, quando você envia um trabalho com o seguinte comando:

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

O novo pacote de tarefas contém um `parameter_values.yaml` arquivo que contém os 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
```

Você pode criar o mesmo trabalho com o seguinte comando:

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

**nota**  
O pacote de trabalhos que você envia é salvo no seu diretório de histórico de trabalhos. Você pode encontrar a localização desse diretório com o seguinte comando:  

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