rb

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

Ncloud Storageから空のバケットを削除します。

注意

削除したバケットやオブジェクトは復元できません。--forceオプションを使用すると、バケット内のすべてのオブジェクトが削除された後にバケットが削除されます。実行前に対象のバケットをご確認ください。

構文

rb構文は次の通りです。

aws s3 rb \
    <s3-uri> \
    [--force] \
    --endpoint-url <endpoint-url>

オプション

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

必須オプション

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

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

任意オプション

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

オプション	タイプ	必須の有無	説明
`--force`	Boolean	Optional	バケット内のすべてのオブジェクトを削除した後、バケットを削除バージョン IDのあるオブジェクトは削除不可

共通オプション

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

例

コマンドを実行すると、削除したバケットの名前が出力されます。--forceオプションを使用した場合、削除したオブジェクトのパスも併せて出力されます。

コマンド

空のバケットを削除するコマンドの例は次の通りです。

aws s3 rb s3://my-temp-bucket \
    --endpoint-url=https://kr.ncloudstorage.com

空でないバケットをオブジェクトごと削除するコマンドの例は次の通りです。

aws s3 rb s3://my-temp-bucket \
    --force \
    --endpoint-url=https://kr.ncloudstorage.com

出力

空のバケットを削除する出力の例は次の通りです。

remove_bucket: my-temp-bucket

空でないバケットをオブジェクトごと削除する出力の例は次の通りです。

delete: s3://my-temp-bucket/img/photo.jpg
delete: s3://my-temp-bucket/docs/report.txt
remove_bucket: my-temp-bucket

--forceオプションを指定せずに空でないバケットを削除すると、以下のようなエラーメッセージが出力されます。

remove_bucket failed: s3://my-temp-bucket An error occurred (BucketNotEmpty) when calling the DeleteBucket operation: The bucket you tried to delete is not empty.