aws-s3-rb

Delete an empty S3 bucket

$ aws s3 rb s3://[bucket_name]

$ aws s3 rb s3://[bucket_name] --force

aws s3 [options] [arguments]

--access-key
    AWS Access Key ID for authentication.

--secret-key
    AWS Secret Access Key for authentication.

--bucket
    Specifies the S3 bucket to operate on.

--region
    Specifies the AWS region.

ls
    Lists contents of a bucket.

put
    Uploads file to S3.

get
    Downloads file from S3.

del
    Deletes file from S3.

create
    Creates a new S3 bucket.

delete
    Deletes an existing S3 bucket.

The `aws-s3-rb` command is a Ruby-based command-line tool for interacting with Amazon Simple Storage Service (S3). It provides functionalities for managing buckets and objects within S3. This includes creating, deleting, listing, and manipulating buckets; and uploading, downloading, deleting, copying, and managing objects. It leverages the AWS SDK for Ruby. It simplifies common S3 operations from the Linux command line allowing users to script and automate tasks. The tool aims to simplify S3 tasks like backing up data to S3, restoring data from S3, managing website content hosted on S3, and automating other S3-related workflows directly from the terminal.

NOTE: The `aws-s3-rb` tool is not part of the official AWS CLI and may have been deprecated or replaced by newer tools like the AWS CLI.

The specific options and functionality may vary depending on the version and implementation of `aws-s3-rb` being used. It's recommended to consult the tool's documentation for the most accurate information. This tool might be deprecated in favour of the official AWS CLI.

The command typically requires AWS credentials to be configured, either through environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION) or by passing them directly as command-line arguments. Using IAM roles is another valid authentication method, if your environment supports it.

Pay attention to error messages returned by the command, as they often provide valuable insights into the root cause of problems, such as incorrect credentials, insufficient permissions, or issues with the specified S3 path.

The `aws-s3-rb` tool was developed as a lightweight alternative to the official AWS CLI, particularly before the AWS CLI became as feature-rich and widely adopted as it is today. It leverages the Ruby AWS SDK to provide a simpler command-line interface for basic S3 operations. Its development was driven by the need for quick and easy S3 management from scripts and command line, without the overhead of more complex tools. Over time, its usage has likely diminished as the official AWS CLI has become the preferred tool for most users due to its comprehensive feature set and official support.

aws(1), s3cmd(1)