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

## 개요

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

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| regionCode | No | String |  | - 리전 코드 root 계정의 비밀번호를 조회할 서버 인스턴스의 리전(Region) 결정 가능 regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능 Default : getRegionList 조회 결과의 첫 번째 리전을 선택 |
| serverInstanceNo | Yes | String |  | - 서버 인스턴스 번호 serverInstanceNo는 [getServerInstanceList](/docs/cli-vserver-server-getserverinstancelist) 액션을 통해 획득 가능 |
| 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 |

## 응답

### 응답 데이터 타입

- RootPassword 타입

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

## 예시

### 요청 예시

```
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-----"
```

### 응답 예시

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