s3cmd - クラウド上のオンライン

プログラム：

NAME

s3cmd - Amazon S3 ストレージスペースと Amazon CloudFront コンテンツ配信を管理するためのツール
ネットワーク

SYNOPSIS

s3cmd [OPTIONS] COMMAND [パラメーター]

DESCRIPTION

s3cmd Amazon S3 (Simple Storage) との間でファイルをコピーするためのコマンドライン クライアントです。
サービス)、その他の関連タスクの実行 (バケットの作成と削除など)、
オブジェクトのリストなど。

コマンド

s3cmd いくつかのことができます 行動 以下で指定される コマンド.

s3cmd mb s3://バケット
バケツを作る

s3cmd rb s3://バケット
バケツを外す

s3cmd ls [s3://バケット[/プレフィックス]]
オブジェクトまたはバケットをリストする

s3cmd la
すべてのバケット内のすべてのオブジェクトをリストする

s3cmd 置きます FILE [ファイル...] s3://バケット[/プレフィックス]
ファイルをバケットに入れる

s3cmd 取得する s3://バケット/オブジェクト LOCAL_FILE
バケットからファイルを取得する

s3cmd インクルード s3://バケット/オブジェクト
バケットからファイルを削除

s3cmd rm s3://バケット/オブジェクト
バケットからファイルを削除します (del のエイリアス)

s3cmd リストア s3://バケット/オブジェクト
Glacier ストレージからファイルを復元する

s3cmd sync LOCAL_DIR s3://バケット[/プレフィックス] or s3://バケット[/プレフィックス] LOCAL_DIR
ディレクトリ ツリーを S3 に同期します (サイズと md5 を使用してファイルの鮮度をチェックします)
チェックサム (オプションで上書きされない限り、以下を参照)

s3cmd du [s3://バケット[/プレフィックス]]
バケット別のディスク使用量

s3cmd info s3://バケット[/オブジェクト]
バケットやファイルに関するさまざまな情報を取得する

s3cmd cp s3://バケット1/オブジェクト1 s3://バケット2[/OBJECT2]
オブジェクトをコピーする

s3cmd 修正する s3://バケット1/オブジェクト
オブジェクトのメタデータを変更する

s3cmd mv s3://バケット1/オブジェクト1 s3://バケット2[/OBJECT2]
オブジェクトの移動

s3cmd セタクル s3://バケット[/オブジェクト]
バケットまたはファイルのアクセス制御リストを変更する

s3cmd ポリシーの設定 FILE s3://バケット
バケットポリシーの変更

s3cmd デルポリシー s3://バケット
バケット削除ポリシー

s3cmd セットコア FILE s3://バケット
バケット CORS を変更する

s3cmd デルコール s3://バケット
バケット CORS の削除

s3cmd 支払人 s3://バケット
バケットリクエスタ支払いポリシーを変更する

s3cmd マルチパート s3://バケット [ID]
マルチパートアップロードを表示

s3cmd 中止する s3://バケット/オブジェクト Id
マルチパートアップロードを中止する

s3cmd リストmp s3://バケット/オブジェクト Id
マルチパートアップロードの一部をリストする

s3cmd アクセスログ s3://バケット
バケットアクセスログの有効化/無効化

s3cmd 符号 署名する文字列
秘密鍵を使用して任意の文字列に署名します

s3cmd 署名URL s3://バケット/オブジェクト
S3 URL に署名して、有効期限付きの制限されたパブリック アクセスを提供します

s3cmd 固定バケット s3://バケット[/プレフィックス]
バケット内の無効なファイル名を修正する

s3cmd 有効期限が切れる s3://バケット
バケットの有効期限ルールを設定または削除する

s3cmd セットライフサイクル FILE s3://バケット
バケットのライフサイクル ポリシーをアップロードする

s3cmd ライフサイクル s3://バケット
バケットのライフサイクル ポリシーを削除する

静的 Web サイト設定用のコマンド

s3cmd ws-create s3://バケット
バケットからウェブサイトを作成

s3cmd ws-削除 s3://バケット
ウェブサイトを削除する

s3cmd ws-情報 s3://バケット
ウェブサイトに関する情報

CloudFront 管理用のコマンド

s3cmd cflist
CloudFront 配布ポイントをリストする

s3cmd cfinfo [cf://DIST_ID]
CloudFront 配布ポイントパラメータを表示する

s3cmd cfcreate s3://バケット
CloudFront 配布ポイントを作成する

s3cmd cfdelete cf://DIST_ID
CloudFront 配布ポイントを削除する

s3cmd cfmodify cf://DIST_ID
CloudFront 配布ポイントのパラメータを変更する

s3cmd cfinvalinfo cf://DIST_ID[/INVAL_ID]
CloudFront 無効化リクエストのステータスを表示する

OPTIONS

以下に指定されたオプションの一部は、デフォルト値を設定できます。 s3cmd 設定ファイル
(デフォルトでは $HOME/.s3cmd)。 シンプルなテキストファイルなので、自由に開いてください。
お気に入りのテキスト エディターを選択し、必要に応じて変更を加えます。

-h, - 助けて
このヘルプメッセージを表示して終了します

- 構成、設定
対話型 (再) 構成ツールを起動します。 必要に応じて「」として使用します- 構成、設定
s3://some-bucket' は、リストを試行する代わりに、特定のバケットへのアクセスをテストします。
モール。

-c ファイル、 --config=ファイル
設定ファイル名。 デフォルトは $HOME/.s3cfg

--ダンプ構成
設定ファイルとコマンドラインオプションを解析した後、現在の設定をダンプし、
出口。

- アクセスキー=アクセス_キー
AWS アクセスキー

--secret_key=SECRET_KEY
AWS 秘密キー

-n, -ドライラン
アップロードまたはダウンロードする必要があるもののみを示しますが、実際にはアップロードまたはダウンロードしません。 XNUMX月はまだ
ただし、S3 リクエストを実行してバケット リストやその他の情報を取得します（
ファイル転送コマンド)

-s, --ssl
S3 と通信する場合は HTTPS 接続を使用します。 （デフォルト）

--sslなし
HTTPS は使用しないでください。

-e, -暗号化
S3 にアップロードする前にファイルを暗号化します。

--no-暗号化なし
ファイルを暗号化しないでください。

-f, - 力
上書きやその他の危険な操作を強制します。

- 継続する
部分的にダウンロードされたファイルの取得を続行します ([get] コマンドの場合のみ)。

--Continue-put
部分的にアップロードされたファイルまたはマルチパート アップロード パーツのアップロードを続行します。
サイズと md5 が一致しないファイルを再起動または分割します。 ファイル/パーツをスキップします。
する。 注: md5sum チェックは、ファイル (部分) の同等性をチェックするには必ずしも十分ではありません。
これを有効にする場合は、ご自身の責任で行ってください。

--アップロード ID=アップロード_ID
マルチパート アップロードの UploadId (既存のアップロードを続行する場合)
（に相当します - 続く- put) と複数の部分アップロードがあります。 s3cmdを使用する
multipart [URI] を使用して、指定された URI に関連付けられている UploadId を確認します。

-スキップ-既存
コピー先に存在するファイルをスキップします（[get]コマンドと[sync]コマンドのみ）。

-r, -再帰的
再帰的なアップロード、ダウンロード、または削除。

--check-md5
[同期] のファイルを比較するときに MD5 サムを確認します。 （デフォルト）

--no-check-md5
[同期] のファイルを比較するときに MD5 サムをチェックしません。 サイズのみの比較となります。
転送速度が大幅に向上しますが、変更されたファイルの一部が失われる可能性もあります。

-P, --acl-パブリック
誰でも読み取りできる ACL を使用してオブジェクトを保存します。

--acl-プライベート
自分だけにアクセスを許可するデフォルト ACL を使用してオブジェクトを保存します。

--acl-grant=PERMISSION:EMAIL または USER_CANONICAL_ID
指定された Amazon ユーザーに所定のアクセス許可を付与します。 権限は、読み取り、書き込み、
read_acp、write_acp、full_control、すべて

--acl-取り消し=PERMISSION:USER_CANONICAL_ID
特定の Amazon ユーザーに対して指定された許可を取り消します。 権限は次のいずれかです: 読み取り、
書き込み、読み取り_acp、書き込み_acp、フル_コントロール、すべて

-D NUM、 --復元日数=NUM
復元されたファイルを利用可能な状態に保つ日数 (「restore」コマンドの場合のみ)。

--削除-削除済み
対応するローカル ファイルのないリモート オブジェクトを削除する [同期]

--no-delete-削除済み
リモートオブジェクトを削除しないでください。

-- 削除後
新しいアップロード後に削除を実行する [同期]

--遅延更新
*廃止* すべての更新されたファイルを最後に所定の位置に配置します [同期]

--最大削除=NUM
NUM 個を超えるファイルを削除しないでください。 [削除] と [同期]

-追加-宛先=ADDITIONAL_DESTINATIONS
最後の引数に加えて、並列アップロードの追加の宛先。 多分
繰り返された。

--フェッチ後の削除
ローカル ファイルにフェッチした後にリモート オブジェクトを削除します ([get] と [sync] のみ)
コマンド)。

