ファイルの削除 - rm
最終更新日:2025-05-19 15:52:08
rmコマンドは、ファイルを削除するときに使います。
注意：
rm コマンドを使用するには、COSCLI V1.0.1 以上のバージョンをダウンロードしてください。詳細は ダウンロードとインストールの設定 を参照してください。
現在お使いの COSCLI のバージョンが V1.0.0 の場合は、必ず V1.0.1 にバージョンアップしてから rm 削除コマンドを実行してください。V1.0.0 のバージョンでは、rm コマンドを実行する際に --Include および --exclude パラメータが機能せず、予期しない削除が発生する可能性があります。
このコマンドでオブジェクトを削除するには、ポリシー許可を設定する際に、actionを
cos:HeadBucket、cos:HeadObject、cos:GetBucket、cos:DeleteObject、cos:DeleteMultipleObjectsに設定する必要があります。このコマンドでバージョン履歴を削除するには（--all-versionsまたは--version-idを渡す場合）、ポリシー許可を設定する際に、actionを
cos:HeadBucket、cos:HeadObject、cos:GetBucket、cos:DeleteObject、cos:DeleteMultipleObjects、cos:GetBucketVersioning、cos:GetBucketObjectVersionsに設定する必要があります。コマンド形式
./coscli rm cos://<bucket-name>[/prefix/] [flag]
rm コマンドには以下のパラメータが含まれています：
パラメータ形式 | パラメータ用途 | 例 |
cos://<bucket-name> | アクセスするバケットを指定します。パラメータ設定 のバケットの別名、またはバケット名を使用してアクセスすることがサポートされております。バケット名でアクセスする場合は、追加の endpoint flag が必要になります。 | バケットの別名を使用してアクセスする場合： cos://example-aliasバケット名を使用してアクセスする場合：cos://examplebucket-1250000000 |
/prefix/ | オプションのパラメータ。特定のフォルダを指定します。 | /picture/ |
rmコマンドには、以下のオプションflagが含まれます。
flagの略称 | flagの正式名称 | flagの用途 |
-h | --help | ヘルプ情報を出力 |
-c | --config-path | 使用する設定ファイルパスを指定 |
なし | --include | 特定のモードを含むファイル |
なし | --exclude | 特定のモードを除外したファイル |
-r | --recursive | フォルダ内のすべてのファイルを再帰的にトラバーサル処理するかどうか |
-f | --force | 強制削除（ファイルを削除するまで確認情報はポップアップ表示されません） |
なし | --fail-output | このオプションは、ファイル削除時のエラー出力（デフォルトは true、有効）を有効にするかどうかを決定します。有効にすると、ファイル転送の失敗が指定したディレクトリに記憶されます（指定しない場合はデフォルトで./coscli_outputになる）。無効にすると、エラーファイルの数だけがコンソールに出力されます。 |
なし | --fail-output-path | このオプションは、ファイル削除時のエラー出力を記録するファイルの指定に使用されます。カスタムフォルダパスを指定することで、エラー出力フォルダの場所と名前を管理できます。このオプションが設定されていない場合は、デフォルトのエラーログフォルダ ./coscli_outputが使用されます。 |
なし | --all-versions | バージョン管理が有効になっているバケット内で、かつ--recursive（-r）パラメータを指定した場合にのみ使用可能で、指定されたパス下のすべてのバージョンを再帰的に削除します。 |
なし | --version-id | バージョン管理が有効になっているバケット内で、かつ--recursive（-r）パラメータを指定されてない場合にのみ使用可能で、指定されたオブジェクトの指定バージョンを削除します。 |
説明：
--includeと--excludeは標準的な正規表現の構文をサポートしており、これを使えば特定の条件を満たすファイルをフィルタリングすることができます。zshを使用する場合、pattern文字列の両端に二重引用符を付ける必要がある場合があります。
./cosclirmcos://bucket1/example/ -r--include ".*\\.mp4$"
このコマンドのその他の一般的なオプション（バケットの切り替え、ユーザーアカウントの切り替えなど）については、一般オプション ドキュメンテーションを参照してください。
操作事例
fig1.pngファイルを削除します
./coscli rm cos://bucket1/fig1.png
pictureフォルダからすべてのファイルを削除
./coscli rm cos://bucket1/picture/ -r
fig1.pngの指定バージョンを削除
./coscli rm cos://bucket1/fig1.png --version-id xxx
testプレフィックスのすべてのバージョンを削除
./coscli rm cos://bucket1/test -r --all-versions
フィードバック