---
title: "addCloudMysqlUserList"
slug: "cli-vmysql-addcloudmysqluserlist"
tags: ["Cloud DB for MySQL", "VPC"]
updated: 2026-04-23T08:57:05Z
published: 2026-04-23T08:58:56Z
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

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

## 개요<a name="개요"></a>

Cloud DB for MySQL 인스턴스에 DB User를 추가합니다.

## 요청<a name="요청"></a>

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

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| ----- | ----- | ----- | ----- | ----- |
| regionCode | No | String | | 리전 코드<ul><li> regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능</li><li>Default : getRegionList 조회 결과의 첫 번째 리전을 선택</li></ul> |
| cloudMysqlInstanceNo | Yes | String | | Cloud DB for MySQL 인스턴스 번호<ul><li>cloudMysqlInstanceNo는 [getCloudMysqlInstanceList](/docs/cli-vmysql-getcloudmysqlinstancelist) 액션을 통해서 획득 가능</li></ul> |
| cloudMysqlUserList.N.name | Yes | List\<String\> | 영문자, 숫자, 언더바(_), 하이픈(-) 문자만 허용하며 반드시 영어로 시작해야 함<ul><li>Min: 3</li><li>Max: 16</li></ul> | MySQL 유저 ID |
| cloudMysqlUserList.N.hostIp | Yes | List\<String\> | | MySQL 유저 host<ul><li>예제)<ul><li>전체 접속 허용 : %</li><li>특정 IP 접속 허용 : 1.1.1.1</li><li>IP 대역 접속 허용 : 1.1.1.%</li><li> CIDR 허용 : 1.1.1.0/24</li></ul></ul> |
| cloudMysqlUserList.N.password | Yes | List\<String\> | 영어, 숫자, 특수문자 3개 항목에 대해 1자 이상 포함되어야 함<ul><li>특정 특수문자( ` & + " ' / 공백 )는 사용 불가</li><li>Password Plugin이 활성화된 상태에선 plugin으로 설정한 정책도 만족시켜야 함 </li><ul><li>Min: 8</li><li>Max: 20</li></ul></ul> | MySQL 유저 패스워드 |
| cloudMysqlUserList.N.authority | Yes | List\<String\> | |MySQL 유저 권한<ul><li>Options : READ \| CRUD \| DDL</li></ul> |
| cloudMysqlUserList.N.isSystemTableAccess | No | List\<Boolean\> | | 시스템 테이블 접근 가능 여부<ul><li>Options: true \| false </li><li>Default: true</li></ul> |
| output | No | String | | 응답 결과의 포맷 타입<ul><li>Options : xml \| json</li><li>Default : json</li></ul> |

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

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

```
ncloud vmysql addCloudMysqlUserList --regionCode KR --cloudMysqlInstanceNo ****890 --cloudMysqlUserList "name='testuser', hostIp='%', password='********', authority='DDL'"
```

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

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