기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 작업 번들의 파라미터 값 요소
<a name="build-job-bundle-parameters"></a>

작업 제출 시 값을 설정할 필요가 없도록 파라미터 파일을 사용하여 작업 템플릿의 일부 작업 파라미터 또는 작업 번들의 [CreateJob](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html) 작업 요청 인수의 값을 설정할 수 있습니다. 작업 제출을 위한 UI를 사용하면 이러한 값을 수정할 수 있습니다.

작업 템플릿을 YAML 형식(`parameter_values.yaml`) 또는 JSON 형식()으로 정의할 수 있습니다`parameter_values.json`. 이 섹션의 예제는 YAML 형식으로 표시됩니다.

YAML에서 파일의 형식은 다음과 같습니다.

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

`parameterValues` 목록의 각 요소는 다음 중 하나여야 합니다.
+ 작업 템플릿에 정의된 작업 파라미터입니다.
+ 작업을 제출하는 대기열의 대기열 환경에 정의된 작업 파라미터입니다.
+ 작업을 생성할 때 `CreateJob` 작업에 전달되는 특수 파라미터입니다.
  + `deadline:priority` - 값은 정수여야 합니다. 우선 [순위](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-priority) 파라미터로 `CreateJob` 작업에 전달됩니다.
  + `deadline:targetTaskRunStatus` - 값은 문자열이어야 합니다. 작업에 [targetTaskRunStatus](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-targetTaskRunStatus) 파라미터`CreateJob`로 전달됩니다.
  + `deadline:maxFailedTasksCount` - 값은 정수여야 합니다. [maxFailedTasksCount](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-maxFailedTasksCount) 파라미터로 `CreateJob` 작업에 전달됩니다.
  + `deadline:maxRetriesPerTask` - 값은 정수여야 합니다. [maxRetriesPerTask](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-maxRetriesPerTask) 파라미터로 `CreateJob` 작업에 전달됩니다.
  + `deadline:maxWorkercount` - 값은 정수여야 합니다. [maxWorkerCount](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-maxRetriesPerTask) 파라미터로 `CreateJob` 작업에 전달됩니다.

작업 템플릿은 실행할 특정 작업이 아닌 항상 템플릿입니다. 파라미터 값 파일을 사용하면 일부 파라미터에이 파일에 정의된 값이 없는 경우 작업 번들이 템플릿 역할을 하거나 모든 파라미터에 값이 있는 경우 특정 작업 제출 역할을 할 수 있습니다.

예를 들어 [blender\_render 샘플](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles/blender_render)에는 파라미터 파일이 없으며 해당 작업 템플릿은 기본값이 없는 파라미터를 정의합니다. 이 템플릿은 작업을 생성하기 위한 템플릿으로 사용해야 합니다. 이 작업 번들을 사용하여 작업을 생성한 후 Deadline Cloud는 작업 기록 디렉터리에 새 작업 번들을 작성합니다.

예를 들어 다음 명령을 사용하여 작업을 제출하는 경우:

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

새 작업 번들에는 지정된 파라미터가 포함된 `parameter_values.yaml` 파일이 포함되어 있습니다.

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

다음 명령을 사용하여 동일한 작업을 생성할 수 있습니다.

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

**참고**  
제출하는 작업 번들은 작업 기록 디렉터리에 저장됩니다. 다음 명령을 사용하여 해당 디렉터리의 위치를 찾을 수 있습니다.  

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