---
title: "addCloudPostgresqlUserList"
slug: "cli-vpostgresql-addcloudpostgresqluserlist"
tags: ["Cloud DB for PostgreSQL"]
updated: 2026-05-21T09:02:06Z
published: 2026-05-21T09:11:35Z
canonical: "cli-gov.ncloud-docs.com/cli-vpostgresql-addcloudpostgresqluserlist"
---

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

# addCloudPostgresqlUserList

VPC 환경에서 이용 가능합니다.

## 명령어

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

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

### 파라미터

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

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

## 예시

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

### 호출 예시

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

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

### 응답 예시

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

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

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

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

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