Skip to main content

List

Use this page when you want to list your buckets or inspect the objects inside one bucket.

Before you start​

Make sure your AWS CLI profile or rclone remote is already configured with the correct endpoint and credentials.

If you need to confirm the endpoint or region first, check Keys and endpoint.

Example variables​

export S3_ENDPOINT="https://<your-endpoint>"
export S3_REGION="<your-region>"
export AWS_PROFILE="<your-aws-cli-profile>"
export RCLONE_REMOTE="<your-rclone-remote>"
export BUCKET_NAME="<your-bucket-name>"

List buckets with AWS CLI​

aws s3 ls \
  --endpoint-url "$S3_ENDPOINT" \
  --region "$S3_REGION" \
  --profile "$AWS_PROFILE"

List objects inside one bucket with AWS CLI​

aws s3 ls s3://$BUCKET_NAME \
  --endpoint-url "$S3_ENDPOINT" \
  --region "$S3_REGION" \
  --profile "$AWS_PROFILE"

List buckets with rclone​

rclone lsd ${RCLONE_REMOTE}:

List objects inside one bucket with rclone​

rclone ls ${RCLONE_REMOTE}:$BUCKET_NAME

When to use each command​

  • use the bucket list command when you want to confirm whether a bucket exists
  • use the object list command when you want to inspect the contents of one bucket
note

Portal and CLI views

The customer area shows a bucket list and usage summary, while AWS CLI and rclone are useful when you want to confirm the result directly from the command line.