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

## 구문

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

```
./ncloud vmssql exportBackupToObjectStorage \
    --cloudMssqlInstanceNo <instance-no> \
    --cloudMssqlServerInstanceNo <server-instance-no> \
    --cloudMssqlExportObjectList <export-object-config> \
    --bucketName <bucket-name> \
    [--folderPath <folder-path>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

## 옵션

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

### 필수 옵션

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

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--cloudMssqlInstanceNo` | String | Required | Cloud DB for MSSQL 인스턴스 번호 - [getCloudMssqlInstanceList](/docs/cli-vmssql-getcloudmssqlinstancelist) 참조 |
| `--cloudMssqlServerInstanceNo` | String | Required | Cloud DB for MSSQL 서버 인스턴스 번호 - [getCloudMssqlInstanceList](/docs/cli-vmssql-getcloudmssqlinstancelist) 참조 |
| `--cloudMssqlExportObjectList` | List | Required | Object Storage로 전송할 백업 파일 목록 - 각 항목은 따옴표 안에 {필드='값'} 쌍으로 입력 - `fullObjectName` (Required): 전송할 백업 파일의 전체 경로. [getCloudMssqlBackupDetailList](/docs/cli-vmssql-getcloudmssqlbackupdetaillist)의 `fullFileName` 참조 |
| `--bucketName` | String | Required | 백업 파일이 전송될 Object Storage 버킷 이름 - [getCloudMssqlBucketList](/docs/cli-vmssql-getcloudmssqlbucketlist) 참조 |

### 선택 옵션

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

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

### 공통 옵션

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

## 예시

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

### 명령

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

```
./ncloud vmssql exportBackupToObjectStorage \
    --cloudMssqlInstanceNo 25280088 \
    --cloudMssqlServerInstanceNo 25280089 \
    --cloudMssqlExportObjectList 'fullObjectName="Z:\\cmssql_backup\\user_idx_0000000\\cmssql_10-0-0-6_m-25280088-001\\msdb_20260609_202338.full"' \
    --bucketName my-test-bucket \
    --folderPath mssql-backup/ \
    --regionCode KR \
    --output json
```

### 출력

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

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