---
title: "exportBackupToObjectStorage"
slug: "cli-vmysql-exportbackuptoobjectstorage"
tags: ["Cloud DB for MySQL", "Object Storage", "Backup", "VPC"]
updated: 2026-09-17T09:16:03Z
published: 2026-09-17T09:16:03Z
canonical: "cli.ncloud-docs.com/cli-vmysql-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 MySQL 인스턴스의 백업 파일을 Object Storage로 전송합니다. 백업 파일을 Object Storage로 전송하기 전에 백업 파일을 저장하고, 검색하기 위한 Object Storage 버킷이 생성되어 있어야 합니다. 자세한 내용은 [Object Storage 사용 가이드](https://guide.ncloud-docs.com/docs/storage-storage-6-1)를 참조해 주십시오.

## 구문

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

```
./ncloud vmysql exportBackupToObjectStorage \
    --cloudMysqlInstanceNo <instance-no> \
    --fileName <backup-file-name> \
    --bucketName <bucket-name> \
    [--folderPath <folder-path>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

## 옵션

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

### 필수 옵션

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

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--cloudMysqlInstanceNo` | String | Required | Cloud DB for MySQL 인스턴스 번호 - [getCloudMysqlInstanceList](/docs/cli-vmysql-getcloudmysqlinstancelist) 참조 |
| `--fileName` | String | Required | 백업 파일 이름 - [getCloudMysqlBackupDetailList](/docs/cli-vmysql-getcloudmysqlbackupdetaillist) 참조 |
| `--bucketName` | String | Required | 백업 파일이 전송될 Object Storage 버킷 이름 - [Object Storage](/docs/guide-objectstorage) 참조 |

### 선택 옵션

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

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--folderPath` | String | Optional | 백업 파일이 전송될 폴더 경로 |

### 공통 옵션

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

## 예시

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

### 명령

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

```
./ncloud vmysql exportBackupToObjectStorage \
    --cloudMysqlInstanceNo 12345678 \
    --fileName 20260604 \
    --bucketName my-test-bucket \
    --folderPath cloud-db-for-mysql/ \
    --regionCode KR \
    --output json
```

### 출력

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

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