---
title: "exportBackupToObjectStorage"
slug: "cli-vcache-exportbackuptoobjectstorage"
tags: ["Backup", "Cloud DB for Cache", "Object Storage", "VPC"]
updated: 2026-09-17T09:16:03Z
published: 2026-09-17T09:16:03Z
canonical: "cli.ncloud-docs.com/cli-vcache-exportbackuptoobjectstorage"
---

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

# exportBackupToObjectStorage

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

Cloud DB for Cache 백업 파일을 Object Storage로 전송합니다. 백업 파일을 Object Storage로 전송하기 전에 백업 파일을 저장하고, 검색하기 위한 Object Storage 버킷이 생성되어 있어야 합니다. 자세한 내용은 [Object Storage 사용 가이드](https://guide.ncloud-docs.com/docs/storage-storage-6-1)를 참조해 주십시오.

참고

Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다.

- exportBackupToObjectStorage CLI: Valkey, Redis DBMS 이용 가능
- exportBackupToObjectStorage CLI: Redis DBMS 이용 가능

## exportBackupToObjectStorage CLI

exportBackupToObjectStorage CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다.

### 구문

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

```
./ncloud vcache exportBackupToObjectStorage \
    --cloudCacheInstanceNo <instance-no> \
    --fileName <backup-file-name> \
    --bucketName <bucket-name> \
    --backupTypeMode <SYSTEM|MANUAL> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

### 옵션

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

#### 필수 옵션

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

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--cloudCacheInstanceNo` | String | Required | Cloud DB for Cache 인스턴스 번호 - [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 참조 |
| `--fileName` | String | Required | 백업 파일 이름 - [getCloudCacheBackupDetailList](/docs/cli-vcache-getcloudcachebackupdetaillist), [getCloudCacheManualBackupDetailList](/docs/cli-vcache-getcloudcachemanualbackupdetaillist) 참조 |
| `--bucketName` | String | Required | 백업 파일이 전송될 Object Storage 버킷 이름 - [Object Storage](/docs/guide-objectstorage) 참조 |
| `--backupTypeMode` | String | Required | Cloud DB for Cache 백업 유형 - `SYSTEM` \| `MANUAL` - - `SYSTEM`: 시스템 백업 - `MANUAL`: 수동 백업 |

#### 공통 옵션

`vcache` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud DB for Cache (VPC) 옵션](/docs/cli-vcache#%EC%98%B5%EC%85%98)을 참조해 주십시오.

### 예시

백업 파일 전송 요청이 성공하면 지정한 Object Storage 버킷으로 백업 파일이 전송됩니다.

#### 명령

명령 예시는 다음과 같습니다.

```
./ncloud vcache exportBackupToObjectStorage \
    --cloudCacheInstanceNo 34567890 \
    --fileName 202606101507 \
    --bucketName my-test-bucket \
    --backupTypeMode MANUAL \
    --regionCode KR \
    --output json
```

#### 출력

출력 예시는 다음과 같습니다.

```
{
  "exportBackupToObjectStorageResponse": {
    "requestId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

## exportBackupToObjectStorage CLI (Redis)

exportBackupToObjectStorage CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다.

### 구문

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

```
./ncloud vredis exportBackupToObjectStorage \
    --cloudRedisInstanceNo <instance-no> \
    --fileName <backup-file-name> \
    --bucketName <bucket-name> \
    --backupTypeMode <SYSTEM|MANUAL> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

### 옵션

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

#### 필수 옵션

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

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--cloudRedisInstanceNo` | String | Required | Cloud DB for Cache 인스턴스 번호 - [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 참조 |
| `--fileName` | String | Required | 백업 파일 이름 - [getCloudCacheBackupDetailList](/docs/cli-vcache-getcloudcachebackupdetaillist), [getCloudCacheManualBackupDetailList](/docs/cli-vcache-getcloudcachemanualbackupdetaillist) 참조 |
| `--bucketName` | String | Required | 백업 파일이 전송될 Object Storage 버킷 이름 - [Object Storage](/docs/guide-objectstorage) 참조 |
| `--backupTypeMode` | String | Required | Cloud DB for Cache 백업 유형 - `SYSTEM` \| `MANUAL` - - `SYSTEM`: 시스템 백업 - `MANUAL`: 수동 백업 |

#### 공통 옵션

`vredis` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud DB for Cache (VPC) 옵션](/docs/cli-vcache#%EC%98%B5%EC%85%98)을 참조해 주십시오.

### 예시

백업 파일 전송 요청이 성공하면 지정한 Object Storage 버킷으로 백업 파일이 전송됩니다.

#### 명령

명령 예시는 다음과 같습니다.

```
./ncloud vredis exportBackupToObjectStorage \
    --cloudRedisInstanceNo 34567890 \
    --fileName 20260626 \
    --bucketName my-test-bucket \
    --backupTypeMode SYSTEM \
    --regionCode KR \
    --output json
```

#### 출력

출력 예시는 다음과 같습니다.

```
{
  "exportBackupToObjectStorageResponse": {
    "requestId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```