---
title: "getCloudMssqlLogBackupFileList"
slug: "cli-vmssql-getcloudmssqllogbackupfilelist"
updated: 2026-04-23T08:57:08Z
published: 2026-04-23T08:58:59Z
canonical: "cli.ncloud-docs.com/cli-vmssql-getcloudmssqllogbackupfilelist"
---

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

# getCloudMssqlLogBackupFileList

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

Cloud DB for MSSQL 인스턴스의 로그 백업 파일 목록을 조회합니다.

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

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

```
ncloud vmssql getCloudMssqlLogBackupFileList [regionCode] [cloudMssqlInstanceNo] [databaseName] [backupSetId] [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> | -         |
| databaseName               | String | Y         | DB 명<ul><li>[getCloudMssqlBackupDetailList](/docs/cli-vmssql-getcloudmssqlbackupdetaillist)를 통해 확인</li></ul> | -   |
| backupSetId               | String | Y        | 백업 ID<ul><li>[getCloudMssqlBackupDetailList](/docs/cli-vmssql-getcloudmssqlbackupdetaillist)를 통해 확인</li></ul> | -  |
| output               | String  | N         | 응답 결과의 포맷 타입<ul><li> options: xml \| json</li><li>  default: json</li></ul>| - |

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

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

- CloudMssqlLogBackupFileList 타입

  | CloudMssqlLogBackupFileList extends CommonResponse            | 설명                              |
  | ------------------------------------------------------------ | --------------------------------- |
  | private Integer totalRows;                                   | 조회된 목록의 총 개수             |
  | private List&lt;cloudMssqlLogBackupFile&gt; CloudMssqlLogBackupFileList = new ArrayList&lt;&gt;(); | Cloud DB for MSSQL 로그 백업 파일 목록 |


- cloudMssqlLogBackupFile 타입

  | cloudMssqlLogBackupFile       | 설명                    |
  |------------------------------|-----------------------|
  | private String fileName;     | 파일 이름                 |
  | private String fullFileName; | full 파일 이름            |
  | private Date startTime;      | 시작 일시              |
  | private Date endTime;        | 종료 일시              |
  | private Long fileSize;        | 파일 크기              |

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

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

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

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

```http
ncloud vmssql getCloudMssqlLogBackupFileList --regionCode KR --cloudMssqlInstanceNo ***890 --databaseName msdb --backupSetId 12
```

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

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

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

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

  ```JSON
  {
      "getCloudMssqlLogBackupFileListResponse": {
          "totalRows":1,
          "cloudMssqlLogBackupFileList": [
              {
                  "fileName": "msdb_20240807_02****.full",
                  "fullFileName": "Z:\\cmssql_backup\\user_idx_276****\\cmssql_10-0-2520_m-3***-001\\msdb_20240807_172525.log",
                  "startTime": "2024-08-07T17:25:25+0900",
                  "endTime": "2024-08-07T17:25:25+0900",
                  "fileSize": 620280
              }
          ],
          "requestId": "93697d3d-****-****-****-953e20c67075",
          "returnCode": "0",
          "returnMessage": "success"
      }
  }
  ```

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

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

  ```XML
  <?xml version="1.0" encoding="UTF-8"?>
  <getCloudMssqlLogBackupFileListResponse>
      <requestId>93697d3d-****-****-****-953e20c67075</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <cloudMssqlLogBackupFileList>
          <CloudMssqlLogBackupFile>
              <fileName>msdb_20240701_02****.full</fileName>
              <fullFileName>Z:\cmssql_backup\user_idx_276****\cmssql_10-0-2520_m-3***-001\msdb_20240807_172525.log</fullFileName>
              <startTime>2024-08-07T17:25:25+0900</startTime>
              <endTime>2024-08-07T17:25:25+0900</endTime>
              <fileSize>620280</fileSize>
          </CloudMssqlLogBackupFile>
      </cloudMssqlLogBackupFileList>
  </getCloudMssqlLogBackupFileListResponse>
  ```