---
title: "addCloudMysqlUserList"
slug: "cli-vmysql-addcloudmysqluserlist"
tags: ["Cloud DB for MySQL ", "DB User"]
updated: 2026-06-25T09:10:27Z
published: 2026-06-25T09:10:27Z
canonical: "cli-fin.ncloud-docs.com/cli-vmysql-addcloudmysqluserlist"
---

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

# addCloudMysqlUserList

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

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

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

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

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

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

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

```
ncloud vmysql addCloudMysqlUserList --regionCode FKR --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>
```