tigris-objects

Tigris オブジェクト操作

クイックリファレンス

コマンド	説明
tigris ls [path]	バケット／プレフィックス内のオブジェクトを一覧表示します
tigris cp <src> <dest>	ローカル↔リモート、またはリモート↔リモートでファイルをコピーします
tigris mv <src> <dest>	Tigris 内のオブジェクトを移動／名前変更します
tigris rm <path>	オブジェクトまたはフォルダーを削除します
tigris touch <path>	空のオブジェクトを作成します
tigris stat <path>	オブジェクトのメタデータまたはストレージ統計を表示します
tigris presign <path>	署名付き URL を生成します
tigris objects list <bucket>	オブジェクトを一覧表示します（低レベル）
tigris objects get <bucket> <key>	オブジェクトをダウンロードします（低レベル）
tigris objects put <bucket> <key> <file>	オブジェクトをアップロードします（低レベル）
tigris objects delete <bucket> <key>	オブジェクトを削除します（低レベル）
tigris objects set <bucket> <key>	オブジェクトの設定を更新します（低レベル）

URI スキーム

リモートパスには t3://bucket/key または tigris://bucket/key を使用します。bucket/key のようにスキームを省略したパスも使用できます。

Unix スタイルのコマンド（主なインターフェース）

tigris ls [path]（エイリアス：list）

バケットをすべて一覧表示する（引数なしの場合）か、バケット／プレフィックスパス内のオブジェクトを一覧表示します。

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/

フラグ	エイリアス	説明	デフォルト
--snapshot-version	--snapshot	特定のバケットスナップショットから読み取ります
--format	-f	出力形式（json、table、xml）	table
--json		JSON 形式で出力します

tigris cp <src> <dest>（エイリアス：copy）

ローカルファイルシステムと Tigris の間、または Tigris 内のパス間でファイルをコピーします。少なくとも片方のパスには、リモートの t3:// パスを指定する必要があります。シェルによるワイルドカードの展開を防ぐため、ワイルドカードパターンは引用符で囲んでください。

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

フラグ	エイリアス	説明
--recursive	-r	ディレクトリを再帰的にコピーします
--format	-f	出力形式（json、table。デフォルト：table）
--json		JSON 形式で出力します

tigris mv <src> <dest>（エイリアス：move）

Tigris 内のオブジェクトを移動（名前変更）します。コピー元とコピー先の両方にリモートパスを指定する必要があります。シェルによるワイルドカードの展開を防ぐため、ワイルドカードパターンは引用符で囲んでください。

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

フラグ	エイリアス	説明
--recursive	-r	ディレクトリを再帰的に移動します
--force	-f	確認プロンプトを省略します
--format		出力形式（json、table。デフォルト：table）
--json		JSON 形式で出力します

tigris rm <path>（別名：remove）

Tigris からバケット、フォルダー、またはオブジェクトを削除します。バケット名のみを指定すると、バケット自体が削除されます。シェルによる展開を防ぐため、ワイルドカードパターンは引用符で囲んでください。

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

フラグ	別名	説明
--recursive	-r	ディレクトリを再帰的に削除します
--force	-f	確認プロンプトをスキップします
--format		出力形式（json、table、デフォルト：table）
--json		JSON 形式で出力します

tigris touch <path>

指定したバケット／キーのパスに、空（0 バイト）のオブジェクトを作成します。

tigris touch my-bucket/placeholder.txt
tigris touch t3://my-bucket/logs/

フラグ	別名	説明
--format	-f	出力形式（json、table、デフォルト：table）
--json		JSON 形式で出力します

tigris stat [path]

ストレージ統計情報（引数なし）、バケット情報、またはオブジェクトのメタデータを表示します。

tigris stat                                # overall storage stats
tigris stat t3://my-bucket                 # bucket info
tigris stat t3://my-bucket/my-object.json  # object metadata

フラグ	別名	説明	デフォルト
--snapshot-version	--snapshot	特定のバケットスナップショットから読み取ります
--format	-f	出力形式（json、table、xml）	table
--json		JSON 形式で出力します

署名付き URL

tigris presign <path>

認証情報なしでオブジェクトに一時的にアクセスするための署名付き URL を生成します。

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

フラグ	別名	説明	デフォルト
--method	-m	HTTP メソッド（get、put）	get
--expires-in	-e	URL の有効期限（秒）	3600
--access-key		署名に使用するアクセスキー ID（指定しない場合は認証情報から解決されます）
--format	-f	出力形式（url、json）	url
--json		JSON 形式で出力します

ユースケース：

• 非公開オブジェクトの一時的な共有（GET）
• 認証情報を公開せずにクライアント側からアップロード（PUT）

低レベルの objects サブコマンド

個々のオブジェクトをプログラムから細かく制御するために使用します。

tigris objects list <bucket>（別名：l）

バケット内のオブジェクトを一覧表示します。必要に応じてキーのプレフィックスで絞り込めます。

tigris objects list my-bucket
tigris objects list my-bucket --prefix images/
tigris objects list my-bucket --json

フラグ	別名	説明
--prefix	-p	キーのプレフィックスでオブジェクトを絞り込みます
--snapshot-version	--snapshot	特定のバケットスナップショットから読み取ります
--format	-f	出力形式（json、table、xml、デフォルト：table）
--json		JSON 形式で出力します

tigris objects get <bucket> <key>（エイリアス：g）

キーでオブジェクトをダウンロードします。デフォルトでは標準出力に出力し、--output を指定するとファイルに保存します。

tigris objects get my-bucket config.json
tigris objects get my-bucket archive.zip --output ./archive.zip --mode stream

フラグ	エイリアス	説明
--output	-o	出力ファイルのパス（指定しない場合は標準出力に出力）
--mode	-m	応答モード：string（メモリに読み込み）または stream（チャンク単位で書き込み）
--snapshot-version	--snapshot	特定のバケットスナップショットから読み込み
--format	-f	出力形式（json、table。デフォルト：table）
--json		JSON 形式で出力

tigris objects put <bucket> <key> <file>（エイリアス：p）

ローカルファイルをオブジェクトとしてアップロードします。上書きしない限り、拡張子からコンテンツタイプが自動検出されます。

tigris objects put my-bucket report.pdf ./report.pdf
tigris objects put my-bucket logo.png ./logo.png --access public --content-type image/png

フラグ	エイリアス	説明	デフォルト
--access	-a	アクセスレベル（public、private）	private
--content-type	-t	コンテンツタイプ（省略時は自動検出）
--format	-f	出力形式（json、table、xml）	table
--json		JSON 形式で出力

tigris objects delete <bucket> <key>（エイリアス：d）

キーで 1 つ以上のオブジェクトを削除します。キーはカンマ区切りで指定できます。

tigris objects delete my-bucket old-file.txt --force
tigris objects delete my-bucket file-a.txt,file-b.txt --force

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

tigris objects set <bucket> <key>（エイリアス：s）

アクセスレベルやキー名など、既存のオブジェクトの設定を更新します。

tigris objects set my-bucket my-file.txt --access public
tigris objects set my-bucket my-file.txt --access private

フラグ	エイリアス	説明
--access	-a	アクセスレベル（public、private）— 必須
--new-key	-n	オブジェクトのキーを新しいキー名に変更
--format	-f	出力形式（json、table。デフォルト：table）
--json		JSON 形式で出力

一般的なパターン

# 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