s3cmd --help 日本語訳

業務で必要になったため、自分用に訳します。
s3cmdすら今更感がありますが、**version 1.5.2準拠です**（最新は2.0.2のよう）。
この内容で日本語訳を作っておきたいと思うレベルの英語力なので、なにか間違いがあればご指摘いただけると大変助かります。

## 前文

s3cmdは、Amazon S3ストレージ内のオブジェクトを管理するためのツールです。 「バケット」の作成と削除、そしてこれらのバケットの「オブジェクト」のアップロード、ダウンロード、削除を可能にします。

## オプション
### -h, --help

ヘルプを表示します。

### --configure

対話型（再）設定ツールを起動します。 オプションで `--configure s3://some-bucket`を使用すると特定のバケットへのアクセスをテストします。

### -c FILE, --config=FILE

設定をファイルから読み込みます。デフォルトのファイルパスは`$HOME/.s3cfg`です。

### --dump-config

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

### --access_key=ACCESS_KEY

AWSのアクセスキーを指定します。

### --secret_key=SECRET_KEY

AWSのシークレットキーを指定します。

### -n, --dry-run

アップロードまたはダウンロードする必要があるものだけを表示し、実際には実行しません。 バケットリストやその他の情報を取得するためにS3リクエストを実行する可能性があります（ファイル転送コマンドのみ）。

### -s, --ssl

S3との通信にHTTPS接続を利用します。

### --no-ssl

HTTPSを利用しません。（※デフォルト）

### -e, --encrypt

S3へのアップロード前にファイルを暗号化します。

### --no-encrypt

ファイルを暗号化しません。

### -f, --force

上書きやその他の危険な操作を強制実行します。

### --continue

