Storj IconSTORJ | DCS Docs
DCSNode Operator
AWS CLI Advanced Options

AWS CLI Advanced Options #

Define an endpoint with AWS CLI #

Installing pluginawscli-plugin-endpoint will also install the AWS CLI v1

Install awscli-plugin-endpoint plugin:

~ % pip3 install awscli-plugin-endpoint

Configure plugin in your ~/.aws/config file:

~ % aws configure set plugins.endpoint awscli_plugin_endpoint

  1. Install the AWS CLI v2.x

  2. Install awscli-plugin-endpoint plugin:

    ~ % pip3 install --no-deps awscli-plugin-endpoint

    Remember the path where the plugin is installed, you will need it in the next step.

  3. Configure the path in your ~/.aws/config file (replace the site-packages-path to your path from a previous step):

    ~ % aws configure set plugins.cli_legacy_plugin_path site-packages-path

  4. Configure plugin in your ~/.aws/config file:

    ~ % aws configure set plugins.endpoint awscli_plugin_endpoint

..and configure the default profile (see Storj-hosted S3 Compatible Gateway to choose a correct endpoint):

~ % aws configure set default.s3.endpoint_url https://gateway.storjshare.io
~ % aws configure set default.s3.multipart_threshold 60MB
~ % aws configure set default.s3.multipart_chunksize 60MB

The resulting file would look like:

[plugins]
endpoint = awscli_plugin_endpoint

[default]
s3 =
  endpoint_url = https://gateway.storjshare.io
  multipart_threshold = 60MB
  multipart_chunksize = 60MB

[plugins]
cli_legacy_plugin_path = c:\users\USER\appdata\local\packages\pythonsoftwarefoundation.python.3.8_qbz5n2kfra8p0\localcache\local-packages\python38\site-packages
endpoint = awscli_plugin_endpoint

[default]
s3 =
  endpoint_url = https://gateway.storjshare.io
  multipart_threshold = 60MB
  multipart_chunksize = 60MB

You can now use the AWS CLI without specifying an endpoint:

~ % aws s3 ls
2021-01-08 19:41:13 demo

To configure s3api endpoint you can use this command:

~ % aws configure set default.s3api.endpoint_url https://gateway.storjshare.io

You can also use a different profile for Storj:

~ % aws configure set profile.storj.s3.endpoint_url https://gateway.storjshare.io
~ % aws configure set profile.storj.s3.multipart_threshold 1TB

To use AWS CLI with a separate profile storj:

~ % aws s3 --profile storj ls
2021-01-08 19:41:13 demo