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.