tigris-buckets

Tigris バケット管理

クイックリファレンス

コマンド	説明
tigris mk <name>	バケットを作成します（末尾に / を付けるとフォルダーを作成します）
tigris buckets list	すべてのバケットを一覧表示します
tigris buckets get <name>	バケットの詳細を確認します
tigris buckets delete <name>	バケットを削除します
tigris buckets set <name>	バケットの設定を更新します
tigris buckets set-ttl <name>	オブジェクトの有効期限を設定します
tigris buckets set-locations <name>	データの保存場所を設定します
tigris buckets set-migration <name>	シャドウバケットの移行を設定します
tigris buckets set-transition <name>	ストレージクラスの移行を設定します
tigris buckets set-notifications <name>	イベントの Webhook を設定します
tigris buckets set-cors <name>	CORS ルールを設定します
tigris snapshots list <bucket>	バケットのスナップショットを一覧表示します
tigris snapshots take <bucket>	スナップショットを取得します

バケットを作成する

tigris mk <path>（エイリアス：create）

バケット（末尾に / を付けない名前）またはバケット内のフォルダー（末尾に / を付ける）を作成します。t3:// および tigris:// URI プレフィックスに対応しています。

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

tigris buckets create <name>（エイリアス：c）

buckets サブコマンドの下で実行する点を除き、mk と同じです。

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

フラグ：

フラグ	エイリアス	説明	デフォルト
--access	-a	アクセスレベル（public、private）	private
--public		--access public の短縮形
--locations	-l	バケットの保存場所（保存場所を参照）	global
--default-tier	-t	デフォルトのストレージ階層（ストレージ階層を参照）	STANDARD
--enable-snapshots	-s	バケットのスナップショットを有効にします	false
--fork-of	--fork	指定したソースバケットのフォーク（コピーオンライトのクローン）として作成します
--source-snapshot	--source-snap	特定のスナップショットからフォークします（--fork-of が必要です）
--format	-f	出力形式（json、table）	table
--json		JSON 形式で出力します
--consistency	-c	（非推奨） 代わりに --locations を使用してください
--region	-r	（非推奨） 代わりに --locations を使用してください

バケットを一覧表示する

tigris buckets list（エイリアス：l）

現在の組織にあるすべてのバケットを一覧表示します。

tigris buckets list
tigris buckets list --json
tigris buckets list --forks-of my-bucket

フラグ	説明
--forks-of	指定したソースバケットのフォークであるバケットのみを一覧表示します
--format / -f	出力形式（json、table、xml。デフォルト：table）
--json	JSON 形式で出力します

バケットを確認する

tigris buckets get <name>（別名：g）

アクセスレベル、リージョン、ティア、カスタムドメインなど、バケットの詳細を表示します。

tigris buckets get my-bucket
tigris buckets get my-bucket --json

フラグ	説明
--format / -f	出力形式（json、table、xml。デフォルト：table）
--json	JSON 形式で出力

バケットを削除する

tigris buckets delete <name>（別名：d）

名前を指定して、1 つ以上のバケットを削除します。カンマ区切りの名前を指定できます。

tigris buckets delete my-bucket --force
tigris buckets delete bucket-a,bucket-b --force

フラグ	説明
--force	確認プロンプトをスキップする
--format / -f	出力形式（json、table。デフォルト：table）
--json	JSON 形式で出力

バケット設定を更新する

tigris buckets set <name>（別名：s）

既存のバケットの設定を更新します。

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

フラグ	説明
--access	バケットのアクセスレベル（public、private）
--locations	バケットのロケーション（ロケーションを参照）
--enable-delete-protection	削除保護を有効にする（true/false）
--cache-control	デフォルトの cache-control ヘッダー値
--custom-domain	バケットのカスタムドメイン
--allow-object-acl	オブジェクトレベルの ACL を有効にする（true/false）
--disable-directory-listing	ディレクトリ一覧表示を無効にする（true/false）
--enable-additional-headers	X-Content-Type-Options: nosniff などの追加 HTTP ヘッダーを有効にする（true/false）
--region	（非推奨） 代わりに --locations を使用してください
--format	出力形式（json、table。デフォルト：table）
--json	JSON 形式で出力

バケット設定コマンド

tigris buckets set-ttl <name>

バケット内のオブジェクトの有効期限（TTL）を設定します。

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

フラグ	別名	説明
--days	-d	指定した日数後にオブジェクトを期限切れにする
--date		指定した日付にオブジェクトを期限切れにする（ISO-8601、例：2026-06-01）
--enable		TTL を有効にする（既存のライフサイクルルールを使用）
--disable		バケットの TTL を無効にする

tigris buckets set-locations <name>

バケットのデータロケーションを設定します。

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

フラグ	別名	説明
--locations	-l	バケットのロケーション（複数指定可、カンマ区切り。ロケーションを参照）

tigris buckets set-migration <name>

外部の S3 互換ソースバケットからのデータ移行を設定します。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...

# Enable write-through (writes go to both source and 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

# Disable migration
tigris buckets set-migration my-bucket --disable

