AWS Tools for Microsoft Visual Studio Team Services
User Guide

AWS S3 Download Task


Downloads file and folder content from an Amazon Simple Storage Service (S3) bucket.


Downloads file and folder content from an Amazon Simple Storage Service (S3) bucket to a folder location. The source location in the bucket, or key prefix, can also be specified. If a source location is not supplied,the bucket root is used. You specify the files to download using a set of one or more globbing patterns. The default pattern is **, causing all files in all folders at and beneath the source location to be downloaded, preserving the relative folder paths.


You can set the following parameters for the task. Required parameters are noted by an asterisk (*). Other parameters are optional.


The default name of the task, AWS S3 Download. You can rename it or append the name of the associated S3 bucket to it.

AWS Credentials*

The AWS credentials to use. If needed, choose +, and then add a new AWS connection.

AWS Region*

The AWS Region name to use. For more information, see Regions and Endpoints in the Amazon Web Services General Reference.

Bucket Name*

The name of the bucket containing the content to download.

Source Folder

The source folder (key prefix) in the bucket that the content patterns are run against. If not set, the root of the bucket is assumed.

Filename Patterns

Glob patterns to select the file and folder content to download. Supports multiple lines of minimatch patterns. The default is **.

Target Folder*

The target folder to contain the downloaded content. You can browse for it or you can use variables.



If checked, replaces existing files in and beneath the target folder. If not checked and the file already exists in the target location, an error is thrown.

Default: checked (overwrite).

Force path style addressing

If checked the task will always use path style addressing to work with the bucket. The default behavior, when unchecked, is to use virtual host style addressing if the bucket name is DNS compatible and path style otherwise. For more information see Virtual Hosting of Buckets.

Flatten folders

If checked the task will remove the key prefix from the downloaded objects causing them to be written to the selected download folder. If this option is unchecked, the key prefix of each object is preserved and objects are downloaded to a subfolder hierarchy matching the key prefix of the object.