翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ジョブバンドルのパラメータ値要素
<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
```