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

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

# getRootPasswordServerInstanceList

## 개요

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

## 요청

### 요청 파라미터

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

## 응답

### 응답 바디

- [RootPasswordServerInstanceList](/docs/common-apidatatype-rootpasswordserverinstancelist)

## 예시

### 요청 예시

- 해당 API는 POST method만 허용합니다.

## 예시

### 응답 예시

```
<getRootPasswordServerInstanceListResponse>
  <requestId>20bb8687-5f38-40be-bea3-03adab55f069</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>2</totalRows>
  <rootPasswordServerInstanceList>
    <serverInstanceNo>886621</serverInstanceNo>
    <rootPassword>N2T!FH93*hd</rootPassword>
  </rootPasswordServerInstanceList>
  <rootPasswordServerInstanceList>
    <serverInstanceNo>886624</serverInstanceNo>
    <rootPassword>R78D55h9J#</rootPassword>
  </rootPasswordServerInstanceList>
</getRootPasswordServerInstanceListResponse>
```

## 오류 코드

아래 오류 코드는 이 액션(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. |