---
title: "delete"
slug: "cli-archivestorage-delete"
updated: 2026-09-17T09:16:11Z
published: 2026-09-17T09:16:11Z
canonical: "cli.ncloud-docs.com/cli-archivestorage-delete"
---

> ## 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.

# delete

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

컨테이너(버킷) 또는 컨테이너 내의 오브젝트를 삭제합니다.

주의

삭제한 컨테이너와 오브젝트는 복구할 수 없습니다. `--all` 옵션을 사용하면 어카운트의 모든 컨테이너와 오브젝트가 삭제되므로 실행 전 대상을 확인해 주십시오.

## 구문

`delete` 구문은 다음과 같습니다.

- 어카운트(전체 컨테이너 및 오브젝트 삭제)

```
swift delete \
    --all \
    [--leave-segments] \
    [--object-threads <threads>] \
    [--container-threads <threads>] \
    [--header <header:value>]
```
- 컨테이너(컨테이너 및 내부 오브젝트 전체 삭제)

```
swift delete \
    <container> \
    [--prefix <prefix>] \
    [--leave-segments] \
    [--object-threads <threads>] \
    [--container-threads <threads>] \
    [--header <header:value>]
```
- 오브젝트(단일 또는 다중 오브젝트 삭제)

```
swift delete \
    <container> <object> [<object> ...] \
    [--leave-segments] \
    [--object-threads <threads>] \
    [--header <header:value>]
```

## 옵션

`delete` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`delete`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `&lt;container&gt;` | String | Conditional | 삭제할 컨테이너 이름 - `--all` 미입력 시 필수 입력 - `&lt;object&gt;` 미입력 시 컨테이너의 모든 오브젝트를 삭제한 후 컨테이너 삭제 |
| `--all` | Boolean | Conditional | 어카운트의 모든 컨테이너와 오브젝트 삭제 - `&lt;container&gt;` 미입력 시 필수 입력 |

### 선택 옵션

`delete`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `&lt;object&gt;` | List | Optional | 삭제할 오브젝트 이름 - 공백으로 구분하여 여러 개 입력 가능 |
| `--prefix` | String | Optional | 지정한 접두사로 시작하는 오브젝트만 삭제 |
| `--leave-segments` | Boolean | Optional | 매니페스트 오브젝트의 세그먼트를 삭제하지 않음 |
| `--object-threads` | Integer | Optional | 오브젝트 삭제에 사용할 스레드 수 - 기본값: `10` |
| `--container-threads` | Integer | Optional | 컨테이너 삭제에 사용할 스레드 수 - 기본값: `10` |
| `--header` | String | Optional | 삭제 요청에 사용할 사용자 정의 헤더 - `header:value` 형식으로 입력 |

### 공통 옵션

`swift` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Archive Storage 옵션](/docs/guide-archivestorage#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

명령을 실행하면 삭제한 오브젝트 이름이 출력되며, 컨테이너를 삭제한 경우 컨테이너 이름도 함께 출력됩니다.

### 명령

오브젝트를 삭제하는 명령 예시는 다음과 같습니다.

```
swift delete test-container-01 copied.txt
```

접두사로 오브젝트를 삭제하는 명령 예시는 다음과 같습니다.

```
swift delete test-container-01 --prefix docs/
```

컨테이너의 모든 오브젝트를 삭제한 후 컨테이너를 삭제하는 명령 예시는 다음과 같습니다.

```
swift delete test-container-01
```

### 출력

오브젝트를 삭제하는 출력 예시는 다음과 같습니다.

```
copied.txt
```

접두사로 오브젝트를 삭제하는 출력 예시는 다음과 같습니다.

```
docs/report.txt
```

컨테이너의 모든 오브젝트를 삭제한 후 컨테이너를 삭제하는 출력 예시는 다음과 같습니다.

```
docs/report.txt
sample.txt
test-container-01
```