---
title: "rm"
slug: "cli-objectstorage-high-level-rm"
updated: 2026-09-17T09:16:11Z
published: 2026-09-17T09:16:11Z
canonical: "cli.ncloud-docs.com/cli-objectstorage-high-level-rm"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `&lt;s3-uri&gt;` | 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 옵션](/docs/guide-objectstorage#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

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

### 명령

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

```
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
```