tigris-buckets
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseTigris Bucket Management
Tigris存储桶管理
Quick Reference
快速参考
| Command | Description |
|---|---|
| Create a bucket (or folder with trailing |
| List all buckets |
| Inspect bucket details |
| Delete a bucket |
| Update bucket settings |
| Configure object expiration |
| Set data locations |
| Configure shadow bucket migration |
| Configure storage class transitions |
| Configure event webhooks |
| Configure CORS rules |
| List bucket snapshots |
| Take a snapshot |
| 命令 | 描述 |
|---|---|
| 创建存储桶(或末尾带 |
| 列出所有存储桶 |
| 查看存储桶详细信息 |
| 删除存储桶 |
| 更新存储桶设置 |
| 配置对象过期时间 |
| 设置数据存储位置 |
| 配置影子存储桶数据迁移 |
| 配置存储层级转换规则 |
| 配置事件Webhook通知 |
| 配置CORS规则 |
| 列出存储桶快照 |
| 创建存储桶快照 |
Create a Bucket
创建存储桶
tigris mk <path>
(alias: create
)
tigris mk <path>createtigris mk <path>
(别名:create
)
tigris mk <path>createCreate a bucket (bare name) or a folder inside a bucket (trailing ). Supports and URI prefixes.
/t3://tigris://bash
tigris mk my-bucket
tigris mk my-bucket --access public --locations iad
tigris mk my-bucket/images/ # creates a folder
tigris mk t3://my-bucket
tigris mk my-fork --fork-of my-bucket
tigris mk my-fork --fork-of my-bucket --source-snapshot 1765889000501544464创建存储桶(纯名称)或存储桶内的文件夹(末尾带)。支持和 URI前缀。
/t3://tigris://bash
tigris mk my-bucket
tigris mk my-bucket --access public --locations iad
tigris mk my-bucket/images/ # 创建文件夹
tigris mk t3://my-bucket
tigris mk my-fork --fork-of my-bucket
tigris mk my-fork --fork-of my-bucket --source-snapshot 1765889000501544464tigris buckets create <name>
(alias: c
)
tigris buckets create <name>ctigris buckets create <name>
(别名:c
)
tigris buckets create <name>cSame as but under the subcommand.
mkbucketsbash
tigris buckets create my-bucket
tigris buckets create my-bucket --access public --locations iad
tigris buckets create my-bucket --enable-snapshots --default-tier STANDARD_IA
tigris buckets create my-fork --fork-of my-bucket
tigris buckets create my-fork --fork-of my-bucket --source-snapshot 1765889000501544464Flags:
| Flag | Alias | Description | Default |
|---|---|---|---|
| | Access level ( | |
| Shorthand for | ||
| | Bucket location (see Locations) | |
| | Default storage tier (see Storage Tiers) | |
| | Enable snapshots for the bucket | |
| | Create as a fork (copy-on-write clone) of the named source bucket | |
| | Fork from a specific snapshot (requires | |
| | Output format ( | |
| Output as JSON | ||
| | (Deprecated) Use | |
| | (Deprecated) Use |
功能与相同,属于子命令下的操作。
mkbucketsbash
tigris buckets create my-bucket
tigris buckets create my-bucket --access public --locations iad
tigris buckets create my-bucket --enable-snapshots --default-tier STANDARD_IA
tigris buckets create my-fork --fork-of my-bucket
tigris buckets create my-fork --fork-of my-bucket --source-snapshot 1765889000501544464参数选项:
| 参数选项 | 别名 | 描述 | 默认值 |
|---|---|---|---|
| | 访问级别( | |
| | ||
| | 存储桶位置(详见存储位置) | |
| | 默认存储层级(详见存储层级) | |
| | 为存储桶启用快照功能 | |
| | 创建为指定源存储桶的分支(写时复制克隆) | |
| | 从指定快照创建分支(需配合 | |
| | 输出格式( | |
| 以JSON格式输出 | ||
| | (已废弃) 请使用 | |
| | (已废弃) 请使用 |
List Buckets
列出存储桶
tigris buckets list
(alias: l
)
tigris buckets listltigris buckets list
(别名:l
)
tigris buckets listlList all buckets in the current organization.
bash
tigris buckets list
tigris buckets list --json
tigris buckets list --forks-of my-bucket| Flag | Description |
|---|---|
| Only list buckets that are forks of the named source bucket |
| Output format ( |
| Output as JSON |
列出当前组织下的所有存储桶。
bash
tigris buckets list
tigris buckets list --json
tigris buckets list --forks-of my-bucket| 参数选项 | 描述 |
|---|---|
| 仅列出指定源存储桶的所有分支存储桶 |
| 输出格式( |
| 以JSON格式输出 |
Inspect a Bucket
查看存储桶详情
tigris buckets get <name>
(alias: g
)
tigris buckets get <name>gtigris buckets get <name>
(别名:g
)
tigris buckets get <name>gShow details for a bucket including access level, region, tier, and custom domain.
bash
tigris buckets get my-bucket
tigris buckets get my-bucket --json| Flag | Description |
|---|---|
| Output format ( |
| Output as JSON |
显示存储桶的详细信息,包括访问级别、区域、存储层级和自定义域名。
bash
tigris buckets get my-bucket
tigris buckets get my-bucket --json| 参数选项 | 描述 |
|---|---|
| 输出格式( |
| 以JSON格式输出 |
Delete a Bucket
删除存储桶
tigris buckets delete <name>
(alias: d
)
tigris buckets delete <name>dtigris buckets delete <name>
(别名:d
)
tigris buckets delete <name>dDelete one or more buckets by name. Accepts comma-separated names.
bash
tigris buckets delete my-bucket --force
tigris buckets delete bucket-a,bucket-b --force| Flag | Description |
|---|---|
| Skip confirmation prompt |
| Output format ( |
| Output as JSON |
按名称删除一个或多个存储桶,支持逗号分隔的多个名称。
bash
tigris buckets delete my-bucket --force
tigris buckets delete bucket-a,bucket-b --force| 参数选项 | 描述 |
|---|---|
| 跳过确认提示 |
| 输出格式( |
| 以JSON格式输出 |
Update Bucket Settings
更新存储桶设置
tigris buckets set <name>
(alias: s
)
tigris buckets set <name>stigris buckets set <name>
(别名:s
)
tigris buckets set <name>sUpdate settings on an existing bucket.
bash
tigris buckets set my-bucket --access public
tigris buckets set my-bucket --locations iad,fra --cache-control 'max-age=3600'
tigris buckets set my-bucket --custom-domain assets.example.com| Flag | Description |
|---|---|
| Bucket access level ( |
| Bucket locations (see Locations) |
| Enable delete protection ( |
| Default cache-control header value |
| Custom domain for the bucket |
| Enable object-level ACL ( |
| Disable directory listing ( |
| Enable additional HTTP headers like |
| (Deprecated) Use |
| Output format ( |
| Output as JSON |
更新现有存储桶的设置。
bash
tigris buckets set my-bucket --access public
tigris buckets set my-bucket --locations iad,fra --cache-control 'max-age=3600'
tigris buckets set my-bucket --custom-domain assets.example.com| 参数选项 | 描述 |
|---|---|
| 存储桶访问级别( |
| 存储桶位置(详见存储位置) |
| 启用删除保护( |
| 默认缓存控制头值 |
| 存储桶的自定义域名 |
| 启用对象级ACL权限控制( |
| 禁用目录列表( |
| 启用额外HTTP头,如 |
| (已废弃) 请使用 |
| 输出格式( |
| 以JSON格式输出 |
Bucket Configuration Commands
存储桶配置命令
tigris buckets set-ttl <name>
tigris buckets set-ttl <name>tigris buckets set-ttl <name>
tigris buckets set-ttl <name>Configure object expiration (TTL) on a bucket.
bash
tigris buckets set-ttl my-bucket --days 30
tigris buckets set-ttl my-bucket --date 2026-06-01
tigris buckets set-ttl my-bucket --disable| Flag | Alias | Description |
|---|---|---|
| | Expire objects after this many days |
| Expire objects on this date (ISO-8601, e.g. | |
| Enable TTL (uses existing lifecycle rules) | |
| Disable TTL on the bucket |
配置存储桶的对象过期时间(TTL)。
bash
tigris buckets set-ttl my-bucket --days 30
tigris buckets set-ttl my-bucket --date 2026-06-01
tigris buckets set-ttl my-bucket --disable| 参数选项 | 别名 | 描述 |
|---|---|---|
| | 对象在指定天数后过期 |
| 对象在指定日期过期(ISO-8601格式,例如 | |
| 启用TTL(使用现有生命周期规则) | |
| 禁用存储桶的TTL功能 |
tigris buckets set-locations <name>
tigris buckets set-locations <name>tigris buckets set-locations <name>
tigris buckets set-locations <name>Set the data locations for a bucket.
bash
tigris buckets set-locations my-bucket --locations iad
tigris buckets set-locations my-bucket --locations iad,fra
tigris buckets set-locations my-bucket --locations global| Flag | Alias | Description |
|---|---|---|
| | Bucket location(s) — comma-separated (see Locations) |
设置存储桶的数据存储位置。
bash
tigris buckets set-locations my-bucket --locations iad
tigris buckets set-locations my-bucket --locations iad,fra
tigris buckets set-locations my-bucket --locations global| 参数选项 | 别名 | 描述 |
|---|---|---|
| | 存储桶位置(逗号分隔,详见存储位置) |
tigris buckets set-migration <name>
tigris buckets set-migration <name>tigris buckets set-migration <name>
tigris buckets set-migration <name>Configure data migration from an external S3-compatible source bucket. Tigris pulls objects on demand from the source (shadow bucket pattern).
bash
tigris buckets set-migration my-bucket \
--bucket source-bucket \
--endpoint https://s3.amazonaws.com \
--region us-east-1 \
--access-key AKIA... \
--secret-key wJal...配置从外部兼容S3的源存储桶进行数据迁移。Tigris会按需从源存储桶拉取对象(影子存储桶模式)。
bash
tigris buckets set-migration my-bucket \
--bucket source-bucket \
--endpoint https://s3.amazonaws.com \
--region us-east-1 \
--access-key AKIA... \
--secret-key wJal...Enable write-through (writes go to both source and Tigris)
启用写通模式(写入操作同时同步到源存储桶和Tigris)
tigris buckets set-migration my-bucket
--bucket source-bucket
--endpoint https://s3.amazonaws.com
--region us-east-1
--access-key AKIA...
--secret-key wJal...
--write-through
--bucket source-bucket
--endpoint https://s3.amazonaws.com
--region us-east-1
--access-key AKIA...
--secret-key wJal...
--write-through
tigris buckets set-migration my-bucket
--bucket source-bucket
--endpoint https://s3.amazonaws.com
--region us-east-1
--access-key AKIA...
--secret-key wJal...
--write-through
--bucket source-bucket
--endpoint https://s3.amazonaws.com
--region us-east-1
--access-key AKIA...
--secret-key wJal...
--write-through
Disable migration
禁用迁移
tigris buckets set-migration my-bucket --disable
**Migration workflow:** Point Tigris at your existing S3-compatible bucket. Tigris serves objects on demand — when a request hits Tigris and the object isn't cached yet, it fetches from the source. Over time, all accessed objects are pulled into Tigris. Use `--write-through` to also push new writes back to the source during migration.
| Flag | Alias | Description |
| ----------------- | ---------- | -------------------------------------------------- |
| `--bucket` | `-b` | Name of the source bucket to migrate from |
| `--endpoint` | `-e` | Endpoint URL of the source S3-compatible service |
| `--region` | `-r` | Region of the source bucket |
| `--access-key` | `--key` | Access key for the source bucket |
| `--secret-key` | `--secret` | Secret key for the source bucket |
| `--write-through` | | Enable write-through mode |
| `--disable` | | Disable migration and clear all migration settings |tigris buckets set-migration my-bucket --disable
**迁移流程:** 将Tigris指向您现有的兼容S3的存储桶。Tigris会按需提供对象——当请求到达Tigris且对象尚未缓存时,它会从源存储桶获取对象。随着时间推移,所有被访问的对象都会被拉取到Tigris中。使用`--write-through`可以在迁移期间将新写入的内容同步回源存储桶。
| 参数选项 | 别名 | 描述 |
| ----------------- | ---------- | ------------------------------------------- |
| `--bucket` | `-b` | 要迁移的源存储桶名称 |
| `--endpoint` | `-e` | 源兼容S3服务的端点URL |
| `--region` | `-r` | 源存储桶的区域 |
| `--access-key` | `--key` | 源存储桶的访问密钥 |
| `--secret-key` | `--secret` | 源存储桶的密钥 |
| `--write-through` | | 启用写通模式 |
| `--disable` | | 禁用迁移并清除所有迁移设置 |tigris buckets set-transition <name>
tigris buckets set-transition <name>tigris buckets set-transition <name>
tigris buckets set-transition <name>Configure a lifecycle transition rule. Automatically move objects to a different storage class after a number of days or on a specific date.
bash
tigris buckets set-transition my-bucket --storage-class STANDARD_IA --days 30
tigris buckets set-transition my-bucket --storage-class GLACIER --date 2026-06-01
tigris buckets set-transition my-bucket --enable
tigris buckets set-transition my-bucket --disable| Flag | Alias | Description |
|---|---|---|
| | Target storage class ( |
| | Transition objects after this many days |
| Transition objects on this date (ISO-8601) | |
| Enable lifecycle transition rules | |
| Disable lifecycle transition rules |
配置生命周期转换规则。在指定天数后或特定日期自动将对象移动到不同的存储层级。
bash
tigris buckets set-transition my-bucket --storage-class STANDARD_IA --days 30
tigris buckets set-transition my-bucket --storage-class GLACIER --date 2026-06-01
tigris buckets set-transition my-bucket --enable
tigris buckets set-transition my-bucket --disable| 参数选项 | 别名 | 描述 |
|---|---|---|
| | 目标存储层级( |
| | 对象在指定天数后转换存储层级 |
| 对象在指定日期转换存储层级(ISO-8601格式) | |
| 启用生命周期转换规则 | |
| 禁用生命周期转换规则 |
tigris buckets set-notifications <name>
tigris buckets set-notifications <name>tigris buckets set-notifications <name>
tigris buckets set-notifications <name>Configure object event notifications. Sends webhook requests to a URL when objects are created, updated, or deleted.
bash
tigris buckets set-notifications my-bucket --url https://example.com/webhook
tigris buckets set-notifications my-bucket --url https://example.com/webhook --token secret123
tigris buckets set-notifications my-bucket --url https://example.com/webhook --username admin --password secret
tigris buckets set-notifications my-bucket --url https://example.com/webhook --filter 'WHERE `key` REGEXP "^images"'
tigris buckets set-notifications my-bucket --enable
tigris buckets set-notifications my-bucket --disable
tigris buckets set-notifications my-bucket --reset| Flag | Alias | Description |
|---|---|---|
| | Webhook URL (must be |
| | SQL WHERE clause to filter events by key |
| | Token for webhook authentication |
| Username for basic webhook authentication | |
| Password for basic webhook authentication | |
| Enable notifications (uses existing config) | |
| Disable notifications (preserves existing config) | |
| Clear all notification settings |
配置对象事件通知。当对象被创建、更新或删除时,向指定URL发送Webhook请求。
bash
tigris buckets set-notifications my-bucket --url https://example.com/webhook
tigris buckets set-notifications my-bucket --url https://example.com/webhook --token secret123
tigris buckets set-notifications my-bucket --url https://example.com/webhook --username admin --password secret
tigris buckets set-notifications my-bucket --url https://example.com/webhook --filter 'WHERE `key` REGEXP "^images"'
tigris buckets set-notifications my-bucket --enable
tigris buckets set-notifications my-bucket --disable
tigris buckets set-notifications my-bucket --reset| 参数选项 | 别名 | 描述 |
|---|---|---|
| | Webhook URL(必须为 |
| | 用于按对象键过滤事件的SQL WHERE子句 |
| | Webhook认证令牌 |
| Webhook基础认证的用户名 | |
| Webhook基础认证的密码 | |
| 启用通知功能(使用现有配置) | |
| 禁用通知功能(保留现有配置) | |
| 清除所有通知设置 |
tigris buckets set-cors <name>
tigris buckets set-cors <name>tigris buckets set-cors <name>
tigris buckets set-cors <name>Configure CORS rules on a bucket. Each invocation adds a rule unless or is used.
--override--resetbash
tigris buckets set-cors my-bucket --origins '*' --methods GET,HEAD
tigris buckets set-cors my-bucket --origins https://example.com --methods GET,POST --headers Content-Type,Authorization --max-age 3600
tigris buckets set-cors my-bucket --origins https://example.com --override
tigris buckets set-cors my-bucket --reset| Flag | Alias | Description |
|---|---|---|
| | Allowed origins (comma-separated, or |
| | Allowed HTTP methods (comma-separated) |
| Allowed request headers (comma-separated, or | |
| Response headers to expose (comma-separated) | |
| Preflight cache duration in seconds (default: | |
| Replace all existing CORS rules instead of appending | |
| Clear all CORS rules |
配置存储桶的CORS规则。除非使用或,否则每次调用都会添加一条规则。
--override--resetbash
tigris buckets set-cors my-bucket --origins '*' --methods GET,HEAD
tigris buckets set-cors my-bucket --origins https://example.com --methods GET,POST --headers Content-Type,Authorization --max-age 3600
tigris buckets set-cors my-bucket --origins https://example.com --override
tigris buckets set-cors my-bucket --reset| 参数选项 | 别名 | 描述 |
|---|---|---|
| | 允许的源(逗号分隔,或 |
| | 允许的HTTP方法(逗号分隔) |
| 允许的请求头(逗号分隔,或 | |
| 要暴露的响应头(逗号分隔) | |
| 预检请求缓存时长(秒,默认: | |
| 替换所有现有CORS规则,而非追加 | |
| 清除所有CORS规则 |
Snapshots
快照
Snapshots are point-in-time, read-only copies of a bucket's state. The bucket must be created with .
--enable-snapshots快照是存储桶状态的只读时间点副本。存储桶必须在创建时使用才能启用快照功能。
--enable-snapshotstigris snapshots list <bucket>
(alias: l
)
tigris snapshots list <bucket>ltigris snapshots list <bucket>
(别名:l
)
tigris snapshots list <bucket>lList all snapshots for a bucket, ordered by creation time.
bash
tigris snapshots list my-bucket
tigris snapshots list my-bucket --json| Flag | Description |
|---|---|
| Output format ( |
| Output as JSON |
列出存储桶的所有快照,按创建时间排序。
bash
tigris snapshots list my-bucket
tigris snapshots list my-bucket --json| 参数选项 | 描述 |
|---|---|
| 输出格式( |
| 以JSON格式输出 |
tigris snapshots take <bucket> [name]
(alias: t
)
tigris snapshots take <bucket> [name]ttigris snapshots take <bucket> [name]
(别名:t
)
tigris snapshots take <bucket> [name]tTake a new snapshot of the bucket's current state. Optionally provide a name.
bash
tigris snapshots take my-bucket
tigris snapshots take my-bucket my-snapshot创建存储桶当前状态的新快照。可选择性指定快照名称。
bash
tigris snapshots take my-bucket
tigris snapshots take my-bucket my-snapshotForks
分支
Forks are copy-on-write clones of a bucket. They are instant, free, and isolated — writes to the fork do not affect the source bucket.
分支是存储桶的写时复制克隆。创建即时、免费且相互隔离——对分支的写入操作不会影响源存储桶。
Create a fork
创建分支
bash
undefinedbash
undefinedPreferred: use mk or buckets create with --fork-of
推荐方式:使用mk或buckets create配合--fork-of参数
tigris mk my-fork --fork-of my-bucket
tigris mk my-fork --fork-of my-bucket --source-snapshot 1765889000501544464
tigris mk my-fork --fork-of my-bucket
tigris mk my-fork --fork-of my-bucket --source-snapshot 1765889000501544464
Equivalent via buckets create
等价于使用buckets create命令
tigris buckets create my-fork --fork-of my-bucket
tigris buckets create my-fork --fork-of my-bucket --source-snapshot 1765889000501544464
undefinedtigris buckets create my-fork --fork-of my-bucket
tigris buckets create my-fork --fork-of my-bucket --source-snapshot 1765889000501544464
undefinedList forks
列出分支
bash
tigris buckets list --forks-of my-bucketDeprecated commands:andtigris forks liststill work but are deprecated. Usetigris forks createandtigris buckets list --forks-ofinstead.tigris mk --fork-of
bash
tigris buckets list --forks-of my-bucket已废弃命令:和tigris forks list仍可使用但已废弃。请改用tigris forks create和tigris buckets list --forks-of。tigris mk --fork-of
Reference Tables
参考表格
Storage Tiers
存储层级
| Tier | Value | Description |
|---|---|---|
| Standard | | Default. High durability, availability, and performance for frequently accessed data |
| Infrequent Access | | Lower-cost for data accessed less frequently but requiring rapid access when needed |
| Archive | | Low-cost for long-term data archiving with infrequent access |
| Instant Retrieval Archive | | Lowest-cost for long-lived, rarely accessed data requiring retrieval in milliseconds |
| 层级名称 | 值 | 描述 |
|---|---|---|
| 标准层级 | | 默认层级。针对频繁访问数据提供高持久性、可用性和性能 |
| 低频访问层级 | | 低成本层级,适用于访问频率较低但需要快速访问的数据 |
| 归档层级 | | 低成本层级,适用于长期归档且访问频率极低的数据 |
| 即时检索归档层级 | | 成本最低的层级,适用于长期存储、极少访问但需要毫秒级检索速度的数据 |
Locations
存储位置
| Name | Value | Description |
|---|---|---|
| Global | | Global (default) |
| USA | | Restrict to USA |
| Europe | | Restrict to Europe |
| Amsterdam | | Amsterdam, Netherlands |
| Frankfurt | | Frankfurt, Germany |
| Sao Paulo | | Sao Paulo, Brazil |
| Ashburn | | Ashburn, Virginia (US) |
| Johannesburg | | Johannesburg, South Africa |
| London | | London, United Kingdom |
| Tokyo | | Tokyo, Japan |
| Chicago | | Chicago, Illinois (US) |
| Singapore | | Singapore, Singapore |
| San Jose | | San Jose, California (US) |
| Sydney | | Sydney, Australia |
| 名称 | 值 | 描述 |
|---|---|---|
| 全球 | | 全球范围(默认) |
| 美国 | | 仅限美国区域 |
| 欧洲 | | 仅限欧洲区域 |
| 阿姆斯特丹 | | 荷兰阿姆斯特丹 |
| 法兰克福 | | 德国法兰克福 |
| 圣保罗 | | 巴西圣保罗 |
| 阿什本 | | 美国弗吉尼亚州阿什本 |
| 约翰内斯堡 | | 南非约翰内斯堡 |
| 伦敦 | | 英国伦敦 |
| 东京 | | 日本东京 |
| 芝加哥 | | 美国伊利诺伊州芝加哥 |
| 新加坡 | | 新加坡 |
| 圣何塞 | | 美国加利福尼亚州圣何塞 |
| 悉尼 | | 澳大利亚悉尼 |
Consistency Levels (deprecated — use --locations
instead)
--locations一致性级别(已废弃——请使用--locations
替代)
--locations| Level | Value | Description |
|---|---|---|
| Default | | Strict read-after-write in same region, eventual consistency globally |
| Strict | | Strict read-after-write globally (higher latency) |
| 级别 | 值 | 描述 |
|---|---|---|
| 默认级别 | | 同区域严格读写一致性,全球范围最终一致性 |
| 严格级别 | | 全球范围严格读写一致性(延迟较高) |