Skip to main content
The AWS CLI can call Hivenet Object Storage through the Hivenet S3 endpoint. Use a dedicated profile so these settings do not replace an existing AWS configuration.

​
What you’ll need

  • AWS CLI installed.
  • Your Hivenet access key ID and secret access key.
  • A bucket created in Object Storage.
  • A small local test file, such as hello.txt.
For self-service storage, uploads require a positive organization credit balance. At a zero or negative balance, your organization’s configuration determines whether storage becomes Read only or Disabled. Object listing and downloads remain available in Read only mode and are blocked in Disabled mode. See When credits run out. These commands use the profile name hivenet. Replace YOUR_BUCKET with your bucket’s name.

​
Configure the profile

Run:
At the prompts, enter: Then explicitly enable path-style addressing and Signature Version 4:
Protect the local credentials file created by the CLI. Enter the Hivenet credential pair at the prompts; do not put real secrets in shared commands or documentation.

​
Test the connection

List buckets:
An empty bucket list is a valid response if your organization has no buckets. List objects in a bucket:
Every command in this guide includes the Hivenet endpoint. Omitting it can send the request to AWS.

​
Upload a file

Choose an object key that does not already contain data you need to keep:
Uploading to an existing key replaces that object. The high-level aws s3 cp command manages multipart transfers when needed. A raw s3api put-object request is a single upload and has Hivenet’s 5 GB single-request limit.

​
Download a file

Use a new local filename to avoid replacing a file you need:

​
Download many objects

First preview a copy of the bucket into a local directory:
Check the source and destination, then run it without --dryrun:
To copy only a prefix, use a source such as s3://YOUR_BUCKET/reports/. For repeat downloads, aws s3 sync can transfer new or changed files. Review the AWS sync reference before adding filters or deletion options.

​
Request reference

See AWS CLI S3 configuration and the copy command reference for client syntax. Use only the operations covered by Hivenet S3 compatibility. For connection failures, see Troubleshooting.