Classic/VPC 환경에서 이용 가능합니다 .
Ncloud Storage에서 비어있는 버킷을 삭제합니다.명령어
명령어 구문은 다음과 같습니다.
aws s3 rb <target> --endpoint-url <value> [--options]
파라미터
파라미터에 대한 설명은 다음과 같습니다.
| 파라미터 | 타입 | 필수 여부 | 설명 | 제약 사항 |
|---|---|---|---|---|
| --endpoint-url <value> | string | Y | 명령 호출의 기본 URL 지정 | kr 리전만 가능, 호출 도메인 정보는 Ncloud Storage 개요 참고 |
| --force | boolean | N | 버킷 자체를 포함하여 버킷에 있는 모든 객체 삭제 | 버전id가 있는 객체는 삭제 불가 |
| --debug | boolean | N | 디버그 로깅 사용 | - |
| --no-verify-ssl | boolean | N | SSL 인증서를 검증하는 기본 동작 재정의 | - |
| --no-paginate | boolean | N | 자동 pagination 비활성화, 결과에 대해 첫 번째 페이지 한 번만 호출됨 | - |
| --output <value> | string | N | 응답값의 포맷 지정 | 선택한 가능한 옵션 - json - text - table - yaml - yaml-stream |
| --query <value> | string | N | 응답 데이터를 필터링하는 데 사용할 JMESPath 쿼리 | - |
| --profile <value> | string | N | 자격 증명 파일에서 특정 profile 사용 | - |
| --region <value> | string | N | 리전 지정 | kr만 지원 |
| --color <value> | string | N | output color 설정 | 선택한 가능한 옵션 - on - off - auto |
| --no-sign-request | boolean | N | 자격 증명 로드 비활성화 | - |
| --ca-bundle <value> | string | N | SSL 인증서를 확인할 때 사용할 CA 인증서 지정 | - |
| --cli-read-timeout <value> | int | N | 최대 읽기 시간, 0으로 입력시 타임아웃이 아닌 차단 상태로 변경됨 | default는 60초로 설정 |
| --cli-connect-timeout <value> | int | N | 최대 연결 시간, 0으로 입력시 타임아웃이 아닌 차단 상태로 변경됨 | default는 60초로 설정 |
| --no-cli-pager | boolean | N | 응답값의 cli pager 비활성화 | - |
| --cli-auto-prompt | boolean | N | CLI 입력 파라미터 자동 프롬프트 설정 | - |
| --no-cli-auto-prompt | boolean | N | CLI 입력 파라미터 자동 프롬프트 비활성화 | - |
예시
rb 명령어의 호출과 응답 예시를 설명합니다.
객체 삭제
호출 예시
삭제할 빈 버킷을 지정하여 명령어를 호출하면 버킷이 삭제됩니다. 호출 예시는 다음과 같습니다.
aws s3 rb s3://bucket-a --endpoint-url=http://kr.ncloudstorage.com
응답 예시
응답 예시는 다음과 같습니다.
remove_bucket: bucket-a
버킷이 비어있지 않은 경우, 아래와 같은 에러 메시지가 출력됩니다.
remove_bucket failed: s3://bucket-a An error occurred (BucketNotEmpty) when calling the DeleteBucket operation: The bucket you tried to delete is not empty. You must delete all versions in the bucket.
비어있지 않은 버킷 강제 삭제
호출 예시
버킷에 저장된 객체를 포함하여 버킷 자체를 삭제하고 싶은 경우, --force 옵션을 사용하여 명령어를 호출하면 버킷과 하위에 객체까지 모두 삭제됩니다. 다만 버전 관리가 설정된 버킷의 경우, 객체에 삭제 마커가 추가되며 버킷은 삭제가 불가합니다. 호출 예시는 다음과 같습니다.
aws s3 rb s3://bucket-aa --endpoint-url=http://kr.ncloudstorage.com --force
응답 예시
응답 예시는 다음과 같습니다.
delete: s3://bucket-aa/ncs_5.png
remove_bucket: bucket-aa