

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Vorlagen für offene Stellenbeschreibungen (OpenJD) für Deadline Cloud
<a name="build-job-bundle"></a>

Ein *Job-Bundle* ist eines der Tools, mit denen Sie Jobs für AWS Deadline Cloud definieren. Sie gruppieren eine [OpenJD-Vorlage (Open Job Description)](https://github.com/OpenJobDescription/openjd-specifications) mit zusätzlichen Informationen wie Dateien und Verzeichnissen, die Ihre Jobs mit Stellenanhängen verwenden. Sie verwenden die Deadline Cloud-Befehlszeilenschnittstelle (CLI), um ein Job-Bundle zu verwenden, um Jobs für die Ausführung in einer Warteschlange einzureichen.

Ein Job-Bundle ist eine Verzeichnisstruktur, die eine OpenJD-Jobvorlage, andere Dateien, die den Job definieren, und jobspezifische Dateien enthält, die als Eingabe für Ihren Job benötigt werden. Sie können die Dateien, die Ihren Job definieren, entweder als YAML- oder JSON-Dateien angeben.

Die einzige erforderliche Datei ist entweder `template.yaml` oder`template.json`. Sie können auch die folgenden Dateien einschließen:

```
/template.yaml (or template.json)
/asset_references.yaml (or asset_references.json)
/parameter_values.yaml (or parameter_values.json)
/other job-specific files and directories
```

Verwenden Sie ein Job-Bundle für benutzerdefinierte Job-Übermittlungen mit der Deadline Cloud-CLI und einem Jobanhang, oder Sie können eine grafische Einreichungsoberfläche verwenden. Im Folgenden finden Sie beispielsweise das Blender-Beispiel von GitHub. Um das Beispiel mit dem folgenden Befehl [im Blender-Beispielverzeichnis](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles) auszuführen:

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

![\[Ein Beispiel für eine benutzerdefinierte Schnittstelle zur Einreichung von Jobs für Blender.\]](http://docs.aws.amazon.com/de_de/deadline-cloud/latest/developerguide/images/blender_submit_shared_settings.png)


Das Fenster mit den auftragsspezifischen Einstellungen wird aus den `userInterface` Eigenschaften der Jobparameter generiert, die in der Jobvorlage definiert sind.

Um einen Job über die Befehlszeile einzureichen, können Sie einen Befehl verwenden, der dem folgenden ähnelt

```
deadline bundle submit \
    --yes \
    --name Demo \
     -p BlenderSceneFile=location of scene file \
     -p OutputDir=file pathe for job output \
      blender_render/
```

Oder Sie können die `deadline.client.api.create_job_from_job_bundle` Funktion im `deadline` Python-Paket verwenden.

Alle in Deadline Cloud enthaltenen Plug-ins für Job-Einreicher, wie das Autodesk Maya-Plugin, generieren ein Job-Bundle für Ihre Einreichung und verwenden dann das Deadline Cloud-Python-Paket, um Ihren Job bei Deadline Cloud einzureichen. Sie können die eingereichten Job-Bundles im Job-Verlaufsverzeichnis Ihrer Workstation oder mithilfe eines Absenders einsehen. Sie können Ihr Job-Verlaufsverzeichnis mit dem folgenden Befehl finden:

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

Wenn Ihr Job auf einem Deadline Cloud-Worker ausgeführt wird, hat er Zugriff auf Umgebungsvariablen, die ihm Informationen über den Job liefern. Die Umgebungsvariablen sind:


| Variablenname | Available (Verfügbar) | 
| --- | --- | 
| DEADLINE\$1FARM\$1ID | Alle Aktionen | 
| DEADLINE\$1FLOTTENNUMMER | Alle Aktionen | 
| DEADLINE\$1WORKER-ID | Alle Aktionen | 
| DEADLINE\$1WARTESCHLANGEN-ID | Alle Aktionen | 
| DEADLINE\$1JOB-ID | Alle Aktionen | 
| DEADLINE\$1STEP-ID | Aktionen der Aufgabe | 
| DEADLINE\$1SESSION\$1ID | Alle Aktionen | 
| DEADLINE\$1TASK\$1ID | Aktionen der Aufgabe | 
| DEADLINE\$1SESSIONACTION\$1ID | Alle Aktionen | 

**Topics**
+ [Jobvorlagenelemente für Jobpakete](build-job-bundle-template.md)
+ [Aufgabenteilung für Jobvorlagen](build-job-bundle-chunking.md)
+ [Parameterwerte, Elemente für Job-Bundles](build-job-bundle-parameters.md)
+ [Asset-Referenzen, Elemente für Job-Bundles](build-job-bundle-assets.md)

# Jobvorlagenelemente für Jobpakete
<a name="build-job-bundle-template"></a>

Die Jobvorlage definiert die Laufzeitumgebung und die Prozesse, die als Teil eines Deadline Cloud-Jobs ausgeführt werden. Sie können Parameter in einer Vorlage erstellen, sodass sie verwendet werden kann, um Jobs zu erstellen, die sich nur in den Eingabewerten unterscheiden, ähnlich wie bei einer Funktion in einer Programmiersprache.

Wenn Sie einen Job an Deadline Cloud senden, wird er in allen Warteschlangenumgebungen ausgeführt, die auf die Warteschlange angewendet wurden. Warteschlangenumgebungen werden mithilfe der Spezifikation für externe Umgebungen von Open Job Description (OpenJD) erstellt. Einzelheiten finden Sie in der [Environment-Vorlage](https://github.com/OpenJobDescription/openjd-specifications/wiki/2023-09-Template-Schemas#12-environment-template) im OpenJD-Repository GitHub .

Eine Einführung in die Erstellung eines Jobs mit einer OpenJD-Jobvorlage finden Sie unter [Einführung in die Erstellung eines Jobs](https://github.com/OpenJobDescription/openjd-specifications/wiki/Introduction-to-Creating-a-Job) im GitHub OpenJD-Repository. Zusätzliche Informationen finden Sie unter [Wie Jobs ausgeführt werden](https://github.com/OpenJobDescription/openjd-specifications/wiki/How-Jobs-Are-Run). Es gibt Beispiele für Jobvorlagen im `samples` Verzeichnis des GitHub OpenJD-Repositorys.

Sie können die Jobvorlage entweder im YAML-Format (`template.yaml`) oder im JSON-Format (`template.json`) definieren. Die Beispiele in diesem Abschnitt werden im YAML-Format angezeigt.

Die Jobvorlage für das `blender_render` Beispiel definiert beispielsweise einen Eingabeparameter `BlenderSceneFile` als Dateipfad:

```
- name: BlenderSceneFile
  type: PATH
  objectType: FILE
  dataFlow: IN
  userInterface:
    control: CHOOSE_INPUT_FILE
    label: Blender Scene File
    groupLabel: Render Parameters
    fileFilters:
    - label: Blender Scene Files
      patterns: ["*.blend"]
    - label: All Files
      patterns: ["*"]
  description: >
    Choose the Blender scene file to render. Use the 'Job Attachments' tab
    to add textures and other files that the job needs.
```

Die `userInterface` Eigenschaft definiert das Verhalten automatisch generierter Benutzeroberflächen sowohl in der Befehlszeile, die den Befehl verwendet, als auch in den Plug-ins für die Auftragsübermittlung für Anwendungen wie Autodesk Maya. `deadline bundle gui-submit`

In diesem Beispiel ist das UI-Widget zur Eingabe eines Werts für den `BlenderSceneFile` Parameter ein Dialogfeld zur Dateiauswahl, in dem nur Dateien angezeigt werden. `.blend`

![\[Ein Benutzeroberflächen-Widget zur Eingabe des Szenendateiparameters für eine OpenJD-Jobvorlage.\]](http://docs.aws.amazon.com/de_de/deadline-cloud/latest/developerguide/images/blender_submit_scene_file_widget.png)


Weitere Beispiele für die Verwendung des `userInteface` Elements finden Sie im Beispiel [gui\$1control\$1showcase](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles/gui_control_showcase) im Repository unter. [deadline-cloud-samples](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline) GitHub

Die `dataFlow` Eigenschaften `objectType` und steuern das Verhalten von Job-Anhängen, wenn Sie einen Job aus einem Job-Bundle einreichen. In diesem Fall `dataFlow:IN` bedeuten `objectType: FILE` und, dass der Wert von eine Eingabedatei für Jobanhänge `BlenderSceneFile` ist.

Im Gegensatz dazu hat die Definition des `OutputDir` Parameters `objectType: DIRECTORY` und`dataFlow: OUT`:

```
- name: OutputDir
  type: PATH
  objectType: DIRECTORY
  dataFlow: OUT
  userInterface:
    control: CHOOSE_DIRECTORY
    label: Output Directory
    groupLabel: Render Parameters
  default: "./output"
  description: Choose the render output directory.
```

Der Wert des `OutputDir` Parameters wird von Job-Anhängen als Verzeichnis verwendet, in das der Job Ausgabedateien schreibt.

Weitere Informationen zu den `dataFlow` Eigenschaften `objectType` und finden Sie [JobPathParameterDefinition](https://github.com/OpenJobDescription/openjd-specifications/wiki/2023-09-Template-Schemas#22-jobpathparameterdefinition)in der [Spezifikation Open Job Description](https://github.com/OpenJobDescription/openjd-specifications)

Der Rest des Beispiels für eine `blender_render` Jobvorlage definiert den Arbeitsablauf des Jobs als einen einzelnen Schritt, wobei jedes Bild in der Animation als separate Aufgabe gerendert wird:

```
steps:
- name: RenderBlender
  parameterSpace:
    taskParameterDefinitions:
    - name: Frame
      type: INT
      range: "{{Param.Frames}}"
  script:
    actions:
      onRun:
        command: bash
        # Note: {{Task.File.Run}} is a variable that expands to the filename on the worker host's
        # disk where the contents of the 'Run' embedded file, below, is written.
        args: ['{{Task.File.Run}}']
    embeddedFiles:
      - name: Run
        type: TEXT
        data: |
          # Configure the task to fail if any individual command fails.
          set -xeuo pipefail

          mkdir -p '{{Param.OutputDir}}'

          blender --background '{{Param.BlenderSceneFile}}' \
                  --render-output '{{Param.OutputDir}}/{{Param.OutputPattern}}' \
                  --render-format {{Param.Format}} \
                  --use-extension 1 \
                  --render-frame {{Task.Param.Frame}}
```

Wenn der Wert des `Frames` Parameters beispielsweise lautet`1-10`, definiert er 10 Aufgaben. Jede Aufgabe hat einen anderen Wert für den `Frame` Parameter. Um eine Aufgabe auszuführen:

1. Alle Variablenverweise in der `data` Eigenschaft der eingebetteten Datei sind beispielsweise erweitert`--render-frame 1`.

1. Der Inhalt der `data` Eigenschaft wird in eine Datei im Arbeitsverzeichnis der Sitzung auf der Festplatte geschrieben.

1. Der `onRun` Befehl der Aufgabe wird in aufgelöst `bash location of embedded file` und dann ausgeführt.

Weitere Informationen zu eingebetteten Dateien, Sitzungen und Pfadzuordnungen finden Sie unter [So werden Jobs ausgeführt](https://github.com/OpenJobDescription/openjd-specifications/wiki/How-Jobs-Are-Run) in der [Open Job](https://github.com/OpenJobDescription/openjd-specifications/wiki/How-Jobs-Are-Run) Description-Spezifikation.

Es gibt weitere Beispiele für Jobvorlagen im Repository [deadline-cloud-samples/job\$1bundles](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles) sowie die [Vorlagenbeispiele, die in der Open Job Description-Spezifikation](https://github.com/OpenJobDescription/openjd-specifications/tree/mainline/samples) enthalten sind.

# Aufgabenteilung für Jobvorlagen
<a name="build-job-bundle-chunking"></a>

Durch Aufgaben-Chunking können Sie mehrere Aufgaben zu einer einzigen Arbeitseinheit zusammenfassen, die als Chunk bezeichnet wird. In einem Renderjob bedeutet dies beispielsweise, dass Deadline Cloud mehrere Frames zusammen versenden kann, anstatt einen Frame pro Befehlsaufruf. Dies reduziert den Aufwand beim Starten von Anwendungen für jede Aufgabe und verkürzt die Gesamtlaufzeit des Jobs. Einzelheiten finden Sie unter [Mehrere Frames gleichzeitig ausführen](https://github.com/OpenJobDescription/openjd-specifications/wiki/Job-Intro-03-Creating-a-Job-Template#42-running-multiple-frames-at-a-time) im OpenJD-Wiki.

OpenJD unterstützt Erweiterungen, die Jobvorlagen um optionale Funktionen erweitern. Das Aufteilen von Aufgaben wird durch Hinzufügen der Erweiterung aktiviert. `TASK_CHUNKING` Um Chunking zu verwenden, fügen Sie die Erweiterung zu Ihrer Jobvorlage hinzu und verwenden Sie den `CHUNK[INT]` Task-Parametertyp. Senden Sie Jobs in Einzelteilen mit demselben Befehl. `deadline bundle submit` Die folgende Jobvorlage rendert beispielsweise Frames in Blöcken von 10:

```
specificationVersion: 'jobtemplate-2023-09'
extensions:
  - TASK_CHUNKING
name: Blender Render with Contiguous Chunking
parameterDefinitions:
  - name: BlenderSceneFile
    type: PATH
    objectType: FILE
    dataFlow: IN
  - name: Frames
    type: STRING
    default: "1-100"
  - name: OutputDir
    type: PATH
    objectType: DIRECTORY
    dataFlow: OUT
    default: "./output"
steps:
  - name: RenderBlender
    parameterSpace:
      taskParameterDefinitions:
        - name: Frame
          type: CHUNK[INT]
          range: "{{Param.Frames}}"
          chunks:
            defaultTaskCount: 10
            rangeConstraint: CONTIGUOUS
    script:
      actions:
        onRun:
          command: bash
          args: ["{{Task.File.Run}}"]
      embeddedFiles:
        - name: Run
          type: TEXT
          data: |
            set -xeuo pipefail
            
            mkdir -p '{{Param.OutputDir}}'
            
            # Parse the chunk range (e.g., "1-10") into start and end frames
            START_FRAME="$(echo '{{Task.Param.Frame}}' | cut -d- -f1)"
            END_FRAME="$(echo '{{Task.Param.Frame}}' | cut -d- -f2)"
            
            blender --background '{{Param.BlenderSceneFile}}' \
                    --render-output '{{Param.OutputDir}}/output_####' \
                    --render-format PNG \
                    --use-extension 1 \
                    -s "$START_FRAME" \
                    -e "$END_FRAME" \
                    --render-anim
```

In diesem Beispiel unterteilt Deadline Cloud die 100 Frames in Blöcke wie`1-10`, usw. `11-20` Die `{{Task.Param.Frame}}` Variable wird zu einem Bereichsausdruck wie erweitert. `1-10` Da auf gesetzt `rangeConstraint` ist`CONTIGUOUS`, ist der Bereich immer `start-end` formatiert. Das Skript analysiert diesen Bereich und übergibt die Start- und Endframes mithilfe der `-e` Optionen `-s` und mit `--render-anim` an Blender.

Die `chunks` Eigenschaft unterstützt die folgenden Felder:
+ `defaultTaskCount`— (Erforderlich) Wie viele Aufgaben zu einem einzigen Block zusammengefasst werden sollen. Der Höchstwert ist 150.
+ `rangeConstraint`— (Erforderlich) Wenn`CONTIGUOUS`, ist ein Chunk immer ein zusammenhängender Bereich wie. `1-10` Wenn`NONCONTIGUOUS`, kann ein Chunk eine beliebige Menge sein wie. `1,3,7-10`
+ `targetRuntimeSeconds`— (Optional) Die Ziellaufzeit in Sekunden für jeden Chunk. Deadline Cloud kann die Chunk-Größe dynamisch anpassen, um sich diesem Ziel zu nähern, sobald einige Chunks abgeschlossen sind.

[Weitere Beispiele für das Chunking von Aufgaben, darunter einfache Beispiele und Blender-Beispiele mit zusammenhängenden und nicht zusammenhängenden Chunks, finden Sie in den Beispielen zum Aufgaben-Chunking im Deadline Cloud-Beispiel-Repository unter.](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles/task_chunking) GitHub

**Vom Kunden verwaltete Flottenanforderungen**  
Für das Aufteilen von Aufgaben ist eine kompatible Worker-Agent-Version erforderlich. Wenn Sie vom Kunden verwaltete Flotten verwenden, stellen Sie sicher, dass Ihre Worker Agents auf dem neuesten Stand sind, bevor Sie Jobs mit Chunking weiterleiten. Vom Service verwaltete Flotten verwenden immer eine kompatible Worker-Agent-Version.

**Die Ausgabe für Einzelaufträge wird heruntergeladen**  
Wenn Sie die Ausgabe für eine einzelne Aufgabe in einem aufgeteilten Job herunterladen, lädt Deadline Cloud die Ausgabe für den gesamten Block herunter. Wenn beispielsweise die Frames 1—10 zusammen verarbeitet wurden, umfasst das Herunterladen der Ausgabe für Frame 3 alle Frames 1—10. Für diese Funktion ist `deadline-cloud` Version 0.53.3 oder höher erforderlich.

# Parameterwerte, Elemente für Job-Bundles
<a name="build-job-bundle-parameters"></a>

Sie können die Parameterdatei verwenden, um die Werte einiger Jobparameter in der Jobvorlage oder der [CreateJob](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html)Operationsanforderungsargumente im Job-Bundle festzulegen, sodass Sie beim Senden eines Jobs keine Werte festlegen müssen. Die Benutzeroberfläche für die Auftragsübermittlung ermöglicht es Ihnen, diese Werte zu ändern.

Sie können die Jobvorlage entweder im YAML-Format (`parameter_values.yaml`) oder im JSON-Format (`parameter_values.json`) definieren. Die Beispiele in diesem Abschnitt werden im YAML-Format angezeigt.

In YAML ist das Format der Datei:

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

Jedes Element der `parameterValues` Liste muss eines der folgenden sein:
+ Ein in der Jobvorlage definierter Jobparameter.
+ Ein in einer Warteschlangenumgebung definierter Jobparameter für die Warteschlange, an die Sie den Job senden.
+ Ein spezieller Parameter, der beim Erstellen eines Jobs an den `CreateJob` Vorgang übergeben wird.
  + `deadline:priority`— Der Wert muss eine Ganzzahl sein. Er wird als [Prioritätsparameter](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-priority) an die `CreateJob` Operation übergeben.
  + `deadline:targetTaskRunStatus`— Der Wert muss eine Zeichenfolge sein. Er wird als [targetTaskRunStatus-Parameter](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-targetTaskRunStatus) an die `CreateJob` Operation übergeben.
  + `deadline:maxFailedTasksCount`— Der Wert muss eine Ganzzahl sein. Er wird als [maxFailedTasksCount-Parameter](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-maxFailedTasksCount) an die `CreateJob` Operation übergeben.
  + `deadline:maxRetriesPerTask`— Der Wert muss eine Ganzzahl sein. Er wird als [maxRetriesPerTask-Parameter](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-maxRetriesPerTask) an die `CreateJob` Operation übergeben.
  + `deadline:maxWorkercount`— Der Wert muss eine Ganzzahl sein. Er wird als [maxWorkerCount](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_CreateJob.html#deadlinecloud-CreateJob-request-maxRetriesPerTask)Parameter an die `CreateJob` Operation übergeben.

Bei einer Auftragsvorlage handelt es sich immer um eine Vorlage und nicht um einen bestimmten auszuführenden Job. Eine Datei mit Parameterwerten ermöglicht es einem Job-Bundle, entweder als Vorlage zu dienen, wenn für einige Parameter in dieser Datei keine Werte definiert sind, oder als spezifische Jobübermittlung, wenn alle Parameter Werte haben.

Das Beispiel [blender\$1render](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles/blender_render) hat beispielsweise keine Parameterdatei und die zugehörige Jobvorlage definiert Parameter ohne Standardwerte. Diese Vorlage muss als Vorlage für die Erstellung von Jobs verwendet werden. Nachdem Sie mit diesem Job-Bundle einen Job erstellt haben, schreibt Deadline Cloud ein neues Job-Bundle in das Job-Verlaufsverzeichnis. 

Zum Beispiel, wenn Sie einen Job mit dem folgenden Befehl einreichen:

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

Das neue Job-Bundle enthält eine `parameter_values.yaml` Datei, die die angegebenen Parameter enthält:

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

Sie können denselben Job mit dem folgenden Befehl erstellen:

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

**Anmerkung**  
Das von Ihnen eingereichte Job-Bundle wird in Ihrem Job-Verlaufsverzeichnis gespeichert. Sie können den Speicherort dieses Verzeichnisses mit dem folgenden Befehl ermitteln:  

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

# Asset-Referenzen, Elemente für Job-Bundles
<a name="build-job-bundle-assets"></a>

Sie können Deadline [Cloud-Jobanhänge](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/storage-job-attachments.html) verwenden, um Dateien zwischen Ihrer Workstation und Deadline Cloud hin und her zu übertragen. Die Asset-Referenzdatei listet Eingabedateien und -verzeichnisse sowie Ausgabeverzeichnisse für Ihre Anhänge auf. Wenn Sie nicht alle Dateien und Verzeichnisse in dieser Datei auflisten, können Sie sie auswählen, wenn Sie einen Job mit dem `deadline bundle gui-submit` Befehl einreichen.

Diese Datei hat keine Auswirkung, wenn Sie keine Jobanhänge verwenden.

Sie können die Jobvorlage entweder im YAML-Format (`asset_references.yaml`) oder im JSON-Format (`asset_references.json`) definieren. Die Beispiele in diesem Abschnitt werden im YAML-Format angezeigt.

In YAML ist das Format der Datei:

```
assetReferences:
    inputs:
        # Filenames on the submitting workstation whose file contents are needed as 
        # inputs to run the job.
        filenames:
        - list of file paths
        # Directories on the submitting workstation whose contents are needed as inputs
        # to run the job.
        directories:
        - list of directory paths

    outputs:
        # Directories on the submitting workstation where the job writes output files
        # if running locally.
        directories:
        - list of directory paths

    # Paths referenced by the job, but not necessarily input or output.
    # Use this if your job uses the name of a path in some way, but does not explicitly need
    # the contents of that path.
    referencedPaths:
    - list of directory paths
```

Bei der Auswahl der Eingabe- oder Ausgabedatei, die auf Amazon S3 hochgeladen werden soll, vergleicht Deadline Cloud den Dateipfad mit den Pfaden, die in Ihren Speicherprofilen aufgeführt sind. Jeder Dateisystemspeicherort `SHARED` vom Typ -type in einem Speicherprofil abstrahiert eine Netzwerk-Dateifreigabe, die auf Ihren Workstations und Worker-Hosts bereitgestellt wird. Deadline Cloud lädt nur Dateien hoch, die sich nicht auf einer dieser Dateifreigaben befinden.

Weitere Informationen zum Erstellen und Verwenden von Speicherprofilen finden Sie unter [Gemeinsamer Speicher in Deadline Cloud](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/storage-shared.html) im *AWS Deadline Cloud-Benutzerhandbuch*.

**Example - Die von der Deadline Cloud-GUI erstellte Asset-Referenzdatei**  
Verwenden Sie den folgenden Befehl, um einen Job mithilfe des Beispiels [blender\$1render](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles/blender_render) einzureichen.  

```
deadline bundle gui-submit blender_render/
```
Fügen Sie dem Job auf der Registerkarte **Jobanhänge** einige zusätzliche Dateien hinzu:  

![\[Der Bereich mit den Stellenanhängen in der Benutzeroberfläche für die Einreichung von Jobs in Deadline Cloud. Fügen Sie die Eingabedatei/hinzuprivate/tmp/bundle_demo/a_texture.png and the input directory /private/tmp/bundle_demo/assets.\]](http://docs.aws.amazon.com/de_de/deadline-cloud/latest/developerguide/images/blender_submit_add_job_attachments.png)

Nachdem Sie den Job eingereicht haben, können Sie sich die `asset_references.yaml` Datei im Job-Bundle im Job-Verlaufsverzeichnis ansehen, um die Assets in der YAML-Datei zu sehen:  

```
% cat ~/.deadline/job_history/\(default\)/2024-06/2024-06-20-01-JobBundle-Demo/asset_references.yaml 
assetReferences:
  inputs:
    filenames:
    - /private/tmp/bundle_demo/a_texture.png
    directories:
    - /private/tmp/bundle_demo/assets
  outputs:
    directories: []
  referencedPaths: []
```