---
title: "changeCloudPostgresqlUserList"
slug: "cli-vpostgresql-changecloudpostgresqluserlist"
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-changecloudpostgresqluserlist"
---

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

# changeCloudPostgresqlUserList

Cloud DB for PostgreSQL DB User의 정보를 수정합니다.

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

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

```
ncloud vpostgresql changeCloudPostgresqlUserList [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, Max: 16 |
| cloudPostgresqlUserList.N.clientCidr        | List\<String\>  | N         | Cloud DB for PostgreSQL DB User의 Client CIDR<br>- Client CIDR 변경 시에만 입력<br>- Client CIDR, 패스워드, Replication Role 여부 중 하나는 필수로 입력<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\>  | N         | Cloud DB for PostgreSQL DB User의 패스워드<br>- 패스워드 변경 시에만 입력<br>- Client CIDR, 패스워드, Replication Role 여부 중 하나는 필수로 입력 | - 영어, 숫자, 특수문자 3개 항목에 대해 1자 이상 포함<br> `& + \  " ' / 스페이스는 사용 불가<br>- User ID 포함 불가<br> Min: 8, Max: 20 |
| cloudPostgresqlUserList.N.isReplicationRole | List\<Boolean\> | N         | Replication Role 여부<br>- Replication Role 변경 시에만 입력<br>-  Client CIDR, 패스워드, Replication Role 여부 중 하나는 필수로 입력 | -                                                            |
| output                                      | String          | N         | 응답 결과의 포맷 타입<br>- options: xml \| json<br>- default: json | - |

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

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

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

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

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

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

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

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

```json
{
  "changeCloudPostgresqlUserListResponse": {
    "requestId": "08bc2188-6a20-4129-9176-f85be77073dc",
    "returnCode": 0,
    "returnMessage": "success"
  }
}
```

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

```xml
<changeCloudPostgresqlUserListResponse>
  <requestId>08bc2188-6a20-4129-9176-f85be77073dc</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
</changeCloudPostgresqlUserListResponse>
```