Skip to main content

Box - Download Files to Shipyard

Overview​

Quickly export one or more files from your company's Box account. Once the files have downloaded, transfer them to another service or run another Vessel against the data.

Variables​

NameReferenceTypeRequiredDefaultOptionsDescription
Box Folder NameBOX_SOURCE_FOLDER_NAMEAlphanumericβž–--Name of the folder where the file is stored in Box. Leaving blank will look for the file in the root directory of Box.
Box File NameBOX_SOURCE_FILE_NAMEAlphanumericβœ…--Name of the target file in Box. Can be regex if "Match Type" is set accordingly.
Box File Name Match TypeBOX_SOURCE_FILE_NAME_MATCH_TYPESelectβœ…exact_matchExact Match: exact_match

Regex Match: regex_match

Determines if the text in "Box File Name" will look for one file with exact match, or multiple files using regex.
Shipyard Folder NameBOX_DESTINATION_FOLDER_NAMEAlphanumericβž–--Folder where the file(s) should be downloaded. Leaving blank will place the file in the home directory.
Shipyard File NameBOX_DESTINATION_FILE_NAMEAlphanumericβž–--What to name the file(s) being downloaded. If left blank, defaults to the original file name(s).
Service Account CredentialsBOX_APPLICATION_CREDENTIALSPasswordβœ…--JSON from a Box Service Account key

YAML​

Below is the YAML template for this Blueprint and can be used in the Fleet YAML Editor.

source:
blueprint: Box - Download Files to Shipyard
inputs:
BOX_SOURCE_FOLDER_NAME: null
BOX_SOURCE_FILE_NAME: null ## REQUIRED
BOX_SOURCE_FILE_NAME_MATCH_TYPE: exact_match ## REQUIRED
BOX_DESTINATION_FOLDER_NAME: null
BOX_DESTINATION_FILE_NAME: null
BOX_APPLICATION_CREDENTIALS: null ## REQUIRED
type: BLUEPRINT
guardrails:
retry_count: 1
retry_wait: 0h0m0s
runtime_cutoff: 1h0m0s
exclude_exit_code_ranges:
- '0'