---
title: "addCloudMysqlUserList"
slug: "cli-vmysql-addcloudmysqluserlist"
tags: ["Cloud DB for MySQL", "VPC"]
updated: 2026-09-17T10:11:06Z
published: 2026-09-17T10:11:06Z
canonical: "cli.ncloud-docs.com/cli-vmysql-addcloudmysqluserlist"
---

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

# addCloudMysqlUserList

VPC環境で利用できます。

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

## 構文

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

```
./ncloud vmysql addCloudMysqlUserList \
    --cloudMysqlInstanceNo <instance-no> \
    --cloudMysqlUserList <user-config> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

## オプション

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

### 必須オプション

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

| オプション | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `--cloudMysqlInstanceNo` | String | Required | Cloud DB for MySQLインスタンス番号 - [getCloudMysqlInstanceList](/docs/ja/cli-vmysql-getcloudmysqlinstancelist)を参照 |
| `--cloudMysqlUserList` | List | Required | 追加する DB Userリスト - 各ユーザーは、二重引用符の中に{フィールド=‘値’}のペアをコンマで区切って入力 - `name` (Required): DB Userアカウント ID。英数字、記号の`-` `_`を組み合わせて3~16文字以内で入力。先頭文字は英字のみ使用 - `password` (Required): DB Userアカウントのパスワード。英字、数字、記号をそれぞれ1文字以上含め8~20文字以内で入力。記号の``` `&amp;` `+` `\` `&quot;` `&apos;` `/`とスペースは使用不可。Password Pluginが有効になっている状態では、pluginで設定したポリシーも満たす必要がある - `hostIp` (Required): サーバへの接続を許可するホストの IPアドレス。すべて許可: `%`、特定の IPアドレス: `1.1.1.1`、IPアドレス範囲: `1.1.1.%`、CIDR: `1.1.1.0/24` - `authority` (Required): DB User権限。`READ` (データの照会のみ可能) \| `CRUD` (データの入力、照会、変更、削除が可能) \| `DDL` (CRUD権限を含めテーブルの作成、削除、変更が可能) - `isSystemTableAccess` (Optional): システムテーブルにアクセス可能かどうか。`true` (デフォルト) \| `false` |

### 共通オプション

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

## 例

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

### コマンド

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

```
./ncloud vmysql addCloudMysqlUserList \
    --cloudMysqlInstanceNo 12345678 \
    --cloudMysqlUserList "name='testuser2', password='Examplepw123!', hostIp='%', authority='READ', isSystemTableAccess='false'" \
    --regionCode KR \
    --output json
```

### 出力

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

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