rm

Classic/VPC 환경에서 이용 가능합니다.

Object Storage에 저장된 객체를 삭제합니다.

구문

rm 구문은 다음과 같습니다.

aws s3 rm \
    <s3-uri> \
    [--dryrun] \
    [--quiet] \
    [--include <pattern>] \
    [--exclude <pattern>] \
    [--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 명령에서 공통으로 사용하는 옵션에 대한 정보는 Object Storage 옵션을 참조해 주십시오.

예시

명령을 실행하면 삭제한 객체의 경로가 출력됩니다.

명령

객체 하나를 삭제하는 명령 예시는 다음과 같습니다.

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

디렉터리의 모든 객체를 삭제하는 명령 예시는 다음과 같습니다.

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

출력

객체 하나를 삭제하는 출력 예시는 다음과 같습니다.

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

디렉터리의 모든 객체를 삭제하는 출력 예시는 다음과 같습니다.

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