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

## 구문

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

```
./ncloud vmssql exportBackupToObjectStorage \
    --cloudMssqlInstanceNo <instance-no> \
    --cloudMssqlServerInstanceNo <server-instance-no> \
    --cloudMssqlExportObjectList <export-object-config> \
    --bucketName <bucket-name> \
    [--folderPath <folder-path>] \
    [--regionCode <FKR>] \
    [--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 옵션](/docs/cli-vmssql#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

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

### 명령

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

```
./ncloud vmssql exportBackupToObjectStorage \
    --cloudMssqlInstanceNo 141402185 \
    --cloudMssqlServerInstanceNo 141402194 \
    --cloudMssqlExportObjectList 'fullObjectName="Z:\\cmssql_backup\\user_idx_2706424\\cmssql_192-168-4-6_m-141402185-001\\msdb_20260618_134359.full"' \
    --bucketName my-test-bucket \
    --folderPath mssql-backup/ \
    --regionCode FKR \
    --output json
```

### 출력

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

```
{
  "exportBackupToObjectStorageResponse": {
    "requestId": "67fc6e48-8efc-4666-b0b6-54f7c82b70b1",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```