---
title: "getRootPassword"
slug: "cli-vserver-server-getrootpassword"
tags: ["privateKey", "root", "Server"]
updated: 2026-04-23T09:04:51Z
published: 2026-04-23T09:07:28Z
canonical: "cli-fin.ncloud-docs.com/cli-vserver-server-getrootpassword"
---

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

# getRootPassword

## 개요<a name="개요"></a>

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

## 요청<a name="요청"></a>


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


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

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


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

- RootPassword 타입

| RootPassword extends CommonResponse |
| ---------- |
| private String rootPassword; |


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


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

```
ncloud vserver getRootPassword --regionCode KR --serverInstanceNo ***4299 --privateKey "file://PATH/KEY_NAME.pem"
```
```
ncloud vserver getRootPassword --regionCode KR --serverInstanceNo ***4299 --privateKey "https://URL/KEY_NAME.pem"
```
```
ncloud vserver getRootPassword --regionCode KR --serverInstanceNo ***4299 --privateKey \
"-----BEGIN RSA PRIVATE KEY-----\
...KEY_CONTENT...\
-----END RSA PRIVATE KEY-----"
```

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


```xml
<getRootPasswordResponse>
  <requestId></requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <rootPassword>P3e7fLnd6=***</rootPassword>
</getRootPasswordResponse>
```