---
title: "addCloudCacheUserList"
slug: "cli-vcache-addcloudcacheuserlist"
tags: ["Cloud DB for Cache"]
updated: 2026-05-21T09:02:05Z
published: 2026-05-21T09:11:33Z
canonical: "cli-gov.ncloud-docs.com/cli-vcache-addcloudcacheuserlist"
---

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

# addCloudCacheUserList

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

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

Cloud DB for Cache User를 추가합니다.

:::(Info) (참고)
Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다.
* addCloudCacheUserList CLI: Valkey, Redis DBMS 이용 가능
* addCloudRedisUserList CLI: Redis DBMS 이용 가능
:::

## addCloudCacheUserList CLI<a name="addCloudCacheUserListCLI"></a> 
addCloudCacheUserList CLI의 요청, 응답 형식을 설명합니다.

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

#### 요청 파라미터<a name="요청파라미터"></a>
요청 파라미터는 다음과 같습니다.
| 파라미터명                         | 필수 여부 | 타입     | 제약 사항                                                                               | 설명                                                                                                                                                                                            |
|-------------------------------|-------|--------|-------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode                    | No    | String |                                                                                     | <ul><li>리전 코드</li><li>Cloud DB for Cache Config Group이 생성될 리전(Region)을 결정 가능</li><li>regionCode는 [getRegionList](/docs/cli-server-getregionlist) 액션을 통해 획득 가능</li><li>Default: getRegionList 조회 결과의 첫 번째 리전 선택</li></ul> |
| cloudCacheInstanceNo          | Yes   | String |                                                                                     | <ul><li>Cloud DB for Cache 인스턴스 번호</li><li>cloudCacheInstanceNo는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해 획득 가능</li></ul> | 
| cloudCacheUserList.N.name     | Yes   | String | <ul><li>영문자, 숫자, 언더바(_), 하이픈(-) 문자만 허용하며 반드시 영어로 시작</li><li>Min: 4, Max: 16</li></ul>  | <ul><li>접근 유저명</li><li>DB 관리자 용도</li><li>추가할 유저명 입력 필요</li><li>cloudCacheUserList.N.name은 [getCloudCacheUserList](/docs/cli-vcache-getcloudcacheuserlist) 액션을 통해 획득 가능</li></ul> |
| cloudCacheUserList.N.password | Yes   | String | <ul><li>영어, 숫자, 특수문자 3개 항목에 대해 1자 이상 포함</li><li> & + \ " ' / 스페이스 사용 불가</li><li>Min: 9, Max: 20</li></ul> | <ul><li>접근 패스워드</li><li>DB 관리자 용도</li><li>추가할 유저의 패스워드 입력 필요</li></ul>  |
| output                        | No    | String |                                                                                     | <ul><li>응답 결과의 포맷 타입</li><li>Options: xml \| json</li><li>Default: json</li></ul>  |

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

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

```
./ncloud vcache addCloudCacheUserList --regionCode KR --cloudCacheInstanceNo 157*** --cloudCacheUserList "name='****', password='*****'"
```

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

```xml

<addCloudCacheUserListResponse>
    <requestId>65544ec3-8da6-4bf1-9b0c-5957d110bd42</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
</addCloudCacheUserListResponse>
```

## addCloudRedisUserList CLI<a name="addCloudRedisUserListCLI"></a> 
addCloudRedisUserList CLI의 요청, 응답 형식을 설명합니다.

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

#### 요청 파라미터<a name="요청파라미터2"></a>
요청 파라미터는 다음과 같습니다.
| 파라미터명                         | 필수 여부 | 타입     | 제약 사항                                                                               | 설명                                                                                                                                                                                            |
|-------------------------------|-------|--------|-------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode                    | No    | String |                                                                                     | <ul><li>리전 코드</li><li>Cloud DB for Cache Config Group이 생성될 리전(Region) 결정 가능</li><li>regionCode는 [getRegionList](/docs/cli-server-getregionlist) 액션을 통해 획득 가능</li><li>Default: getRegionList 조회 결과의 첫 번째 리전 선택</li></ul> |
| cloudRedisInstanceNo          | Yes   | String |                                                                                     | <ul><li>Cloud DB for Cache 인스턴스 번호</li><li>cloudRedisInstanceNo는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해 획득 가능</li></ul> | 
| cloudRedisUserList.N.name     | Yes   | String | <ul><li>영문자, 숫자, 언더바(_), 하이픈(-) 문자만 허용하며 반드시 영어로 시작</li><li>Min: 4, Max: 16</li></ul> | <ul><li>접근 유저명</li><li>DB 관리자 용도</li><li>추가할 유저명 입력 필요</li><li>cloudRedisUserList.N.name은 [getCloudCacheUserList](/docs/cli-vcache-getcloudcacheuserlist) 액션을 통해 획득 가능</li></ul> |
| cloudRedisUserList.N.password | Yes   | String | <ul><li>영어, 숫자, 특수문자 3개 항목에 대해 1자 이상 포함</li><li> & + \ " ' / 스페이스 사용 불가</li><li>Min: 9, Max: 20</li></ul> | <ul><li>접근 패스워드</li><li>DB 관리자 용도</li><li>추가할 유저의 패스워드 입력 필요</li></ul> |
| output                        | No    | String |                                                                                     | <ul><li>응답 결과의 포맷 타입</li><li>Options: xml \| json</li><li>Default: json</li></ul> |

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

#### 호출 예시<a name="호출예시2"></a>

```http
./ncloud vredis addCloudRedisUserList --regionCode KR --cloudRedisInstanceNo 157*** --cloudRedisUserList "name='****', password='*****'"
```

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

```xml

<addCloudRedisUserListResponse>
    <requestId>65544ec3-8da6-4bf1-9b0c-5957d110bd42</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
</addCloudRedisUserListResponse>
```