---
title: "addCloudPostgresqlUserList"
slug: "cli-vpostgresql-addcloudpostgresqluserlist"
tags: ["Cloud DB for PostgreSQL", "DB User"]
updated: 2026-06-25T09:10:29Z
published: 2026-06-25T09:10:29Z
canonical: "cli-fin.ncloud-docs.com/cli-vpostgresql-addcloudpostgresqluserlist"
---

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

# addCloudPostgresqlUserList

Cloud DB for PostgreSQL DB User를 추가합니다.

## 명령어<a name="명령어"></a>

명령어 구문은 다음과 같습니다.

```
ncloud vpostgresql addCloudPostgresqlUserList [regionCode] [cloudPostgresqlInstanceNo] [cloudPostgresqlUserList] [output]
```

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

파라미터에 대한 설명은 다음과 같습니다.

| 파라미터                                  | 타입            | 필수 여부 | 설명                                                         | 제약 사항                                                    |
| ------------------------------------------- | --------------- | --------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| regionCode                                  | String          | N         | 리전 코드<br>- regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득<br>- default: getRegionList 조회 결과의 첫 번째 리전을 선택 | -                                                            |
| cloudPostgresqlInstanceNo                   | String          | Y         | Cloud DB for PostgreSQL 인스턴스 번호<br>- cloudPostgresqlInstanceNo는 [getCloudPostgresqlInstanceList](/docs/cli-vpostgresql-getcloudpostgresqlinstancelist) 액션을 통해서 획득 | -                                                            |
| cloudPostgresqlUserList.N.name              | List\<String\>  | Y         | Cloud DB for PostgreSQL DB User ID<br>- User 작업은 한 번에 최대 10개 가능 | - 영어 소문자, 숫자, 밑줄 문자( _ )만 허용하며 영어로 시작<br>- 미리 정의된 role 및 예약어는 사용 불가<br>- Min: 4<br>- Max: 16 |
| cloudPostgresqlUserList.N.clientCidr        | List\<String\>  | Y         | Cloud DB for PostgreSQL DB User의 Client CIDR<br>예제)<br>- 전체 접속 허용: 0.0.0.0/0<br>- 특정 IP 접속 허용: 192.168.1.1/32<br>- IP 대역 접속 허용: 192.168.1.0/24 | -                                                            |
| cloudPostgresqlUserList.N.password          | List\<String\>  | Y         | Cloud DB for PostgreSQL DB User의 패스워드                   | - 영어, 숫자, 특수문자 3개 항목에 대해 1자 이상 포함<br>- ` & + \ " ' / 스페이스는 사용 불가<br>- User ID 포함 불가<br>- Min: 8<br>- Max: 20 |
| cloudPostgresqlUserList.N.isReplicationRole | List\<Boolean\> | Y         | Replication Role 여부                                        | -                                                            |
| output                                      | String          | N         | 응답 결과의 포맷 타입<br>- options: xml \| json<br>- default: json | - |

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

호출과 응답 예시를 설명합니다.

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

호출 예시는 다음과 같습니다.

```
ncloud vpostgresql addCloudPostgresqlUserList --regionCode FKR --cloudPostgresqlInstanceNo ****890 --cloudPostgresqlUserList "name='pgtest', clientCidr='0.0.0.0/0', password='********', isReplicationRole='false'"
```

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

응답 예시는 다음과 같습니다.

응답 결과 포맷 타입(output)이 json 일 때

```json
{
  "addCloudPostgresqlUserListResponse": {
    "requestId": "d35c01cf-e77a-44a9-a2b9-1fd1f9572750",
    "returnCode": 0,
    "returnMessage": "success"
  }
}
```

응답 결과 포맷 타입(output)이 xml 일 때

```xml
<addCloudPostgresqlUserListResponse>
  <requestId>d35c01cf-e77a-44a9-a2b9-1fd1f9572750</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
</addCloudPostgresqlUserListResponse>
```