移行ワークフロー： 既存の S3 互換バケットを Tigris に指定します。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 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

フラグ	別名	説明
--storage-class	-s	移行先のストレージクラス（STANDARD_IA、GLACIER、GLACIER_IR）
--days	-d	指定した日数の経過後にオブジェクトを移行する
--date		この日付にオブジェクトを移行する（ISO-8601）
--enable		ライフサイクル移行ルールを有効にする
--disable		ライフサイクル移行ルールを無効にする

tigris buckets set-notifications <name>

オブジェクトイベント通知を設定します。オブジェクトが作成、更新、または削除されたときに、URL へ Webhook リクエストを送信します。

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

フラグ	別名	説明
--url	-u	Webhook URL（http または https が必要）
--filter	-f	キーでイベントを絞り込む SQL WHERE 句
--token	-t	Webhook 認証用のトークン
--username		基本 Webhook 認証用のユーザー名
--password		基本 Webhook 認証用のパスワード
--enable		通知を有効にする（既存の設定を使用）
--disable		通知を無効にする（既存の設定を保持）
--reset		すべての通知設定をクリアする

tigris buckets set-cors <name>

バケットに CORS ルールを設定します。--override または --reset を使用しない場合、呼び出すたびにルールが追加されます。

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

フラグ	エイリアス	説明
--origins	-o	許可するオリジン（カンマ区切り、またはすべてを許可する場合は *）
--methods	-m	許可する HTTP メソッド（カンマ区切り）
--headers		許可するリクエストヘッダー（カンマ区切り、または *）
--expose-headers		公開するレスポンスヘッダー（カンマ区切り）
--max-age		プリフライトキャッシュの期間（秒単位、デフォルト：3600）
--override		既存のすべての CORS ルールを置き換え、追加しない
--reset		すべての CORS ルールをクリアする

スナップショット

スナップショットは、バケットの状態を特定時点で読み取り専用にコピーしたものです。バケットは --enable-snapshots を指定して作成する必要があります。

tigris snapshots list <bucket>（エイリアス：l）

バケットのすべてのスナップショットを作成時刻順に一覧表示します。

tigris snapshots list my-bucket
tigris snapshots list my-bucket --json

フラグ	説明
--format / -f	出力形式（json、table、xml。デフォルト：table）
--json	JSON 形式で出力する

tigris snapshots take <bucket> [name]（エイリアス：t）

バケットの現在の状態の新しいスナップショットを作成します。名前を指定することもできます。

tigris snapshots take my-bucket
tigris snapshots take my-bucket my-snapshot

フォーク

フォークは、コピーオンライト方式で作成されるバケットのクローンです。即座に作成でき、無料で、独立しています。フォークへの書き込みは、ソースバケットに影響しません。

フォークを作成する

# Preferred: use mk or buckets create with --fork-of
tigris mk my-fork --fork-of my-bucket
tigris mk my-fork --fork-of my-bucket --source-snapshot 1765889000501544464

# Equivalent via buckets create
tigris buckets create my-fork --fork-of my-bucket
tigris buckets create my-fork --fork-of my-bucket --source-snapshot 1765889000501544464

フォークを一覧表示する

tigris buckets list --forks-of my-bucket

非推奨のコマンド： tigris forks list と tigris forks create は引き続き動作しますが、非推奨です。代わりに tigris buckets list --forks-of と tigris mk --fork-of を使用してください。

リファレンステーブル

ストレージ階層

階層	値	説明
スタンダード	STANDARD	デフォルト。頻繁にアクセスされるデータ向けの、高い耐久性、可用性、パフォーマンスを提供します
低頻度アクセス	STANDARD_IA	アクセス頻度は低いものの、必要なときに迅速なアクセスが求められるデータ向けの低コスト階層
アーカイブ	GLACIER	アクセス頻度の低い長期データ保管向けの低コスト階層
即時取得アーカイブ	GLACIER_IR	長期保管され、アクセス頻度が低く、ミリ秒単位での取得が必要なデータ向けの最も低コストな階層

ロケーション

名前	値	説明
グローバル	global	グローバル（デフォルト）
米国	usa	米国に限定
ヨーロッパ	eur	ヨーロッパに限定
アムステルダム	ams	オランダ、アムステルダム
フランクフルト	fra	ドイツ、フランクフルト
サンパウロ	gru	ブラジル、サンパウロ
アッシュバーン	iad	米国、バージニア州アッシュバーン
ヨハネスブルグ	jnb	南アフリカ、ヨハネスブルグ
ロンドン	lhr	英国、ロンドン
東京	nrt	日本、東京
シカゴ	ord	米国、イリノイ州シカゴ
シンガポール	sin	シンガポール
サンノゼ	sjc	米国、カリフォルニア州サンノゼ
シドニー	syd	オーストラリア、シドニー

整合性レベル（非推奨 — 代わりに --locations を使用してください）

レベル	値	説明
デフォルト	default	同一リージョン内では厳密な読み取り後書き込み、グローバルでは結果整合性
厳密	strict	グローバルで厳密な読み取り後書き込み（レイテンシが高くなります）