Tigris Object Operations
Quick Reference
| Command | Description |
|---|
| List objects under a bucket/prefix |
| Copy files local↔remote or remote↔remote |
| Move/rename objects within Tigris |
| Delete objects or folders |
| Create an empty object |
| Show object metadata or storage stats |
| Generate a presigned URL |
tigris objects list <bucket>
| List objects (low-level) |
tigris objects get <bucket> <key>
| Download an object (low-level) |
tigris objects put <bucket> <key> <file>
| Upload an object (low-level) |
tigris objects delete <bucket> <key>
| Delete an object (low-level) |
tigris objects set <bucket> <key>
| Update object settings (low-level) |
URI Scheme
Remote paths use
or
. Bare
paths are also accepted.
Unix-Style Commands (primary interface)
(alias: )
List all buckets (no arguments) or objects under a bucket/prefix path.
bash
tigris ls # list all buckets
tigris ls my-bucket # list objects in bucket
tigris ls my-bucket/images/ # list objects under prefix
tigris ls t3://my-bucket/prefix/
| Flag | Alias | Description | Default |
|---|
| | Read from a specific bucket snapshot | |
| | Output format (, , ) | |
| | Output as JSON | |
(alias: )
Copy files between local filesystem and Tigris, or between paths within Tigris. At least one side must be a remote
path. Quote wildcard patterns to prevent shell expansion.
bash
tigris cp ./file.txt t3://my-bucket/file.txt # upload
tigris cp t3://my-bucket/file.txt ./local-copy.txt # download
tigris cp t3://my-bucket/src/ t3://my-bucket/dest/ -r # remote-to-remote
tigris cp ./images/ t3://my-bucket/images/ -r # recursive upload
| Flag | Alias | Description |
|---|
| | Copy directories recursively |
| | Output format (, ; default: ) |
| | Output as JSON |
(alias: )
Move (rename) objects within Tigris. Both source and destination must be remote paths. Quote wildcard patterns to prevent shell expansion.
bash
tigris mv t3://my-bucket/old.txt t3://my-bucket/new.txt -f
tigris mv t3://my-bucket/old-dir/ t3://my-bucket/new-dir/ -rf
tigris mv my-bucket/a.txt my-bucket/b.txt -f
| Flag | Alias | Description |
|---|
| | Move directories recursively |
| | Skip confirmation prompt |
| | Output format (, ; default: ) |
| | Output as JSON |
(alias: )
Remove a bucket, folder, or object from Tigris. A bare bucket name deletes the bucket itself. Quote wildcard patterns to prevent shell expansion.
bash
tigris rm t3://my-bucket/file.txt -f
tigris rm t3://my-bucket/folder/ -rf
tigris rm t3://my-bucket -f # deletes the bucket
tigris rm "t3://my-bucket/logs/*.tmp" -f # wildcard delete
| Flag | Alias | Description |
|---|
| | Remove directories recursively |
| | Skip confirmation prompt |
| | Output format (, ; default: ) |
| | Output as JSON |
Create an empty (zero-byte) object at the given bucket/key path.
bash
tigris touch my-bucket/placeholder.txt
tigris touch t3://my-bucket/logs/
| Flag | Alias | Description |
|---|
| | Output format (, ; default: ) |
| | Output as JSON |
Show storage stats (no args), bucket info, or object metadata.
bash
tigris stat # overall storage stats
tigris stat t3://my-bucket # bucket info
tigris stat t3://my-bucket/my-object.json # object metadata
| Flag | Alias | Description | Default |
|---|
| | Read from a specific bucket snapshot | |
| | Output format (, , ) | |
| | Output as JSON | |
Presigned URLs
Generate a presigned URL for temporary access to an object without credentials.
bash
tigris presign my-bucket/file.txt
tigris presign t3://my-bucket/report.pdf --method put --expires-in 7200
tigris presign my-bucket/image.png --format json
tigris presign my-bucket/data.csv --access-key tid_AaBb
| Flag | Alias | Description | Default |
|---|
| | HTTP method (, ) | |
| | URL expiry time in seconds | |
| | Access key ID for signing (resolved from credentials if not provided) | |
| | Output format (, ) | |
| | Output as JSON | |
Use cases:
- Temporary sharing of private objects (GET)
- Client-side uploads without exposing credentials (PUT)
Low-Level Subcommand
For programmatic and granular control over individual objects.
tigris objects list <bucket>
List objects in a bucket, optionally filtered by a key prefix.
bash
tigris objects list my-bucket
tigris objects list my-bucket --prefix images/
tigris objects list my-bucket --json
| Flag | Alias | Description |
|---|
| | Filter objects by key prefix |
| | Read from a specific bucket snapshot |
| | Output format (, , ; default: ) |
| | Output as JSON |
tigris objects get <bucket> <key>
Download an object by key. Prints to stdout by default, or saves to a file with
.
bash
tigris objects get my-bucket config.json
tigris objects get my-bucket archive.zip --output ./archive.zip --mode stream
| Flag | Alias | Description |
|---|
| | Output file path (prints to stdout if not specified) |
| | Response mode: (loads into memory) or (writes in chunks) |
| | Read from a specific bucket snapshot |
| | Output format (, ; default: ) |
| | Output as JSON |
tigris objects put <bucket> <key> <file>
Upload a local file as an object. Content-type is auto-detected from extension unless overridden.
bash
tigris objects put my-bucket report.pdf ./report.pdf
tigris objects put my-bucket logo.png ./logo.png --access public --content-type image/png
| Flag | Alias | Description | Default |
|---|
| | Access level (, ) | |
| | Content type (auto-detected if omitted) | |
| | Output format (, , ) | |
| | Output as JSON | |
tigris objects delete <bucket> <key>
Delete one or more objects by key. Accepts comma-separated keys.
bash
tigris objects delete my-bucket old-file.txt --force
tigris objects delete my-bucket file-a.txt,file-b.txt --force
| Flag | Description |
|---|
| Skip confirmation prompt |
| / | Output format (, ; default: ) |
| Output as JSON |
tigris objects set <bucket> <key>
Update settings on an existing object such as access level or key name.
bash
tigris objects set my-bucket my-file.txt --access public
tigris objects set my-bucket my-file.txt --access private
| Flag | Alias | Description |
|---|
| | Access level (, ) — required |
| | Rename the object to a new key |
| | Output format (, ; default: ) |
| | Output as JSON |
Common Patterns
bash
# Recursive upload
tigris cp ./dist/ t3://my-bucket/static/ -r
# Download an entire directory
tigris cp t3://my-bucket/backups/ ./local-backups/ -r
# Wildcard delete (quote the pattern!)
tigris rm "t3://my-bucket/logs/*.tmp" -rf
# Generate a presigned upload URL for client-side uploads
tigris presign my-bucket/user-uploads/photo.jpg --method put --expires-in 600