---
title: "Archive Storage"
slug: "guide-archivestorage"
tags: ["CLI", "Archive Storage"]
updated: 2026-05-21T09:02:09Z
published: 2026-05-21T09:10:09Z
canonical: "cli-gov.ncloud-docs.com/guide-archivestorage"
---

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

# Archive Storage

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

OpenStack swift CLI와 호환되는 Archive Storage CLI의 초기 설정 방법부터 간단한 사용 방법 등을 확인합니다.

## 초기 설정

Archive Storage CLI를 사용하기 위한 설치와 인증 방법을 설명합니다.

### 설치

설치 명령어는 다음과 같습니다.

- Python 3.9 이하:

```
pip install python-keystoneclient==3.17.0
pip install python-swiftclient==3.6.0
```

- Python 3.10 이상:

```
pip install python-keystoneclient==5.1.0
pip install python-swiftclient==4.3.0
```

          참고

          

관련 자료는 다음을 참고해 주십시오.

- 문서 : [https://docs.openstack.org/ocata/cli-reference/swift.html](https://docs.openstack.org/ocata/cli-reference/swift.html)

### 인증

인증 정보를 설정하는 방법은 다음과 같습니다.

- 요청

```
swift --os-auth-url https://kr.archive.gov-ncloudstorage.com:5000/v3 --auth-version 3 \
      --os-username {access_key_id} --os-password {secret_key} \
      --os-user-domain-id {domain_id} --os-project-id {project_id} \
      auth
```
- 결과

```
export OS_STORAGE_URL=https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}
export OS_AUTH_TOKEN={token}
```
  - 결과 값에 표시되어 있는 export 명령으로 OS_STORAGE_URL, OS_AUTH_TOKEN를 환경 변수로 선언하여 재인증없이 서비스 요청을 이용 가능

```
export OS_STORAGE_URL=https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}
export OS_AUTH_TOKEN={token}

swift list
```
  - 환경 변수로 사용하지 않고 --os-storage-url, --os-auth-token 옵션값을 입력해서 사용 가능

```
swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
      --os-auth-token {token} \
      list
```
  - 서비스 URL과 토큰값을 저장해서 사용하지 않고 매 요청마다 인증하는 방식으로 사용 가능

```
swift --os-auth-url https://kr.archive.gov-ncloudstorage.com:5000/v3 --auth-version 3 \
      --os-username {access_key_id} --os-password {secret_key} \
      --os-user-domain-id {domain_id} --os-project-id {project_id} \
      list
```

          참고

          

서비스 요청 전에 매번 인증 요청을 수행하기 때문에 권장하지 않습니다.

## 명령어

Archive Storage CLI를 설명합니다.

### 컨테이너 목록조회

컨테이너 목록을 조회하는 명령어는 다음과 같습니다.

```
swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
      --os-auth-token {token} \
      list
```

          참고

          

서브 계정의 경우, 컨테이너 목록을 조회 명령어(swift list)를 사용할 수 없습니다.

### 오브젝트 목록조회

오브젝트 목록을 조회하는 명령어는 다음과 같습니다.

```
swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
      --os-auth-token {token} \
      list {container}
```

### 오브젝트 업로드

오브젝트를 업로드하는 명령어는 다음과 같습니다.

```
swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
      --os-auth-token {token} \
      upload {container} --object-name {object} {local_file_path}
```

### 대용량 오브젝트 업로드

대용량 오브젝트를 업로드할 때는 세그먼트 컨테이너와 매니페스트 컨테이너를 각각 다르게 지정해야 합니다. 아래는 매니페스트 파일을 `container1` 에 업로드하고, 세그먼트 파일들을 `container2` 에 업로드하는 예시 명령어입니다.

```
swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
      --os-auth-token {token} \
      upload container1 --object-name {object} {local_file_path} --segment-size {size} --segment-container container2 [--use-slo]
```

만약 다운로드를 수행하려면, `container1` 에 업로드된 오브젝트를 다운로드하면 됩니다.

### 로컬 경로 전체 업로드

recursive하게 로컬 경로 전체를 업로드하는 명령어는 다음과 같습니다.

```
swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
      --os-auth-token {token} \
      upload {container} {local_file_path}
```

### 오브젝트 삭제

오브젝트를 1개 이상 입력하여 삭제하는 명령어는 다음과 같습니다.

```
swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
      --os-auth-token {token} \
      delete {container} {object} [...]
```

--prefix 옵션을 사용하여 지정한 prefix로 시작하는 오브젝트를 삭제하려면 다음과 같이 명령어를 실행해 주십시오.

```
swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
      --os-auth-token {token} \
      delete {container} --prefix {prefix}
```

### 컨테이너 삭제

컨테이너의 모든 오브젝트를 삭제하고 마지막에 컨테이너를 삭제하는 명령어는 다음과 같습니다.

```
swift --os-storage-url https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id} \
      --os-auth-token {token} \
      delete {container}
```