rm

Classic/VPC環境で利用できます。

Ncloud Storageに保存されているオブジェクトを削除します。

注意

削除したオブジェクトは復元できません。バージョン管理が設定されたバケットには削除マーカーが追加され、以前のバージョンは保持されます。--recursiveオプションを使用する際は、--dryrunオプションで削除対象をあらかじめご確認ください。

構文

rm構文は次の通りです。

aws s3 rm \
<s3-uri> \
[--dryrun] \
[--quiet] \
[--include <include>] \
[--exclude <exclude>] \
[--recursive] \
[--only-show-errors] \
[--page-size <page-size>] \
--endpoint-url <endpoint-url>

オプション

rmの実行時に指定できるオプションについて説明します。

必須オプション

rmの必須オプションです。

オプション	タイプ	必須の有無	説明
`<s3-uri>`	String	Required	オブジェクトの S3 URI `s3://{bucket_name}/{object_name}`形式

任意オプション

rmの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`--dryrun`	Boolean	Optional	コマンドを実行せずに結果だけを確認
`--quiet`	Boolean	Optional	レスポンス結果を表示しない
`--include`	String	Optional	指定したパターンと一致するオブジェクトのみがコマンドに含める指定した順序で適用
`--exclude`	String	Optional	指定したパターンと一致するオブジェクトをコマンドから除外指定した順序で適用
`--recursive`	Boolean	Optional	指定したパスの配下のオブジェクトまで削除
`--only-show-errors`	Boolean	Optional	エラーのみ表示し、その他のレスポンス値は表示しない
`--page-size`	Integer	Optional	ページごとの項目数 `1`~`1000`

共通オプション

awsコマンドで共通して使用するオプションについては、Ncloud Storageのオプションをご参照ください。

例

コマンドを実行すると、削除したオブジェクトのパスが出力されます。

コマンド

1つのオブジェクトを削除するコマンドの例は次の通りです。

aws s3 rm s3://my-test-bucket/docs/moved.txt \
--endpoint-url=https://kr.ncloudstorage.com

特定の拡張子を除外してバケット内のすべてのオブジェクトを削除するコマンドの例は次の通りです。

aws s3 rm s3://my-test-bucket/ \
--recursive \
--exclude "*.jpg" \
--endpoint-url=https://kr.ncloudstorage.com

出力

1つのオブジェクトを削除する出力の例は次の通りです。

delete: s3://my-test-bucket/docs/moved.txt

特定の拡張子を除外してバケット内のすべてのオブジェクトを削除する出力の例は次の通りです。コンソールで作成したフォルダは空のオブジェクトとして保存されるため、削除対象に含まれます。

delete: s3://my-test-bucket/docs/
delete: s3://my-test-bucket/docs/report.txt
delete: s3://my-test-bucket/sample.txt