[get](#バケットからファイルをダウンロードする)コマンド使用時、部分的にダウンロードされたファイルの取得を続行します（の場合のみ）。

### --continue-put

部分的にアップロードされたファイルまたはマルチパートアップロード内パートのアップロードを続行します。 サイズとmd5が一致しないファイル/パートを再起動し、スキップします。

 注：MD5チェックサムは、ファイルの等価性を（部分的に）チェックするために必ずしも十分ではありません。 ご自身の責任でこれを有効にしてください。

### --upload-id=UPLOAD_ID

--continue-putと同様に既存のアップロードを続けたい場合や、複数の部分的なアップロードがある場合は、マルチパートアップロードのUPLOAD_IDを設定します。`s3cmd multipart [URI]`を使用して`、指定されたURIにどのUPLOAD_IDが関連付けられているかを確認します。

### --skip-existing

[get](#バケットからファイルをダウンロードする)および[sync](#ディレクトリツリーをS3と同期する)コマンド使用時、転送先に存在するファイルをスキップします。

### -r, --recursive

再帰的アップロード、ダウンロード、削除を実行します。

### --check-md5

[sync](#ディレクトリツリーをS3と同期する)コマンドでファイルを比較する際にMD5チェックサムを確認します。（※デフォルト）

### --no-check-md5

[sync](#ディレクトリツリーをS3と同期する)コマンドでファイルを比較する際にMD5チェックサムを確認せず、ファイルサイズのみで比較します。転送速度が大幅に向上する可能性がありますが、変更されたファイルを見逃すこともあります。

### -P, --acl-public

だれでも読み取り可能になるようにACLを付与してオブジェクトを保存します。

### --acl-private

あなただけがアクセスを許可されているデフォルトのACLを付与してオブジェクトを保存します。

### --acl-grant=PERMISSION:EMAIL or USER_CANONICAL_ID

指定のamazonユーザーに権限を与えます。パーミッションは`read, write, read_acp, write_acp, full_control, all`のいずれかです。

### --acl-revoke=PERMISSION:USER_CANONICAL_ID

指定のamazonユーザーに与えられた権限を取り消します。パーミッションは`read, write, read_acp, write_acp, full_control, all`のいずれかです。

### -D NUM, --restore-days=NUM

[restore](#アーカイブからファイルを復元する)コマンド使用時、復元されたファイルを利用可能に保つ日数を指定します。

### --delete-removed

[sync](#ディレクトリツリーをS3と同期する)コマンド使用時、対応するローカルファイルがないリモートオブジェクトを削除します。

### --no-delete-removed

リモートオブジェクトを削除しません。

### --delete-after

[sync](#ディレクトリツリーをS3と同期する)コマンド使用時、新規アップロード後に削除を実行します。

### --delay-updates

[sync](#ディレクトリツリーをS3と同期する)コマンド使用時、更新されたすべてのファイルを最後に配置します。

### --max-delete=NUM

[del](#バケットからファイルを削除する)および[sync](#ディレクトリツリーをS3と同期する)コマンド使用時、指定の数値NUMを超える数のファイルを削除しません。

### --add-destination=ADDITIONAL_DESTINATIONS

最後の引数に加えて、並列アップロード用の追加の転送先を指定します。 繰り返す可能性があります。

### --delete-after-fetch

[get](#バケットからファイルをダウンロードする)および[sync](#ディレクトリツリーをS3と同期する)コマンド使用時、ローカルファイルにフェッチした後にリモートオブジェクトを削除します。

### -p, --preserve 

ファイルシステムの属性（モード、所有権、タイムスタンプ）を保持します。 [sync](#ディレクトリツリーをS3と同期する)コマンドのデフォルトです。

### --no-preserve

ファイルシステムの属性を保持しません。

### --exclude=GLOB

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

### --exclude-from=FILE

`--exclude`のGLOBをファイルから読み込みます。

### --rexclude=REGEXP

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

### --rexclude-from=FILE

`--rexclude`のREGEXPをファイルから読み込みます。

### --include=GLOB

以前に`--(r)exclude(-from)`パターンの1つによって除外されていたとしても、GLOBに一致するファイル名とパスが同期に含まれます。

### --include-from=FILE

`--include`のGLOBをファイルから読み込みます。

### --rinclude=REGEXP

`--include`と同じですが、GLOBの代わりにREGEXP（正規表現）を使用します。

### --rinclude-from=FILE

`--rinclude`のREGEXPをファイルから読み込みます。

### --ignore-failed-copy

キーが見つからず失敗した場合でも、終了しません。

### --files-from=FILE

FILEからソースファイル名のリストを読みます。 標準入力から読み込むには `-` を使用してください。

### --region=REGION, --bucket-location=REGION

バケットを作成するリージョンを指定します。

### --reduced-redundancy, --rr

[put](#バケットにファイルをアップロードする)、[cp](#バケット間でオブジェクトをコピーする)、[mv](#バケット間でオブジェクトを移動する)コマンド使用時、'低冗長化' でオブジェクトを保存します。GBあたりの価格が下がります。

### --no-reduced-redundancy, --no-rr

[put](#バケットにファイルをアップロードする)、[cp](#バケット間でオブジェクトをコピーする)、[mv](#バケット間でオブジェクトを移動する)コマンド使用時、'低冗長化' せずにオブジェクトを保存します。GBあたりの価格が高くなります。

### --access-logging-target-prefix=LOG_TARGET_PREFIX

[cfmodify](#CloudFrontディストリビューションのパラメータを変更する)および[accesslog](#バケットのアクセスログ出力を有効化または無効化する)コマンド使用時、アクセスログのターゲットプレフィックス（S3 URI）を指定します。

### --no-access-logging

[cfmodify](#CloudFrontディストリビューションのパラメータを変更する)および[accesslog](#バケットのアクセスログ出力を有効化または無効化する)コマンド使用時、アクセスログ出力を無効にします。

### --default-mime-type=DEFAULT_MIME_TYPE

格納されているオブジェクトのデフォルトのMIMEタイプを指定します。 アプリケーションのデフォルトはbinary/octet-streamです。

### -M, --guess-mime-type

拡張子またはMIME magicでファイルのMIMEタイプを推測します。 `-default-mime-type`オプションで指定されているデフォルトのMIMEタイプにフォールバックします。

### --no-guess-mime-type

MIMEタイプを推測せず、代わりにデフォルトのタイプを使用します。

### --no-mime-magic

MIMEタイプを推測するときに、mime magicを使用しません。

### -m MIME/TYPE, --mime-type=MIME/TYPE

MIMEタイプを強制します。 `--default-mime-type`と`--guess-mime-type`の両方をオーバーライドします。

### --add-header=NAME:VALUE

アップロード要求に指定されたHTTPヘッダーを追加します。 複数回使用できます。 例えば、このオプションを使用して 'Expires'または 'Cache-Control'ヘッダー（あるいはその両方）を設定します。

### --remove-header=NAME

[modify](#オブジェクトのメタデータを変更する)コマンド使用時、指定されたHTTPヘッダを削除します。 複数回使用できます。 たとえば、このオプションを使用して 'Expires 'または 'Cache-Control 'ヘッダー（あるいはその両方）を削除します。 

### --server-side-encryption

[put](#バケットにファイルをアップロードする)、[sync](#ディレクトリツリーをS3と同期する)、[cp](#バケット間でオブジェクトをコピーする)、[modify](#オブジェクトのメタデータを変更する)コマンド使用時、オブジェクトを配置する際にサーバー側の暗号化を使用するように指定します。

### --encoding=ENCODING

自動検出された端末とファイルシステムのエンコーディング（文字セット）をENCODINGで上書きします。

### --add-encoding-exts=EXTENSIONs

S3へのアップロード時に、[css, js, html]などコンマ区切りの拡張子にエンコードを追加します。

### --verbatim

コマンドラインで指定されているS3名を使用してください。 前処理やエンコードなどは行われません。注意して使用してください。

### --disable-multipart

`--multipart-chunk-size-mb`で指定されたファイルサイズより大きいファイルはマルチパートアップロードを無効にします。

### --multipart-chunk-size-mb=SIZE

マルチパートアップロードの各チャンクのサイズを指定します。 SIZEより大きいファイルはマルチスレッド - マルチパートとして自動的にアップロードされ、小さいファイルは従来の方法でアップロードされます。 SIZEはメガバイト単位で、デフォルトのチャンクサイズは15MB、最小許容チャンクサイズは5MB、最大は5GBです。

### --list-md5

[ls](#バケットまたはオブジェクトを一覧表示する)コマンド使用時、バケットリストにMD5チェックサムを含めます。

### -H, --human-readable-sizes

判読可能な形式でサイズを表示します（例：1234→1kB）。

### --ws-index=WEBSITE_INDEX

[ws-create](#バケットからウェブサイトを作成する)コマンド使用時、index-documentを指定します。

### --ws-error=WEBSITE_ERROR

[ws-create](#バケットからウェブサイトを作成する)コマンド使用時、error-documentを指定します。

#### --expiry-date=EXPIRY_DATE

[expire](#バケットの有効期限ルールを設定または削除する)コマンド使用時、有効期限ルールがいつ有効になるかを示します。

### --expiry-days=EXPIRY_DAYS

[expire](#バケットの有効期限ルールを設定または削除する)コマンド使用時、オブジェクトの作成から有効期限ルールが有効になるまでの日数を示します。

### --expiry-prefix=EXPIRY_PREFIX

[expire](#バケットの有効期限ルールを設定または削除する)コマンド使用時、有効期限ルールが適用されるプレフィックスを使用して1つ以上のオブジェクトを識別します。

### --progress

進行状況メーターを表示します（TTYのデフォルト）。

### --no-progress

進行状況メーターを表示しません（TTYでない場合のデフォルト）。

### --enable

[cfmodify](#CloudFrontディストリビューションのパラメータを変更する)コマンド使用時、特定のCloudFrontディストリビューションを有効にします。

### --disable

[cfmodify](#CloudFrontディストリビューションのパラメータを変更する)コマンド使用時、特定のCloudFrontディストリビューションを無効にします。

[^1]: 原文は --enable と同じ文章だった。ver2.0~では直っている模様

### --cf-invalidate

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

### --cf-invalidate-default-index

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

### --cf-no-invalidate-default-index-root

Custom OriginおよびS3静的Webサイトを使用している場合は、デフォルトのインデックスファイルへのパスを無効にしません。

### --cf-add-cname=CNAME

[cfcreate](#CloudFrontディストリビューションを作成する)および[cfmodify](#CloudFrontディストリビューションのパラメータを変更する)コマンド使用時、指定されたCNAMEをCloudFrontディストリビューションに追加します。

### --cf-remove-cname=CNAME

[cfmodify](#CloudFrontディストリビューションのパラメータを変更する)コマンド使用時、指定されたCNAMEをCloudFrontディストリビューションから削除します。

#### --cf-comment=COMMENT

[cfcreate](#CloudFrontディストリビューションを作成する)および[cfmodify](#CloudFrontディストリビューションのパラメータを変更する)コマンド使用時、CloudFrontディストリビューションにCOMMENTを設定します。

### --cf-default-root-object=DEFAULT_ROOT_OBJECT

[cfcreate](#CloudFrontディストリビューションを作成する)および[cfmodify](#CloudFrontディストリビューションのパラメータを変更する)コマンド使用時、URLにオブジェクトが指定されていない場合に返されるデフォルトのルートオブジェクトを相対パスで設定します。 

（例：/default/index.html または s3://bucket/default/index.html → default/index.html）

### -v, --verbose

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

### -d, --debug

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

### --version

s3cmdのバージョンを表示します。

### -F, --follow-symlinks

通常のファイルであるかのようにシンボリックリンクに対応します。

### --cache-file=FILE

ローカルソースのMD5チェックサムを含むキャッシュファイルを指定します。

### -q, --quiet

標準出力へ出力せずに実行します。

### --ca-certs=CA_CERTS_FILE

システムデフォルトの代わりに使用するSSL CA証明書ファイルへのパスを指定します。

### --check-certificate

SSL証明書の有効性を確認します。

### --no-check-certificate

SSL証明書の有効性を確認しません。

[^2]: 原文は --check-certificate と同じ文章だった。ver2.0~では直っている模様

### --signature-v2

新しい署名方法の代わりにAWS Signatureバージョン2を使用します。 まだAWS Signature v4を搭載していないS3ライクなシステムに役立ちます。

## コマンド

### バケットを作成する

```
s3cmd mb s3://BUCKET
```

### バケットを削除する

```
s3cmd rb s3://BUCKET
```

### バケットまたはオブジェクトを一覧表示する

```
s3cmd ls [s3://BUCKET[/PREFIX]]
```

### すべてのバケットのすべてのオブジェクトを一覧表示する

```
s3cmd la
```

### バケットにファイルをアップロードする

```
s3cmd put FILE [FILE...] s3://BUCKET[/PREFIX]
```

### バケットからファイルをダウンロードする

```
s3cmd get s3://BUCKET/OBJECT LOCAL_FILE
```

### バケットからファイルを削除する

```shell
s3cmd del s3://BUCKET/OBJECT
s3cmd rm s3://BUCKET/OBJECT	# del のエイリアス
```

### アーカイブからファイルを復元する

```
s3cmd restore s3://BUCKET/OBJECT
```

### ディレクトリツリーをS3と同期する

オプションで上書きされない限り、sizeとmd5チェックサムを使用してファイルの鮮度をチェックします。

```
s3cmd sync LOCAL_DIR s3://BUCKET[/PREFIX] or s3://BUCKET[/PREFIX] LOCAL_DIR
```

### バケットの使用量を確認する

```
s3cmd du [s3://BUCKET[/PREFIX]]
```

### バケットやファイルに関する情報を取得する

```
s3cmd info s3://BUCKET[/OBJECT]
```

### バケット間でオブジェクトをコピーする

```
s3cmd cp s3://BUCKET1/OBJECT1 s3://BUCKET2[/OBJECT2]
```

### オブジェクトのメタデータを変更する

```
s3cmd modify s3://BUCKET1/OBJECT
```

### バケット間でオブジェクトを移動する

```
s3cmd mv s3://BUCKET1/OBJECT1 s3://BUCKET2[/OBJECT2]
```

### バケットやファイルのアクセスコントロールリスト (ACL)を変更する

```
s3cmd setacl s3://BUCKET[/OBJECT]
```

### バケットポリシーを変更する

```
s3cmd setpolicy FILE s3://BUCKET
```

### マルチパートアップロードを表示する

```
s3cmd multipart s3://BUCKET [Id]
```

### マルチパートアップロードを中止する

```
s3cmd abortmp s3://BUCKET/OBJECT Id
```

### マルチパートアップロードのパートを一覧表示する

```
s3cmd listmp s3://BUCKET/OBJECT Id
```

### バケットのアクセスログ出力を有効化または無効化する

```
s3cmd accesslog s3://BUCKET
```

### 秘密鍵を使って任意の文字列に署名する

```
s3cmd sign STRING-TO-SIGN
```

### 有効期限付きの限定公開アクセスを提供するためにS3 URLに署名する

```
s3cmd signurl s3://BUCKET/OBJECT <expiry_epoch|+expiry_offset>
```

### バケット内の無効なファイル名を修正する

```
s3cmd fixbucket s3://BUCKET[/PREFIX]
```

### バケットからウェブサイトを作成する

```
s3cmd ws-create s3://BUCKET
```

### ウェブサイトを削除する

```
s3cmd ws-delete s3://BUCKET
```

### ウェブサイトの情報を表示する

```
s3cmd ws-info s3://BUCKET
```

### バケットの有効期限ルールを設定または削除する

```
s3cmd expire s3://BUCKET
```

### バケットのライフサイクルポリシーを設定する

```
s3cmd setlifecycle s3://BUCKET
```

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

```
s3cmd dellifecycle s3://BUCKET
```

### CloudFrontディストリビューションを一覧表示する

```
s3cmd cflist
```

### CloudFrontディストリビューションのパラメータを表示する

```
s3cmd cfinfo [cf://DIST_ID]
```

### CloudFrontディストリビューションを作成する

```
s3cmd cfcreate s3://BUCKET
```

### CloudFrontディストリビューションを削除する

```
s3cmd cfdelete cf://DIST_ID
```

### CloudFrontディストリビューションのパラメータを変更する

```
s3cmd cfmodify cf://DIST_ID
```

### CloudFrontの無効リクエストのステータスを表示する

```
s3cmd cfinvalinfo cf://DIST_ID[/INVAL_ID]
```