---
title: "getCloudCacheUserList"
slug: "cli-vcache-getcloudcacheuserlist"
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-getcloudcacheuserlist"
---

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

# getCloudCacheUserList

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

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

## getCloudCacheUserList CLI<a name="getCloudCacheUserListCLI"></a> 
getCloudCacheUserList 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-vserver-server-common-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> |
| output               | No    | String |       | <ul><li>응답 결과의 포맷 타입</li><li>Options: xml \| json</li><li>Default: json</li></ul>  |

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

#### 응답 데이터 타입<a name="응답데이터타입"></a>

- CloudCacheUserList 타입

| CloudCacheUserList extends CommonResponse                                  |
|----------------------------------------------------------------------------|
| private Integer totalRows;                                                 |
| private List&lt;CloudCacheUser&gt; cloudCacheUserList = new ArrayList<>(); |

| CloudCacheUser           |
|--------------------------|
| private String userName; |

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

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

```
./ncloud vcache getCloudCacheUserList --regionCode KR --cloudCacheInstanceNo 157***
```

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

```xml

<getCloudCacheUserListResponse>
    <requestId>b7a09825-f20d-4b3e-8e28-4e6b94c61ccf</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudCacheUserList>
        <cloudCacheUser>
            <userName>user**</userName>
        </cloudCacheUser>
    </cloudCacheUserList>
</getCloudCacheUserListResponse>

```

## getCloudRedisUserList CLI<a name="getCloudRedisUserListCLI"></a> 
getCloudRedisUserList 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-vserver-server-common-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> |
| output               | No    | String |       | <ul><li>응답 결과의 포맷 타입</li><li>Options: xml \| json</li><li>Default: json</li></ul> |

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

#### 응답 데이터 타입<a name="응답데이터타입2"></a>

- CloudRedisUserList 타입

| CloudRedisUserList extends CommonResponse                                  |
|----------------------------------------------------------------------------|
| private Integer totalRows;                                                 |
| private List&lt;CloudRedisUser&gt; cloudRedisUserList = new ArrayList<>(); |

| CloudRedisUser           |
|--------------------------|
| private String userName; |

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

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

```
./ncloud vredis getCloudRedisUserList --regionCode KR --cloudRedisInstanceNo 157***
```

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

```xml

<getCloudRedisUserListResponse>
    <requestId>b7a09825-f20d-4b3e-8e28-4e6b94c61ccf</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudRedisUserList>
        <cloudRedisUser>
            <userName>user**</userName>
        </cloudRedisUser>
    </cloudRedisUserList>
</getCloudRedisUserListResponse>

```