-p, - 保存
ファイルシステム属性 (モード、所有権、タイムスタンプ) を保持します。 [同期]のデフォルト


-- 保存なし
FS 属性を保存しない

-除外する=グロブ
GLOB に一致するファイル名とパスは同期から除外されます

-除外-から=ファイル
ファイルから --exclude GLOB を読み取ります

--除外=正規表現
REGEXP (正規表現) に一致するファイル名とパスは同期から除外されます

--reclude-from=ファイル
ファイルから --reexclude REGEXP を読み取ります

- 含む=グロブ
GLOB に一致するファイル名とパスは、以前に除外されていた場合でも含まれます。
一つ --(r)除外(-from) パターン

--include-from=ファイル
ファイルから --include GLOB を読み取ります

--rininclude=正規表現
--include と同じですが、GLOB の代わりに REGEXP (正規表現) を使用します。

--rininclude-from=ファイル
ファイルから --rinclude REGEXP を読み取ります

--files-from=ファイル
FILE からソースファイル名のリストを読み取ります。 標準入力から読み取るには - を使用します。

- 領域=地域、 --バケットの場所=地域
バケットを作成するリージョン。現時点でのリージョンは、us-east-1、us-west-1、
us-west-2、eu-west-1、eu-central-1、ap-northeast-1、ap-southeast-1、ap-
南東-2、南東-1

