---
title: "getCloudMssqlBackupDetailList"
slug: "cli-vmssql-getcloudmssqlbackupdetaillist"
tags: ["Cloud DB for MSSQL", "Backup", "VPC"]
updated: 2026-04-23T08:57:07Z
published: 2026-04-23T08:58:59Z
canonical: "cli.ncloud-docs.com/cli-vmssql-getcloudmssqlbackupdetaillist"
---

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

# getCloudMssqlBackupDetailList

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

사용 가능한 Cloud DB for MSSQL 백업 상세 정보 목록을 조회합니다.

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

명령어 구문은 다음과 같습니다.

```
ncloud vmssql getCloudMssqlBackupDetailList [regionCode] [cloudMssqlInstanceNo] [pageNo] [pageSize] [output]
```

### 파라미터<a name="파라미터"></a>

파라미터에 대한 설명은 다음과 같습니다.

| 파라미터             | 타입    | 필수 여부 | 설명                                                         | 제약 사항 |
| -------------------- | ------- | --------- | ------------------------------------------------------------ | --------- |
| regionCode           | String  | N         | 리전 코드<ul><li> regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득</li><li>default: getRegionList 조회 결과의 첫 번째 리전을 선택</li></ul> | -         |
| cloudMssqlInstanceNo | String  | Y         | 백업 상세 정보를 조회할 Cloud DB for MSSQL 인스턴스 번호<ul><li>cloudMssqlInstanceNo는 [getCloudMssqlInstanceList](/docs/cli-vmssql-getcloudmssqlinstancelist) 액션을 통해 획득</li></ul> | -         |
| pageNo               | Integer | N         | 페이징 된 결과의 페이지 번호<ul><li> 결괏값을 pageNo, pageSize를 이용하여 페이징 처리 가능</li></ul> | - Min: 0  |
| pageSize             | Integer | N         | 페이징 시 보여줄 각 페이지 사이즈<ul><li> 결괏값을 pageNo, pageSize를 이용하여 페이징 처리 가능</li><li> pageNo 입력시 반드시 입력 </li></ul>| - Min: 1  |
| output               | String  | N         | 응답 결과의 포맷 타입<ul><li> options: xml \| json</li><li> default: json</li></ul> | - |

## 응답<a name="응답"></a>

### 응답 데이터 타입<a name="응답데이터타입"></a>

- CloudMssqlBackupDetailList 타입

  | CloudMssqlBackupDetailList extends CommonResponse            | 설명                              |
  | ------------------------------------------------------------ | --------------------------------- |
  | private Integer totalRows;                                   | 조회된 목록의 총 개수             |
  | private List&lt;CloudMssqlBackupDetail&gt; cloudMssqlBackupDetailList = new ArrayList&lt;&gt;(); | Cloud DB for MSSQL 백업 상세 목록 |

- CloudMssqlBackupDetail 타입

  | CloudMssqlBackupDetail       | 설명                    |
  |------------------------------|-----------------------|
  | private Integer backupSetId; | 백업 ID                 |
  | private String databaseName; | DB 이름                 |
  | private String fileName;     | 파일 이름                 |
  | private String fullFileName; | full 파일 이름            |
  | private Long fullBackupSize; | FullBackup 데이터 사이즈    |
  | private Long logBackupCount; | 연관된 Log Backup 수      |
  | private Long logBackupSize;  | 연관된 Log Backup 데이터 사이즈 |
  | private Date startTime;      | 백업 시작 일시              |
  | private Date endTime;        | 백업 종료 일시              |

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

호출과 응답 예시를 설명합니다.

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

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

```http
ncloud vmssql getCloudMssqlBackupDetailList --regionCode KR --cloudMssqlInstanceNo ***890
```

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

응답 예시는 다음과 같습니다.

#### 응답 결과 포맷 타입(output)이 json인 경우<a name="응답결과포맷타입output이json인경우"></a>

응답 결과 포맷 타입(output)이 json인 경우는 다음과 같습니다.

