Overview

In order to download data from Blackfynn Discover, you will need to install the Amazon AWS Command Line Interface. The CLI allows you to programmatically get access to the data on Amazon S3 using your personal AWS account.

Setting up the AWS CLI consists of two steps:

1. Installing the AWS CLI tool
2. Configuring the AWS CLI tool to use your credentials.

Installing the AWS CLI

We recommend to install AWS CLI version 2. You can download the installers here:

• Mac AWS CLI Installer
• Windows AWS CLI installer

Run the installer package to install the CLI on your machine. Typically, it is best to install the CLI for all users of your computer.

📘

Additional information on AWS CLI

For more detailed information and other operating systems, AWS provides detailed instructions on various ways to install the client here: https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html

Configuring AWS CLI Tools

There are many specialized ways to configure the AWS CLI. However, for purpose of accessing public data from Blackfynn Discover, the configuration is very simple using the aws configure command.

$ aws configure
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLEAWS 
Secret Access Key [None]: wJalxRfiCYEXAMPLEKEYDefault 
region name [None]: us-east-1
Default output format [None]: json

After confirming the credentials, you will now be able to interact with Amazon AWS as the IAM user associated with your account. We recommend to increase the number of concurrent connections to 200. This will significantly increase the download speed.

$ aws configure set default.s3.max_concurrent_requests 200

📘

Additional information on AWS CLI Configuration

You can find more detailed information about configuring your CLI at the AWS Documentation site: https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html