AmazonS3read()

Amazon S3: Reads the remote file sitting on S3 copying to the local file system or reading the file into memory and returning its content

Usage

STRING = AmazonS3read( datasource, bucket, key, file, overwrite, aes256key, retry, retrywaitseconds )
Argument Summary
datasource Amazon datasource
bucket Amazon bucket
key Full key
file Path to local file where this remote object will be saved. If not specified then the contents of the remote file is returned from this function [optional]
overwrite flag to control if the local file should be overwritten before downloading; defaults to true [optional]
aes256key optional AES256 key for Amazon to decrypt the file from rest, using the specified key, in Base64. If you write the file using encryption, then you have to supply the same key in the AmazonS3Write() function to write the file. To create a AES key use the OpenBD function: GenerateSecurityKey('aes',256) [optional]
retry number of times to retry before giving up; defaults to 1 [optional]
retrywaitseconds number of seconds to wait before retrying; defaults to 1 [optional]

Calling

Supports named-parameter calling allowing you to use the function like:

AmazonS3read(
   datasource=?, 
   bucket=?, 
   key=?, 
   file=?, 
   overwrite=?, 
   aes256key=?, 
   retry=?, 
   retrywaitseconds=?
);

Supports passing parameters as a structure using ArgumentCollection:

AmazonS3read( ArgumentCollection={
   datasource : ?, 
   bucket : ?, 
   key : ?, 
   file : ?, 
   overwrite : ?, 
   aes256key : ?, 
   retry : ?, 
   retrywaitseconds : ?
} );