- ホスト=ホスト名
S3 エンドポイントの HOSTNAME:PORT (デフォルト: s3.amazonaws.com、代替案など)
s3-eu-west-1.amazonaws.com)。 も設定する必要があります - ホスト- バケツ。

--ホストバケット=HOST_BUCKET
バケットにアクセスするための DNS スタイルのバケット+ホスト名:ポート テンプレート (デフォルト:
%(バケット)s.s3.amazonaws.com)

--冗長性の削減, --rr
「冗長性を削減」してオブジェクトを保存します。 GB あたりの価格が安くなります。 [プット、cp、mv]

--削減された冗長性なし, --no-rr
「冗長性を削減」せずにオブジェクトを保存します。 GB あたりの価格が高くなります。 [プット、cp、mv]

--ストレージクラス=クラス
指定された CLASS (STANDARD、STANDARD_IA、または REDUCED_REDUNDANCY) のオブジェクトを保管します。
GB あたりの価格が安くなります。 [プット、cp、mv]

--access-logging-target-prefix=LOG_TARGET_PREFIX
アクセス ログのターゲット プレフィックス (S3 URI) ([cfmodify] および [accesslog] コマンドの場合)

--アクセスログなし
アクセスログを無効にする ([cfmodify] および [accesslog] コマンドの場合)

--デフォルトのMIMEタイプ=DEFAULT_MIME_TYPE
保存されたオブジェクトのデフォルトの MIME タイプ。 アプリケーションのデフォルトはバイナリ/オクテットストリームです。

-M, --mime タイプを推測する
拡張子または MIME マジックによってファイルの MIME タイプを推測します。 デフォルトに戻す
指定された MIME タイプ --デフォルトのMIMEタイプ オプション

--no-guess-mime-type
MIME タイプを推測せず、代わりにデフォルトのタイプを使用してください。

--パントマイムマジックなし
MIME タイプを推測するときに MIME マジックを使用しないでください。

-m MIME/タイプ、 --mime タイプ=MIME/タイプ
MIME タイプを強制します。 両方をオーバーライドする --デフォルトのMIMEタイプ と --mime タイプを推測する.

--ヘッダーの追加=名前:値
指定された HTTP ヘッダーをアップロード要求に追加します。 複数回使用できます。 ために
インスタンスは、このオプションを使用して「Expires」または「Cache-Control」ヘッダー (あるいはその両方) を設定します。

-- ヘッダーの削除=名前
指定された HTTP ヘッダーを削除します。 複数回使用できます。 たとえば、削除します
このオプションを使用すると、「Expires」ヘッダーまたは「Cache-Control」ヘッダー (またはその両方) が使用されます。 [変更]

-- サーバー側の暗号化
オブジェクトを配置するときにサーバー側の暗号化が使用されることを指定します。 [置く、
同期、CP、変更]

--サーバー側の暗号化kms-id=KMS_KEY
AWS KMS 管理キーによるサーバー側の暗号化に使用されるキー ID を指定します。
(SSE-KMS) オブジェクトを配置するとき。 [配置、同期、CP、変更]

- エンコーディング=エンコーディング
自動検出された端末とファイルシステムのエンコーディング (文字セット) をオーバーライドします。
自動検出: UTF-8

