---
title: "exportBackupToObjectStorage"
slug: "cli-vcache-exportbackuptoobjectstorage"
tags: ["Backup", "Cloud DB for Cache", "Object Storage"]
updated: 2026-07-23T08:59:48Z
published: 2026-07-23T08:59:48Z
canonical: "cli-fin.ncloud-docs.com/cli-vcache-exportbackuptoobjectstorage"
---

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

# exportBackupToObjectStorage

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

:::(info) (참고)
Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다.
* exportBackupToObjectStorage CLI: Valkey, Redis DBMS 이용 가능
* exportBackupToObjectStorage CLI: Redis DBMS 이용 가능
:::

## exportBackupToObjectStorage CLI<a name="exportBackupToObjectStorageCLI"></a> 
exportBackupToObjectStorage CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다.

### 구문<a name="구문"></a>

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

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

### 옵션<a name="옵션"></a>

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

#### 필수 옵션<a name="필수옵션"></a>

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

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

#### 공통 옵션<a name="공통옵션"></a>

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

### 예시<a name="예시"></a>

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

#### 명령<a name="명령"></a>

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

```shell
./ncloud vcache exportBackupToObjectStorage \
    --cloudCacheInstanceNo 34567890 \
    --fileName 20260626 \
    --bucketName my-test-bucket \
    --backupTypeMode SYSTEM \
    --regionCode FKR \
    --output json
```

#### 출력<a name="출력"></a>

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

```json
{
  "exportBackupToObjectStorageResponse": {
    "requestId": "1a4432e3-eb17-4a1f-a024-a4cfeeb594ea",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

## exportBackupToObjectStorage CLI (Redis)<a name="exportBackupToObjectStorageCLIRedis"></a> 
exportBackupToObjectStorage CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다.

### 구문<a name="구문"></a>

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

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

### 옵션<a name="옵션"></a>

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

#### 필수 옵션<a name="필수옵션"></a>

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

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

#### 공통 옵션<a name="공통옵션"></a>

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

### 예시<a name="예시"></a>

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

#### 명령<a name="명령"></a>

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

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

#### 출력<a name="출력"></a>

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

```json
{
  "exportBackupToObjectStorageResponse": {
    "requestId": "b9c96c7a-a177-44cd-aed2-acd542c63c14",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```