aws-s3-rb
Remove Amazon S3 buckets
TLDR
Delete an empty S3 bucket
Force delete an S3 bucket and its non-versioned objects (will crash if versioned objects are present)
SYNOPSIS
aws-s3-rb <command> [<options>] [<arguments>]
Examples:aws-s3-rb list <bucket-name> [--prefix <prefix>]
aws-s3-rb put <bucket-name> <local-file> [<s3-key>] [--acl <permission>]
aws-s3-rb get <bucket-name> <s3-key> [<local-file>]
aws-s3-rb delete <bucket-name> <s3-key>
PARAMETERS
<command>
The specific operation to perform (e.g., list
, put
, get
, delete
).
<bucket-name>
The name of the S3 bucket to interact with.
<local-file>
The path to the local file for upload or download operations.
<s3-key>
The key (path) of the object in the S3 bucket.
--prefix <prefix>
Filters listed objects to those beginning with the specified prefix.
--acl <permission>
Sets the Access Control List for an uploaded object (e.g., public-read
, private
).
--region <region>
Specifies the AWS region where the bucket resides (e.g., us-east-1
).
--verbose
Increases the verbosity of the command's output.
--force
Forces an operation, often bypassing confirmation prompts for destructive actions.
DESCRIPTION
aws-s3-rb
(likely a Ruby script or wrapper around the aws-s3
Ruby gem) is a command-line interface designed for interacting with Amazon S3 (Simple Storage Service). Unlike the modern AWS CLI, this tool predates or exists as an alternative to it, typically leveraging the aws-s3
gem, a Ruby library for S3 communication.
It enables users to perform fundamental S3 operations directly from the terminal, such as listing buckets, managing objects (uploading, downloading, deleting), and handling basic bucket configurations. Its primary utility lies in scripting and automating S3 interactions in environments where Ruby is preferred or pre-installed. Given its nature as a custom script or an older tool, its exact functionality and command-line arguments might vary based on its specific implementation or the version of the aws-s3
gem it utilizes. It's generally considered a legacy tool, with modern S3 interactions often handled by the official AWS CLI.
CAVEATS
- Non-Standard Command:
aws-s3-rb
is not a standard Linux utility and is likely a custom script or an older tool based on theaws-s3
Ruby gem. Its availability and exact behavior depend on its specific installation and implementation. - Legacy Tool: It's largely considered a legacy tool. Modern AWS S3 interactions are typically handled by the official AWS CLI (
aws s3
), which is more robust, actively maintained, and feature-rich. - Authentication: May rely on environment variables (
AWS_ACCESS_KEY_ID
,AWS_SECRET_ACCESS_KEY
) or direct command-line arguments for authentication, which is generally less secure than IAM roles or AWS CLI profiles. - Limited Features: May lack advanced features found in the official AWS CLI, such as multipart uploads for large files, S3 Transfer Acceleration, S3 events, or complex IAM policy management.
- Maintenance: The underlying
aws-s3
Ruby gem is likely not actively maintained, potentially leading to compatibility issues with newer AWS S3 features or API changes.
INSTALLATION
The command itself is not typically installed via standard package managers. It would usually be made available by installing the aws-s3
Ruby gem (gem install aws-s3
) and potentially creating a symbolic link or wrapper script to the gem's executable (often aws-s3
) under the name aws-s3-rb
.
USAGE CONTEXT
Primarily useful in legacy systems, specific Ruby-centric automation scripts, or environments where the official AWS CLI cannot be installed or is considered overkill for simple S3 tasks.
HISTORY
The command aws-s3-rb
, if it exists as a standalone executable, likely emerged as a simplified wrapper or direct execution point for functionalities provided by the aws-s3
Ruby gem. This gem was a popular choice for interacting with Amazon S3 in Ruby applications and scripts during the earlier days of AWS, prior to the widespread adoption and development of the official AWS SDKs and CLI in multiple languages. It provided a programmatic and command-line interface for S3 operations, appealing to developers and system administrators working within a Ruby ecosystem. Its usage has largely been superseded by the more comprehensive and officially supported AWS SDK for Ruby and the general-purpose AWS CLI.