--add-encoding-exts=拡張子
アップロード時にこれらのカンマ区切りの拡張子 (css、js、html) にエンコーディングを追加します。
S3まで）

--逐語的
コマンドラインで指定された S3 名を使用します。 前処理やエンコードなどは必要ありません。
注意して使用してください！

--マルチパートを無効にする
次のサイズより大きいファイルのマルチパート アップロードを無効にする --multipart-chunk-size-mb

--multipart-chunk-size-mb=サイズ
マルチパートアップロードの各チャンクのサイズ。 SIZE より大きいファイルは自動的に
マルチスレッドとしてアップロード - マルチパートの小さいファイルは、
伝統的な手法。 SIZE はメガバイト単位で、デフォルトのチャンク サイズは最小 15MB です。
許可されるチャンク サイズは 5MB、最大は 5GB です。

--list-md5
バケット リストに MD5 合計を含めます (「ls」コマンドの場合のみ)。

-H, --人間が読めるサイズ
人間が判読できる形式でサイズを出力します (例: 1 ではなく 1234kB)。

--ws-インデックス=WEBSITE_INDEX
インデックスドキュメント名([ws-create]コマンドのみ)

--ws-エラー=WEBSITE_ERROR
エラードキュメント名([ws-create]コマンドのみ)

- 有効期限=EXPIRY_DATE
有効期限ルールがいつ有効になるかを示します。 ([expire]コマンドのみ)

--有効期限日=EXPIRY_DAYS
オブジェクト作成後の有効期限ルールが適用されるまでの日数を示します。
効果。 ([expire]コマンドのみ)

--有効期限プレフィックス=EXPIRY_PREFIX
有効期限ルールが適用されるプレフィックスを持つ XNUMX つ以上のオブジェクトを識別する
が適用されます。 ([expire]コマンドのみ)

- 進捗
進行状況メーターを表示します (TTY のデフォルト)。

-進行なし
進行状況メーターを表示しません (非 TTY のデフォルト)。

-統計
ファイル転送の統計情報をいくつか示します。

- 有効
指定された CloudFront ディストリビューションを有効にする ([cfmodify] コマンドのみ)

-無効にする
指定された CloudFront ディストリビューションを有効にする ([cfmodify] コマンドのみ)

--cf-無効化
CloudFront にアップロードされたファイルを無効にします。 [cfinval] コマンドも参照してください。

--cf-invalidate-デフォルトインデックス
Custom Origin および S3 静的 Web サイトを使用する場合は、デフォルトのインデックス ファイルを無効にします。

--cf-no-invalidate-default-index-root
カスタムオリジンと S3 静的 Web サイトを使用する場合は、へのパスを無効にしないでください。
デフォルトのインデックスファイル。

--cf-追加-cname=CNAME
指定された CNAME を CloudFront ディストリビューションに追加します ([cfcreate] および [cfmodify] のみ)
コマンド)

--cf-削除-cname=CNAME
CloudFront ディストリビューションから指定された CNAME を削除します ([cfmodify] コマンドのみ)

--cf-コメント=コメント
特定の CloudFront ディストリビューションに COMMENT を設定します ([cfcreate] および [cfmodify] のみ)
コマンド)

--cf-デフォルトのルートオブジェクト=DEFAULT_ROOT_OBJECT
URL にオブジェクトが指定されていない場合に返されるデフォルトのルート オブジェクトを設定します。 使う
相対パス、つまり /default/index.html の代わりに default/index.html または
s3://bucket/default/index.html ([cfcreate] および [cfmodify] コマンドのみ)

-v, -詳細
詳細出力を有効にします。

-d, - デバッグ
デバッグ出力を有効にします。

- バージョン
s3cmd バージョン (1.6.1) を表示して終了します。

-F, -フォロー-シンボリックリンク
通常のファイルであるかのようにシンボリック リンクをたどります

-キャッシュファイル=ファイル
ローカル ソース MD5 値を含むキャッシュ ファイル

-q, - 静かな
標準出力での出力をサイレントにする

--ca-certs=CA_CERTS_FILE
SSL CA 証明書ファイルへのパス (システムのデフォルトではない)

--証明書の確認
SSL証明書の有効性を確認する

--ノーチェック証明書
SSL証明書の有効性をチェックしない

--チェックホスト名
SSL 証明書のホスト名の有効性を確認する

--no-check-ホスト名
SSL 証明書のホスト名の有効性をチェックしない

--署名-v2
新しい署名方法の代わりに AWS 署名バージョン 2 を使用してください。 S3 のようなものに役立ちます
AWS Signature v4 がまだないシステム。

