---
title: "getRootPassword"
slug: "compute-server-getrootpassword"
updated: 2026-09-17T09:16:15Z
published: 2026-09-17T09:16:15Z
canonical: "api.ncloud-docs.com/compute-server-getrootpassword"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getRootPassword

## 개요

서버(VM)의 로그인키로 root 계정의 비밀번호를 조회합니다.

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| serverInstanceNo | Yes | String |  | - 조회할 서버 인스턴스 번호 리스트 serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능 |
| privateKey | No | String | 로그인키 내용이 그대로 들어와야 하므로, \n을 붙여야 함 | - 서버 인스턴스에 할당된 로그인 키 생성하거나 import한 로그인 키의 개인 키 텍스트를 입력함 서버의 로그인 키 파일(.pem)을 통해 획득 가능 로그인 키 내용이 그대로 들어와야 하므로 '\n'을 붙여주고, GET 방식을 이용시 URL 인코딩이 필요함 |
| responseFormatType | No | String |  | - 응답 결과의 포맷 타입 Options : xml \| json Default : xml |

## 응답

### 응답 바디

- [Rootpassword](/docs/common-apidatatype-rootpassword)

## 예시

### 요청 예시

```
GET ${SERVER_API_URL}/getRootPassword
?serverInstanceNo=67953
&privateKey=-----BEGIN RSA PRIVATE KEY-----\nMIIEpAIBAAKCAQEAtNkTS9cHBLXQcDY0s02KqaLb8GGupaeCLvWzNDM3aVZxUDFo\n kZYaEKFXbWhR1oZ4HyZnwo4y1VDxV1m35Ltq/HRCHP8+caNHaM6n2rivfHT8nMxg\n KvzsXjopWIVp+8oHvmi0TO+zcEusoNOv/jb7LcJwfeZ0WQvianQ7j6ppaXgHfZSX\n Tdqwyuf9UmzppUa8f2wLslDOlcYQW6VQ9S5f9cx9HgTXbc4vlb+NDLwdx0E+AIjw\n p5PgWCjbEqGKz2Myw4X7HJ06619BScwXSkyG+G3g0VjtL7WnEhhdmfGLCUE/BcKv\n Fz9KeRXIQAx8NrAW4c0Vq+CPyBgz5EWWMpTUXQIDAQABAoIBABn7AXmot3pmwD4O\n m32SyzPZkK0060kjCmHCrG74WKKKZ5b0sigQH0h6VTwDe5ZNFR6sfsWFdioNCc7Z\n tcBnaFRCQ2k1Bfx/T3fwEE8srxE7ITtJZRtn4HEc++maqQIiIQCqvBQ9b1LXnEIy\n hxsHPQhy4YREwjw0p99ROWlHOwOKm6KWbc4YFbDKmEc9v+NLxxNjf2KF7jNuQK0l\n VjeJEzBa02sFBGhMeLAMvhmHj9u1NbAFUn/uC4MrMFiQMoCnx2qBSoUPxuvL6WXH\n NpUoLT/rJrlqKUCffS3RIVt+lwjU6vVXlrxuYNTLDH4c+XJHkFprYDdq/lZktuRM\n f9uYa4ECgYEA75xeol7dvFGe6Es8pcNrdZUMEwkVR16DER+nfndl3fJMNu1YIBaf\n XKnDZLjS505pP+a0alwq0aQdXY8FIik9O9ugqpnd1EfI2fMlrVynUOcBIhVbvYip\n PNFg+tIuz37f3vMms7NCQ5W3SlincB63ptl2tovkOjXKbo1r1sZaGf0CgYEAwTfB\n wqvGm1GpMv8jrCFGNS7FXxZy5VcP/APXqfQb6Lpwe4rarxfb8nnap5KYOn0qSbY7\n BOoidV6QysT9Xm3pDjNUoeH9CujK0mx3sL/4utZiCqmVhGljGq9D4A7PsCnT4X4+\n Akvk9L9RS+xNs9NsK8jTz9zthaJRUzhAHcWSAeECgYEA7rUvqj8sVBJUZ0OdFd8L\n zUZBky03X7SOip6odNtqRqS+vPHTG5SuCtitakifBAUf4aNrFZLgrZ38C1sSWCgR\n cvKoq41Ca9tgA5GydXWa0oRwoo34qWfeglJtdTOzos/ZI/nFEr2BRGeBBLYxiQdx\n Gu4G0HGpWzx/gYeuaXeOB9kCgYBEKznPRu+RSORbO60IQ80TYmb8P11WELtw/KIQ\n MjHOkEizLbAt6ksNZ3R/frb6m8JZs1NrTnfN1QlcoNeLg1egTPflDWhLewpj5yTr\n VS+aK5z3ihFYYB45AfD+kfswefFpMzMJeGFVAFLcaIiZk1QstnQUeCvM5BGxPL1S\n Q6xZwQKBgQCSeU8FRIa0jUxN7hx5R1+IAIBPl2JUM7bMME9T3eX3Qh6wNCMjTxse\n NU70sp2m+8sv7Bq4QY5P13Cajo/+fwI1BSa83mF2kXnyEpXsrfw+4FM74YTrX0JA\n FlSDMaL95g7fCSSMuM8sOqMuIBn7d7DiK2nbrez/iRsZFH2qOqusOA==\n
-----END RSA PRIVATE KEY-----\n
&AUTHPARAMS
```

## 예시

### 응답 예시

```
<getRootPasswordResponse>
  <requestId>d3709b68-3540-48a7-8fa0-3a40cde57d2c</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <rootPassword>
    <rootPassword>YY64RG6UET2</rootPassword>
  </rootPassword>
</getRootPasswordResponse>
```

## 오류 코드

아래 오류 코드는 이 액션(Action)에서 특징적으로 발생하는 오류입니다. 공통적으로 발생하는 오류에 대한 상세한 설명은 [NAVER Cloud Platform API](/docs/common-ncpapi)를 참고해주세요

| HTTP Response Code | 리턴 코드 | 리턴 메시지 |
| --- | --- | --- |
| 400 | 24001 | Invalid authentication key. Please check authentication key or input type and try again. |