IT and Development

AWS S3

9min
the make aws s3 modules let you perform operations on your s3 buckets you'll need an aws s3 account for this feature connect aws to make to connect aws s3 to make you must connect your aws account to make to do so, you'll first need to create an api user in aws iam go to identity and access management > access management > users click the add user button to add a new user enter the name of the new user and select the programmatic access option in the access type section add the amazons3fullaccess permission policy to the user using attach existing policies directly and click next go through the other dialog screens and click the create user button find the provided access key id and secret access key go to make and open the aws s3 module's create a connection dialog enter the access key id and secret access key from step 5 to the respective fields and click the continue button to establish the connection the connection has been established you can proceed with setting up the module actions create bucket field description connection establish a connection to your aws s3 account name enter the name of the new bucket region select your regional endpoint get file downloads a file from a bucket field description connection establish a connection to your aws s3 account region select the regional endpoint bucket select the bucket you want to download the file from path enter the path to the file, e g /photos/2019/february/image023 jpg upload file field description connection establish a connection to your aws s3 account region select your regional endpoint folder (optional) specify the target folder, e g work/make source file provide the source file you want to upload to the bucket headers (optional) insert request headers available headers can be found in the aws s3 documentation put object make an api call for a detailed api description please refer to the amazon s3 api reference field description connection establish a connection to your aws s3 account region select your regional endpoint url enter a host url the path must be relative to https //s3 \<selected region> amazonaws com/ method select one of the http methods you want to use in your api call headers add a request header you can use the following common request headers for more request headers refer to aws s3 api documentation you don't have to add authorization headers; make already did that for you content length length of the message (without the headers) according to rfc 2616 this header is required for puts and operations that load xml, such as logging and acls content type the content type of the resource, in case the request content is in the body example text/plain content md5 the base64 encoded 128 bit md5 digest of the message (without the headers) according to rfc 1864 this header can be used as a message integrity check to verify that the data is the same data that was originally sent although it is optional, we recommend using the content md5 mechanism as an end to end integrity check for more information about rest request authentication, go to rest authentication in the amazon simple storage service developer guide date the current date and time according to the requester example wed, 01 mar 2006 12 00 00 gmt when you specify the authorization header, you must specify either the x amz date or the date header expect when your application uses 100 continue, it does not send the request body until it receives an acknowledgment if the message is rejected based on the headers, the body of the message is not sent this header can be used only if you are sending a body valid values 100 continue host for path style requests, the value is s3 amazonaws com for virtual style requests, the value is bucketname s3 amazonaws com for more information, go to virtual hosting in the amazon simple storage service developer guide this header is required for http 1 1 (most toolkits add this header automatically); optional for http/1 0 requests x amz content sha256 when using signature version 4 to authenticate the request, this header provides a hash of the request payload for more information see signature calculations for the authorization header transferring payload in a single chunk (aws signature version 4) when uploading an object in chunks, set the value to streaming aws4 hmac sha256 payload to indicate that the signature covers only headers and that there is no payload for more information, see signature calculations for the authorization header transferring payload in multiple chunks (chunked upload) (aws signature version 4) x amz date the current date and time according to the requester example wed, 01 mar 2006 12 00 00 gmt when you specify the authorization header, you must specify either the x amz date or the date header if you specify both, the value specified for the x amz date header takes precedence x amz security token this header can be used in the following make provide security tokens for amazon devpay operations each request that uses amazon devpay requires two x amz security token headers one for the product token and one for the user token when amazon s3 receives an authenticated request, it compares the computed signature with the provided signature improperly formatted multi value headers used to calculate a signature can cause authentication issues provide a security token when using temporary security credentials when making requests using temporary security credentials you obtained from iam, you must provide a security token using this header to learn more about temporary security credentials, go to making requests this header is required for requests that use amazon devpay and requests that are signed using temporary security credentials query strings add the desired query strings such as parameters or form fields body enter the api call body content searches list files returns a list of files from a specified location field description connection establish a connection to your aws s3 account region select your regional endpoint bucket select the amazon s3 bucket you want to search for files prefix (optional) path to a folder to lookup files in, e g make/work list folders returns a list of folders from a specified location field description connection establish a connection to your aws s3 account region select your regional endpoint bucket select the amazon s3 bucket you want to search for folders prefix (optional) path to a folder to lookup folders in, e g make/work