linode-cli-object-storage

List all Object Storage buckets

$ linode-cli object-storage buckets list

$ linode-cli object-storage buckets create --cluster [cluster_id] --label [bucket_label]

$ linode-cli object-storage buckets delete [cluster_id] [bucket_label]

$ linode-cli object-storage clusters list

$ linode-cli object-storage keys list

$ linode-cli object-storage keys create --label [label]

$ linode-cli object-storage keys revoke [access_key_id]

linode-cli object-storage command [arguments...]

bucket-create
    Creates a new Object Storage bucket in a specified region.

bucket-delete
    Deletes an existing Object Storage bucket. This operation is irreversible and will remove all contents.

bucket-ls
    Lists all Object Storage buckets accessible by your account. Can also list objects within a specified bucket if given a bucket name.

bucket-ssl-upload
    Uploads a custom SSL certificate for a specific bucket, enabling HTTPS access with your domain.

bucket-ssl-delete
    Deletes a custom SSL certificate previously associated with a bucket.

object-delete
    Deletes an object from a specified bucket.

object-get
    Downloads an object from a specified bucket to your local machine.

object-ls
    Lists objects within a specified bucket. This is an alias for 'bucket-ls '.

object-put
    Uploads a file as an object to a specified bucket.

object-url
    Generates a URL for an object in a specified bucket, optionally a presigned URL for temporary public access.

access-key-create
    Creates a new Object Storage access key (access key ID and secret access key) for programmatic S3-compatible access.

access-key-delete
    Deletes an existing Object Storage access key.

access-key-ls
    Lists all Object Storage access keys associated with your account.

access-key-regenerate
    Regenerates the secret key for an existing Object Storage access key, invalidating the old one.

access-key-update
    Updates the label or permissions (e.g., read_only) for an existing Object Storage access key.

The linode-cli object-storage command (often referred to as linode-cli-object-storage) is a powerful interface for interacting with Linode's S3-compatible Object Storage service. It enables users to programmatically manage their storage resources, including creating, deleting, and listing storage buckets, as well as uploading, downloading, listing, and deleting individual objects within those buckets.

This command streamlines workflows for developers and system administrators by providing a consistent way to automate storage tasks, integrate with applications, and perform bulk operations directly from the command line. It handles authentication and region configuration through the main linode-cli setup, making it easy to manage geographically diverse storage assets.

Requires the linode-cli to be installed and configured with an API token. Operations are region-specific; ensure you specify the correct region (e.g., via --region flag) when creating buckets or interacting with them.
Deleting a bucket is a permanent action and cannot be undone. Ensure the bucket is empty before attempting deletion to avoid errors.

Linode Object Storage is highly S3-compatible. This means many tools, libraries, and SDKs designed for Amazon S3 can be configured to work with Linode Object Storage by simply changing the endpoint URL to Linode's Object Storage URL for your chosen region and using your Linode Object Storage access keys.

All linode-cli object-storage operations rely on the Linode API token configured for your linode-cli installation. This token grants the CLI permission to interact with your Linode account. For direct S3-compatible access from other applications or tools, you'll use specific Object Storage access keys (an access key ID and a secret access key), which can be managed via the access-key subcommands.

Linode Object Storage was officially launched in 2018, providing an S3-compatible cloud storage solution. Support for Object Storage through the Linode CLI followed shortly thereafter, integrating seamlessly into the existing CLI framework. This development allowed for greater automation and programmatic control over Linode's storage offerings, enhancing its utility for cloud-native applications and data management strategies.

linode-cli(1), aws-cli s3, s3cmd(1), curl(1)