-制限レート=制限する
アップロードまたはダウンロードの速度を XNUMX 秒あたりのバイト数に制限します。 金額は次のとおりです
バイト、接尾辞 k を付けたキロバイト、または接尾辞 m を付けたメガバイトで表されます。

--リクエスタ-支払い
操作に対して REQUESTER PAYS フラグを設定する

-l, --長期リスト入り
長いリストを作成する [ls]

--エラー時に停止
転送エラーの場合は停止

--コンテンツの性質=CONTENT_DISPOSITION
署名付き URL の Content-Disposition を指定します (例: "inline; filename=myvideo.mp4")。

--コンテンツタイプ=コンテンツタイプ
署名付き URL の Content-Type を指定します (「video/mp4」など)。

例

最も強力なコマンドの XNUMX つ s3cmd is s3cmd sync 完全な同期に使用されます
リモート S3 ストレージとの間でディレクトリ ツリーをやり取りします。 ある程度 s3cmd 置きます と s3cmd 取得する シェア
～と同様の行動 sync.

バックアップ シナリオで一般的な基本的な使用法は次のように簡単です。
s3cmd 同期 /local/path/ s3://test-bucket/backup/

このコマンドは、/local/path ディレクトリの下にあるすべてのファイルを検索し、それらを次の場所にコピーします。
リモート側の s3://test-bucket/backup にある対応するパス。 例えば：
/ローカル/パス/ファイル1.ext -> s3://バケット/バックアップ/ファイル1.ext
/ローカル/パス/dir123/file2.bin -> s3://バケット/バックアップ/dir123/file2.bin

ただし、ローカル パスがスラッシュで終わらない場合は、最後のディレクトリの名前が使用されます。
リモート側も同様です。 これらを前の例と比較してください。
s3cmd 同期 /local/path s3://test-bucket/backup/
同期します:
/地元/パス/file1.ext -> s3://バケット/バックアップ/パス/file1.ext
/地元/パス/dir123/file2.bin -> s3://バケット/バックアップ/パス/dir123/file2.bin

S3 からファイルを取得するには、反転構文を使用します。
s3cmd 同期 s3://test-bucket/backup/ ~/復元/
ファイルをダウンロードします:
s3://バケット/バックアップ/ファイル1.ext -> ~/復元/ファイル1.ext
s3://バケット/バックアップ/dir123/file2.bin -> ~/復元/dir123/file2.bin

ソースの末尾にスラッシュがない場合、動作は以前と同様になります。
アップロードで実証:
s3cmd 同期 s3://test-bucket/backup ~/復元/
ファイルは次のようにダウンロードされます。
s3://バケット/バックアップ/file1.ext -> ~/復元/バックアップ/file1.ext
s3://バケット/バックアップ/dir123/file2.bin -> ~/復元/バックアップ/dir123/file2.bin

すべてのソース ファイル名 (上記の太字のもの) は、 除外する ルールとそれら
その後、その一致が再チェックされます include ルールがそうすべきかどうかを確認するためのルール
除外されるか、ソースリストに保持されます。

ために -除外する と - 含む 上記の太字のファイル名のみに一致するものは、
使用済み。 ほんの一例ですが パス/file1.ext パターンに対してテストされるのではなく、
/地元/パス/file1.ext

両方 -除外する と - 含む シェルスタイルのワイルドカード (別名 GLOB) を使用します。 より大きなもののために
柔軟性 s3cmd は、次の名前の XNUMX つの除外オプションの正規表現バージョンを提供します。
--除外 と --rininclude。 オプションは...-から サフィックス (例: --rinclude-from)
ファイル名を引数として指定します。 このようなファイルの各行は XNUMX つのパターンとして扱われます。

すべてから構築されたパターンのセットは XNUMX つだけです --(r)除外(-from) オプションなど
インクルードバリアントの場合。 --exclude などで除外されたファイルは、パターンを使用して元に戻すことができます
--rininclude-from リストにあります。

s3cmdを実行します -ドライラン ルールが期待どおりに機能することを確認します。 と併用してください
- デバッグ 除外および包含に対するファイル名の一致に関する詳細情報を取得する
ルール。

たとえば、「.jpg」loading="lazy" 拡張子を持つすべてのファイルを除外します。
番号の使用:

--exclude '*.jpg' --rininclude '[0-9].*.jpg'

「*.jpg」loading="lazy" 拡張子を除くすべてのファイルを除外するには、次を使用します。

--「*」を除外します --「*.jpg」を含めます

ローカル ディレクトリ 'somedir' を除外するには、次のように末尾にスラッシュを必ず使用してください。

--「somedir/」を除外します

onworks.net サービスを使用してオンラインで s3cmd を使用する