```json
{
  "getCloudMssqlBackupDetailListResponse": {
    "requestId": "f3bda8a3-978a-42d3-b52f-123b096e0f45",
    "returnCode": 0,
    "returnMessage": "success",
    "totalRows": 4,
    "cloudMssqlBackupDetailList": [
      {
        "backupSetId": 12,
        "databaseName": "master",
        "fileName": "sample.txt",
        "fullFileName": "D:\\sample.txt",        
        "fullBackupSize": 780145,
        "logBackupCount": 0,
        "logBackupSize": 0,
        "startTime": "2021-07-12T09:13:57+0900",
        "endTime": "2021-07-12T09:13:57+0900"
      },
      {
        "backupSetId": 13,
        "databaseName": "msdb",
        "fileName": "sample1.txt",
        "fullFileName": "D:\\sample1.txt",        
        "fullBackupSize": 2590649,
        "logBackupCount": 0,
        "logBackupSize": 0,
        "startTime": "2021-07-12T09:13:51+0900",
        "endTime": "2021-07-12T09:13:51+0900"
      },
      {
        "backupSetId": 14,
        "databaseName": "master",
        "fileName": "sample2.txt",
        "fullFileName": "D:\\sample2.txt",        
        "fullBackupSize": 780204,
        "logBackupCount": 0,
        "logBackupSize": 0,
        "startTime": "2021-07-11T09:14:18+0900",
        "endTime": "2021-07-11T09:14:18+0900"
      },
      {
        "backupSetId": 15,
        "databaseName": "msdb",
        "fileName": "sample3.txt",
        "fullFileName": "D:\\sample3.txt",        
        "fullBackupSize": 2589526,
        "logBackupCount": 0,
        "logBackupSize": 0,
        "startTime": "2021-07-11T09:14:12+0900",
        "endTime": "2021-07-11T09:14:13+0900"
      }
    ]
  }
}
```

#### 응답 결과 포맷 타입(responseFormatType)이 xml인 경우<a name="응답결과포맷타입responseFormatType이xml인경우"></a>

응답 결과 포맷 타입(responseFormatType)이 xml인 경우는 다음과 같습니다.

```xml
<getCloudMssqlBackupDetailListResponse>
    <requestId>f3bda8a3-978a-42d3-b52f-123b096e0f45</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>4</totalRows>
    <cloudMssqlBackupDetailList>
        <CloudMssqlBackupDetail>
            <backupSetId>12</backupSetId>
            <databaseName>master</databaseName>
            <fileName>sample.txt</fileName>
            <fullFileName>D:\\sample.txt</fullFileName>
            <fullBackupSize>780145</fullBackupSize>
            <logBackupCount>0</logBackupCount>
            <logBackupSize>0</logBackupSize>
            <startTime>2021-07-12T09:13:57+0900</startTime>
            <endTime>2021-07-12T09:13:57+0900</endTime>
        </CloudMssqlBackupDetail>
        <CloudMssqlBackupDetail>
            <backupSetId>13</backupSetId>
            <databaseName>msdb</databaseName>
            <fileName>sample1.txt</fileName>
            <fullFileName>D:\\sample1.txt</fullFileName>
            <fullBackupSize>2590649</fullBackupSize>
            <logBackupCount>0</logBackupCount>
            <logBackupSize>0</logBackupSize>
            <startTime>2021-07-12T09:13:51+0900</startTime>
            <endTime>2021-07-12T09:13:51+0900</endTime>
        </CloudMssqlBackupDetail>
        <CloudMssqlBackupDetail>
            <backupSetId>14</backupSetId>
            <databaseName>master</databaseName>
            <fileName>sample2.txt</fileName>
            <fullFileName>D:\\sample2.txt</fullFileName>
            <fullBackupSize>780204</fullBackupSize>
            <logBackupCount>0</logBackupCount>
            <logBackupSize>0</logBackupSize>
            <startTime>2021-07-11T09:14:18+0900</startTime>
            <endTime>2021-07-11T09:14:18+0900</endTime>
        </CloudMssqlBackupDetail>
        <CloudMssqlBackupDetail>
            <backupSetId>15</backupSetId>
            <databaseName>msdb</databaseName>
            <fileName>sample3.txt</fileName>
            <fullFileName>D:\\sample3.txt</fullFileName>
            <fullBackupSize>2589526</fullBackupSize>
            <logBackupCount>0</logBackupCount>
            <logBackupSize>0</logBackupSize>
            <startTime>2021-07-11T09:14:12+0900</startTime>
            <endTime>2021-07-11T09:14:13+0900</endTime>
        </CloudMssqlBackupDetail>
    </cloudMssqlBackupDetailList>
</getCloudMssqlBackupDetailListResponse>
```
