tigris 命令

常用示例

说明

tigris is the official command-line client for Tigris, a globally distributed, S3-compatible object storage service. The CLI presents an intentionally UNIX-flavoured interface modelled after ls, cp, rm, and touch, with t3://_bucket_/_key_ URIs identifying remote objects. The CLI groups commands by domain - bucket, object, iam, config - and each domain exposes a small, predictable set of operations. Because Tigris is S3-compatible, anything tigris can do is also reachable via the AWS CLI by pointing --endpoint-url at the Tigris endpoint; the dedicated CLI mainly improves ergonomics, login flow, and bucket lifecycle management. When a bucket is provisioned through Fly.io (using fly storage create), the same credentials and endpoints work seamlessly with tigris, and a short alias t3 is available for terser one-liners.

参数

login

Open a browser-based flow to authenticate the CLI against Tigris (or Fly.io for Fly-managed buckets).

logout

Remove cached credentials.

whoami

Print the active user and account.

configure

Interactively configure profiles, endpoints, and access keys for non-interactive use.

bucket mk _name_ --region _region_ --public

Create a new bucket. Bucket names share Tigris' global namespace.

bucket ls

List buckets owned by the active account.

bucket rm _name_

Delete an empty bucket.

ls _t3-uri_

List buckets when given no argument, or list keys under a bucket / prefix when given a t3:// URI.

cp -r --acl _acl_ --content-type _type_ _src_ _dst_

Copy data between local paths and t3:// URIs. Either side may be local or remote, enabling local-to-remote, remote-to-local, or remote-to-remote copies.

rm -r _t3-uri_

Delete a single object, or recursively delete a prefix with -r.

touch _t3-uri_

Create a zero-byte object at the given key.

presign _t3-uri_ --expires _duration_ --method _GET\|PUT_

Generate a pre-signed URL for sharing a single object without credentials.

--profile _name_

Use a named profile from the configuration file.

--endpoint _url_

Override the Tigris endpoint (defaults to fly.storage.tigris.dev).

--output _format_

_table_, _json_, or _yaml_ output.

-v, --verbose

Verbose logging.

--help

Show help for any command.