---
title: "getRootPasswordServerInstanceList"
slug: "cli-vserver-server-getrootpasswordserverinstancelist"
tags: ["root", "Server"]
updated: 2026-04-23T09:04:51Z
published: 2026-04-23T09:07:28Z
---

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

# getRootPasswordServerInstanceList

## 개요

서버 인스턴스(VM)의 로그인 키를 이용하여 root 계정의 비밀번호를 리스트 형태로 조회합니다. privateKey를 입력하지 않으면 해당 서버 인스턴스의 암호화된 비밀번호를 조회합니다.

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| regionCode | No | String |  | - 리전 코드 root 계정의 비밀번호를 조회할 서버 인스턴스 리스트의 리전(Region) 결정 가능 regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능 Default : getRegionList 조회 결과의 첫 번째 리전을 선택 |
| rootPasswordServerInstanceList.N.serverInstanceNo | Yes | String |  | - 서버 인스턴스 번호 serverInstanceNo는 [getServerInstanceList](/docs/cli-vserver-server-getserverinstancelist) 액션을 통해 획득 가능 |
| rootPasswordServerInstanceList.N.privateKey | No | String |  | - 서버 인스턴스에 할당된 로그인 키 생성하거나 import한 로그인 키의 개인 키(.pem) 경로 또는 텍스트를 입력함 ex1) privateKey='file://PATH/KEY_NAME.pem' ("file://" 문자열로 시작하는 경로) ex2) privateKey='https://URL/KEY_NAME.pem' ("http://" 또는 "https://" 문자열로 시작하는 경로) ex3) privateKey=\ '-----BEGIN RSA PRIVATE KEY-----\ ...KEY_CONTENT...\ -----END RSA PRIVATE KEY-----' (개인키 텍스트. 줄바꿈시 환경에 따라 '\'(UNIX 계열) 또는 '^'(Windows 계열) 문자를 사용합니다.) |
| output | No | String |  | 응답 결과의 포맷 타입 - Options : xml \| json - Default : json |

## 응답

### 응답 데이터 타입

- RootPasswordServerInstanceList 타입

| RootPasswordServerInstanceList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<rootpasswordserverinstance data-tomark-pass=""> rootPasswordServerInstanceList = new ArrayList&lt;&gt;();</rootpasswordserverinstance> |

| RootPasswordServerInstance |
| --- |
| private String serverInstanceNo; |
| private String rootPassword; |

## 예시

### 요청 예시

```
ncloud vserver getRootPasswordServerInstanceList --regionCode KR --rootPasswordServerInstanceList "serverInstanceNo=***4299, privateKey='file://PATH/KEY_NAME.pem'"
```

```
ncloud vserver getRootPasswordServerInstanceList --regionCode KR --rootPasswordServerInstanceList "serverInstanceNo=***4299, privateKey='https://URL/KEY_NAME.pem'"
```

```
ncloud vserver getRootPasswordServerInstanceList --regionCode KR --rootPasswordServerInstanceList "serverInstanceNo=***4299, privateKey=\
'-----BEGIN RSA PRIVATE KEY-----\
...KEY_CONTENT...\
-----END RSA PRIVATE KEY-----'"
```

### 응답 예시

```
<getRootPasswordServerInstanceListResponse>
  <requestId></requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <rootPasswordServerInstanceList>
    <rootPasswordServerInstance>
      <serverInstanceNo>***4299</serverInstanceNo>
      <rootPassword>P3e7fLnd6=***</rootPassword>
    </rootPasswordServerInstance>
  </rootPasswordServerInstanceList>
</getRootPasswordServerInstanceListResponse>
```