本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 任務套件的參數值元素
<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
```