AWS Security ChangesHomeSearch

AWS deadline-cloud: Describe how job bundles define job attachments

Service: deadline-cloud · 2026-09-30 · Documentation low

File: deadline-cloud/latest/developerguide/submitting-files-with-a-job.md

Summary

Replaces the general job-attachments overview with a structured explanation of the two places a job bundle defines attachments: PATH job parameters (dataFlow IN/OUT/INOUT and objectType FILE/DIRECTORY) and the asset references file, plus a note on submitter plugins auto-detecting scene-referenced files and an image of the Job attachments tab.

Security assessment

The changed lines document job attachment data flow (input/output file and directory parameters and asset reference files) for build/render workflows. This is functional data-flow documentation, not security guidance; it does not address authentication, encryption, secrets, or any fixed vulnerability.

Evidence

+  * **`PATH` job parameters** in the job template. A parameter's `dataFlow` property marks its value as an input (`IN`), an output (`OUT`), or both (`INOUT`). Its `objectType` property says whether the value is a `FILE` or a `DIRECTORY`. For more information, see [JobPathParameterDefinition](https://github.com/OpenJobDescription/openjd-specifications/wiki/2023-09-Template-Schemas#22-jobpathparameterdefinition) in the [Open Job Description specification](https://github.com/OpenJobDescription/openjd-specifications) on the GitHub website.

Diff

diff --git a/deadline-cloud/latest/developerguide/submitting-files-with-a-job.md b/deadline-cloud/latest/developerguide/submitting-files-with-a-job.md
index 3e3dd0b..eea2918 100644
--- a//deadline-cloud/latest/developerguide/submitting-files-with-a-job.md
+++ b//deadline-cloud/latest/developerguide/submitting-files-with-a-job.md
@@ -9 +9 @@
-With Deadline Cloud, you can enable job workflows to access input files that are unavailable in shared file system locations on worker hosts. Job attachments allow rendering jobs to access files residing only on a local workstation drive or a service-managed fleet environment. When submitting a job bundle, you can include lists of input files and directories required by the job. Deadline Cloud identifies these non-shared files, uploads them from the local machine to Amazon S3, and downloads them to the worker host. It streamlines the process of transferring input assets to render nodes, ensuring all required files are accessible for distributed job execution.
+A job bundle defines its job attachments in two places:
@@ -11 +11 @@ With Deadline Cloud, you can enable job workflows to access input files that are
-You can specify the files for jobs directly in the job bundle, use parameters in the job template that you provide using environment variables or a script, and use the job's `assets_references` file. You can use one of these methods or a combination of all three. You can specify a storage profile for the bundle for the job so that it only uploads files that have changed on the local workstation.
+  * **`PATH` job parameters** in the job template. A parameter's `dataFlow` property marks its value as an input (`IN`), an output (`OUT`), or both (`INOUT`). Its `objectType` property says whether the value is a `FILE` or a `DIRECTORY`. For more information, see [JobPathParameterDefinition](https://github.com/OpenJobDescription/openjd-specifications/wiki/2023-09-Template-Schemas#22-jobpathparameterdefinition) in the [Open Job Description specification](https://github.com/OpenJobDescription/openjd-specifications) on the GitHub website.
@@ -13 +13,12 @@ You can specify the files for jobs directly in the job bundle, use parameters in
-This section uses an example job bundle from GitHub to demonstrate how Deadline Cloud identifies the files in your job to upload, how those files are organized in Amazon S3, and how they are made available to the worker hosts processing your jobs. 
+  * **The asset references file** (`asset_references.yaml` or `asset_references.json`), which lists input files, input directories, and output directories. For more information, see [Asset references elements for job bundles](./build-job-bundle-assets.html).
+
+
+
+
+The Deadline Cloud [integrated submitter plugins](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/jobs-using-submitter.html) automatically find the files that your scene references. The plugins list these files on the submitter's **Job attachments** tab, where you can add any files or directories that the submitter didn't find. To open the same tab for a job bundle of your own, use the `deadline bundle gui-submit` command.
+
+The following image shows the **Job attachments** tab. It lists the input files, input directories, and output directory that the submitter detected automatically.
+
+![The Job attachments tab of a submitter, listing automatically detected input files, input directories, and an output directory.](/images/deadline-cloud/latest/developerguide/images/bundle-gui-submit-job-attachments.png)
+
+The following topics show how job attachments handles these files, using the [job_attachments_devguide job bundle](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles/job_attachments_devguide) on the GitHub website.