---
title: "addCloudPostgresqlUserList"
slug: "cli-vpostgresql-addcloudpostgresqluserlist"
updated: 2026-09-17T10:11:08Z
published: 2026-09-17T10:11:08Z
canonical: "cli.ncloud-docs.com/cli-vpostgresql-addcloudpostgresqluserlist"
---

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

# addCloudPostgresqlUserList

VPC環境で利用できます。

Cloud DB for PostgreSQLインスタンスに DB Userを追加します。

## 構文

`addCloudPostgresqlUserList`構文は次の通りです。

```
./ncloud vpostgresql addCloudPostgresqlUserList \
    --cloudPostgresqlInstanceNo <instance-no> \
    --cloudPostgresqlUserList <user-config> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

## オプション

`addCloudPostgresqlUserList`の実行時に指定できるオプションについて説明します。

### 必須オプション

`addCloudPostgresqlUserList`の必須オプションです。

| オプション | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `--cloudPostgresqlInstanceNo` | String | Required | Cloud DB for PostgreSQLインスタンス番号 - [getCloudPostgresqlInstanceList](/docs/ja/cli-vpostgresql-getcloudpostgresqlinstancelist)を参照 |
| `--cloudPostgresqlUserList` | List | Required | 追加する DB Userリスト - 各ユーザーは、二重引用符の中に{フィールド=‘値’}のペアをコンマで区切って入力 - `name` (Required): DB Userアカウント ID。英字の小文字、数字、記号の`_`を組み合わせて4~16文字以内で入力。先頭文字は英字のみ使用。あらかじめ定義した roleと予約語は使用不可 - `password` (Required): DB Userアカウントのパスワード。英字、数字、記号をそれぞれ1文字以上含めて8~20文字以内で入力。記号の``` `&amp;` `+` `\` `&quot;` `&apos;` `/`とスペースは使用不可。User IDは含めないこと - `clientCidr` (Required): サーバへの接続を許可するクライアントの CIDRブロック。すべて許可: `0.0.0.0/0`、特定の IPアドレス: `192.168.1.1/32`、IPアドレス範囲: `192.168.1.0/24` - `isReplicationRole` (Required): Replication Roleかどうか。`true` \| `false` |

### 共通オプション

`vpostgresql`コマンドで共通して使用するオプションについては、[Cloud DB for PostgreSQL (VPC)のオプション](/docs/ja/cli-vpostgresql#%EC%98%B5%EC%85%98)を参照してください。

## 例

DB Userの追加リクエストが成功すると、入力したユーザーが Cloud DB for PostgreSQLインスタンスに追加されます。

### コマンド

コマンドの例は次の通りです。

```
./ncloud vpostgresql addCloudPostgresqlUserList \
    --cloudPostgresqlInstanceNo 34567890 \
    --cloudPostgresqlUserList "name='testreader', password='Examplepw123!', clientCidr='0.0.0.0/0', isReplicationRole='false'" \
    --regionCode KR \
    --output json
```

### 出力

出力の例は次の通りです。

```
{
  "addCloudPostgresqlUserListResponse": {
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```