Overview
Easily import one or more files directly into an Amazon S3 bucket, no matter how big they are.
Note: This Vessel cannot be used to upload a local file from your computer.
Recommended Setup:
-
A Vessel built with this Blueprint should typically run after a Vessel that either downloads a file to Workflows or generates a file with code.
Variables
|
Name |
Reference |
Type |
Required |
Default |
Options |
Description |
|---|---|---|---|---|---|---|
|
Bucket Name |
S3_BUCKET_NAME |
Alphanumeric |
✅ |
None |
- |
Name of the S3 bucket to upload the file(s) to. |
|
Workflows Folder Name |
S3_SOURCE_FOLDER_NAME |
Alphanumeric |
➖ |
None |
- |
Name of the local folder on Workflows to upload the target file from. If left blank, will look in the home directory. |
|
Workflows File Name Match Type |
S3_SOURCE_FILE_NAME_MATCH_TYPE |
Select |
✅ |
exact_match |
Exact Match: exact_match
|
Determines if the text in "Workflows File Name" will look for one file with exact match, or multiple files using regex. |
|
Workflows File Name |
S3_SOURCE_FILE_NAME |
Alphanumeric |
✅ |
None |
- |
Name of the target file on Workflows. Can be regex if "Match Type" is set accordingly |
|
S3 Folder Name |
S3_DESTINATION_FOLDER_NAME |
Alphanumeric |
➖ |
None |
- |
Folder in the S3 bucket to upload the file(s) to. If left blank, will upload to the root directory. |
|
S3 File Name |
S3_DESTINATION_FILE_NAME |
Alphanumeric |
➖ |
None |
- |
What to name the file(s) being uploaded. If left blank, defaults to the original file name(s). |
|
Access Key ID |
AWS_ACCESS_KEY_ID |
Password |
✅ |
None |
- |
The access key ID for programmatic IAM user used to download the file. See Authorization documentation for more information. |
|
Secret Access Key |
AWS_SECRET_ACCESS_KEY |
Password |
✅ |
None |
- |
The secret access key for programmatic IAM user used to download the file. See Authorization documentation for more information. |
|
Region |
AWS_DEFAULT_REGION |
Select |
✅ |
us-east-2 |
us-east-2
|
The AWS region for the S3 bucket and IAM user. |
|
Extra Variables |
S3_EXTRA_ARGS |
Alphanumeric |
➖ |
{} |
- |
Extra arguments that may be passed to the S3 operation. |
YAML
Below is the YAML template
source:
template: Amazon S3 - Upload Files from Workflows
inputs:
S3_BUCKET_NAME:
S3_SOURCE_FOLDER_NAME:
S3_SOURCE_FILE_NAME_MATCH_TYPE: exact_match
S3_SOURCE_FILE_NAME:
S3_DESTINATION_FOLDER_NAME:
S3_DESTINATION_FILE_NAME:
AWS_ACCESS_KEY_ID:
AWS_SECRET_ACCESS_KEY:
AWS_DEFAULT_REGION: us-east-2
S3_EXTRA_ARGS: '{}'
type: TEMPLATE
guardrails:
retry_count: 1
retry_wait: 0h0m0s
runtime_cutoff: 1h0m0s
exclude_exit_code_ranges:
- 10
- 14
- 101
- 102
- 204
- 205
- 206