---
title: "rm"
slug: "rm"
updated: 2026-10-08T09:46:32Z
published: 2026-10-08T09:46:32Z
canonical: "cli.ncloud-docs.com/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環境で利用できます。

Ncloud Storageに保存されているオブジェクトを削除します。

              注意

              

削除したオブジェクトは復元できません。バージョン管理が設定されたバケットには削除マーカーが追加され、以前のバージョンは保持されます。`--recursive`オプションを使用する際は、`--dryrun`オプションで削除対象をあらかじめご確認ください。

## 構文

`rm`構文は次の通りです。

```
aws s3 rm \
<s3-uri> \
[--dryrun] \
[--quiet] \
[--include <include>] \
[--exclude <exclude>] \
[--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`コマンドで共通して使用するオプションについては、[Ncloud Storageのオプション](/docs/ja/storage-ncloudstorage#%EC%98%B5%EC%85%98)をご参照ください。

## 例

コマンドを実行すると、削除したオブジェクトのパスが出力されます。

### コマンド

1つのオブジェクトを削除するコマンドの例は次の通りです。

```
aws s3 rm s3://my-test-bucket/docs/moved.txt \
--endpoint-url=https://kr.ncloudstorage.com
```

特定の拡張子を除外してバケット内のすべてのオブジェクトを削除するコマンドの例は次の通りです。

```
aws s3 rm s3://my-test-bucket/ \
--recursive \
--exclude "*.jpg" \
--endpoint-url=https://kr.ncloudstorage.com
```

### 出力

1つのオブジェクトを削除する出力の例は次の通りです。

```
delete: s3://my-test-bucket/docs/moved.txt
```

特定の拡張子を除外してバケット内のすべてのオブジェクトを削除する出力の例は次の通りです。コンソールで作成したフォルダは空のオブジェクトとして保存されるため、削除対象に含まれます。

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