---
title: "changeCloudMysqlUserList"
slug: "cli-vmysql-changecloudmysqluserlist"
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-changecloudmysqluserlist"
---

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

# changeCloudMysqlUserList

<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 | | - 리전 코드<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<br/>변경 불가 |
| cloudMysqlUserList.N.hostIp | Yes | List\<String\> | | - MySQL 유저 host<br/>변경 불가<br/>예제)<br/>전체 접속 허용 : %<br/>특정 IP 접속 허용 : 1.1.1.1<br/>IP 대역 접속 허용 : 1.1.1.% |
| cloudMysqlUserList.N.password | No | List\<String\> | 영어, 숫자, 특수문자 3개 항목에 대해 1자 이상 포함되어야 함<br/>특정 특수문자( ` & + " ' / 공백 )는 사용 불가<br> Password Plugin이 활성화된 상태에선 plugin으로 설정한 정책도 만족시켜야 함<br/>Min: 8<br/>Max: 20 | - MySQL 유저 패스워드<br/>패스워드를 변경할 때만 입력 |
| 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 changeCloudMysqlUserList --regionCode KR --cloudMysqlInstanceNo ****890 --cloudMysqlUserList "name='testuser', hostIp='%', password='********', authority='CRUD', isSystemTableAccess=true"
```

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

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