EN-US
Ask or search…
K
Links

S3 Storage

Discover more about the S3 Storage component and how to use it on the Digibee Integration Platform.
S3 Storage connects itself with the AWS S3 Storage and makes the following operations in the storage: List, Download, Upload, Delete or Move.

Parameters

Take a look at the configuration options for the component. Parameters supported by Double Braces expressions are marked with (DB).
Parameter
Description
Default value
Data type
Account
Account to be used by the component. Mandatory. The account type must be Basic. It's necessary to specify the client ID and the secret key given by the AWS console.
N/A
String
Operation
Operation to be executed (List, Download, Upload, Delete, or Move).
Upload
String
Region
Region where the S3 is located.
South America (Sao Paulo)
String
Bucket Name
Name of the Bucket S3.
digibee-amazon-s3-connector-test
String
Bucket Name - Move
For the Move operation only. Name of the bucket from which the file will be moved.
N/A
String
File Name (DB)
File name or full file path (i.e. tmp/processed/file.txt) of the local file to go through Download or Upload. This parameter is not available for the Delete operation.
file.csv
String
Remote File Name (DB)
Remote file name or full file path (i.e. tmp/processed/file.txt) of the S3 Storage file to go through Download, Upload, List, or Delete.
test.csv
String
Remote File Name - Move (DB)
For the Move operation only. New name of the remote file after being moved.
N/A
String
Remote Directory
Remote directory from S3 Storage to go through Download, Upload, or Delete.
upload/
String
Remote Directory - Move
For the Move operation only. Name of the remote directory whose file will be moved.
N/A
String
Page Size
For the List operation only. The amount of items to be returned when the List operation is used.
If the value isn’t specified, all the items will be returned.
N/A
Integer
Next Page Token
For the List operation only. Sets the token used to request the next page when the List operation is used.
In this next page, the amount of items defined in the Page Size parameter is returned.
N/A
String
Generate Download Link
When selected, the option generates a public link for the file download.
True
Boolean
Expiration Timestamp (in ms)
Time for the link expiration (in milliseconds). In this field, you must provide the current timestamp + the expiration timestamp. That is, current timestamp + 600000 (600000 = 10 minutes are being informed in milliseconds).
If not informed, the default value of 15 minutes after the current timestamp will be assumed.
N/A
Integer
Fail On Error
If the option is enabled, the execution of the pipeline with error will be interrupted; otherwise, the pipeline execution proceeds, but the result will show a false value for the “success” property.
False
Boolean
Custom Endpoint
If the option is enabled, a custom endpoint URL for S3 storage can be used in the pipeline. Otherwise, the URL can't be added.
False
Boolean
Endpoint URL (DB)
The custom endpoint URL. This field supports Double Braces expressions.
N/A
String
The manipulation of files inside a pipeline occurs in a protected way. All the files can be accessed through one temporary directory only, in which each pipeline key provides access to its own set of files.

Messages flow

Input

It will be necessary to provide some input message only if the component has a field configured with Double Braces expressions. Otherwise, the component doesn't expect any specific input message. All you have to do is to configure the fields shown in each selected operation.

Output

List operation scenario

{
"success": true,
"content": [
{
"bucketName": "digibee-amazon-s3-connector-test",
"key": "list/test.csv",
"size": 9,
"lastModified": 1596139663000,
"storageClass": "STANDARD",
"owner": null,
"etag": "59587d0fd956dee6905d423bfda2acaf"
}
],
"count": 1,
"nextToken": "1kWwy…..."
}
  • success: if the call is successful, the result will be “true”; otherwise, it will be “false”.
  • content: array containing file information.
  • bucketName: name of the bucket.
  • key: name of the directory + name of the file.
  • size: size of the file.
  • lastModified: date of the last file change.
  • storageClass: type of storage configured in S3.
  • owner: nome of the file owner.
  • etag: entity tag, a hash generated by the file S3.
  • count: number of returned objects.
  • nextToken: if there's more than one object to be listed, this property is shown for the remaining items to be paginated.

Download operation scenario

{
"success": true,
"fileName": "test.file",
"remoteDirectory": "pagination_folder/",
"remoteFileName": "c4b88b6b-83bb-42b0-9de6-0371389db585.csv",
"bucketName": "digibee-amazon-s3-connector-test"
}
  • success: if the call is successful, the result will be “true”; otherwise, it will be “false”.
  • fileName: name of the file downloaded in the pipeline directory.
  • remoteDirectory: name of the S3 remote directory.
  • remoteFileName: name of the remote file downloaded in S3.
  • bucketName: name of the S3 bucket.

Upload operation scenario

{
"success": true,
"fileName": "test.file",
"remoteDirectory": "pagination_folder/",
"remoteFileName": "test.file",
"urlGenerated": "https://digibee-amazon-s3-connector-test.s3.sa-east-1.amazonaws.com/pagination_folder/test.file?....",
"bucketName": "digibee-amazon-s3-connector-test"
}
  • success: if the call is successful, the result will be “true”; otherwise, it will be “false”.
  • fileName: name of the file downloaded in the pipeline directory.
  • remoteDirectory: name of the S3 remote directory.
  • remoteFileName: name of the remote file downloaded in S3.
  • bucketName: name of the S3 bucket.
  • urlGenerated: download link of the file if the Generate Download Link option is enabled.

Move operation scenario

{
"success": true,
"remoteDirectory": "pagination_folder/",
"remoteFileName": "c4b88b6b-83bb-42b0-9de6-0371389db585.csv",
"remoteFileNameMove": "abc.file",
"remoteDirectoryMove": "list/",
"bucketName": "digibee-amazon-s3-connector-test",
"bucketNameMove": "digibee-amazon-s3-connector-test"
}
  • success: if the call is successful, the result will be “true”; otherwise, it will be “false”.
  • remoteDirectory: name of the S3 remote directory.
  • remoteFileName: name of the remote file downloaded in S3.
  • bucketName: name of the S3 bucket.
  • bucketNameMove: name of the bucket of the moved file.
  • remoteDirectoryMove: name of the remote directory of the moved file.
  • remoteFileNameMove: new name of the remote file to be moved.

Delete operation scenario

{
"success": true,
"remoteDirectory": "list/",
"remoteFileName": "abc.file",
"bucketName": "digibee-amazon-s3-connector-test"
}
  • success: if the call is successful, the result will be “true”; otherwise, it will be “false”.
  • remoteDirectory: name of the S3 remote directory.
  • remoteFileName: name of the remote file deleted from S3.

Output with error

{
"success": false,
"message": "Could no issue the operation: download in the AWS S3 Storage",
"error": "com.amazonaws.services.s3.model.AmazonS3Exception: The specified key does not exist. (Service: Amazon S3; Status Code: 404; Error Code: NoSuchKey; Request ID: A21B8733BB9771DE; S3 Extended Request ID: 1zAtWB8gOvJKGKUBXdkWj7er8K6Ik6wUgdIUO1w41TsNo0b51B3MXrT4F4lADL+xI0Ojvf0e6z4=), S3 Extended Request ID: 1zAtWB8gOvJKGKUBXdkWj7er8K6Ik6wUgdIUO1w41TsNo0b51B3MXrT4F4lADL+xI0Ojvf0e6z4="
}
  • success: “false”, because there was an error in the execution.
  • message: error message of the component.
  • error: error message received from the S3 server.
Last modified 2mo ago