---
title: "getCloudCacheBucketList"
slug: "cli-vcache-getcloudcachebucketlist"
tags: ["Cloud DB for Cache", "Object Storage"]
updated: 2026-06-25T09:10:27Z
published: 2026-06-25T09:10:27Z
canonical: "cli-fin.ncloud-docs.com/cli-vcache-getcloudcachebucketlist"
---

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

# getCloudCacheBucketList

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

Cloud DB for Cache에서 사용할 수 있는 Object Storage 버킷 리스트를 조회합니다.

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

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

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

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

| 파라미터명 | 필수 여부 | 타입| 제약 사항 | 설명  |
|---|---|---|---|---|
| regionCode           | No    | String |       | - 리전 코드<br/>Cloud DB for Cache 버킷 리스트가 조회될 리전(Region) 결정 가능<br/>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능<br/>Default : getRegionList 조회 결과의 첫 번째 리전을 선택 |
| cloudCacheInstanceNo | Yes   | String |       | - Cloud DB for Cache 인스턴스 번호<br/>cloudCacheInstanceNo는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능                                                            |
| output               | No    | String |       | - 응답 결과의 포맷 타입<br/>Options: xml \| json<br/>Default: json                                                                                                                                               |

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

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

- CloudCacheBucketList 타입

| CloudCacheBucketList extends CommonResponse                                    |
|--------------------------------------------------------------------------------|
| private Integer totalRows;                                                     |
| private List&lt;CloudCacheBucket&gt; cloudCacheBucketList = new ArrayList<>(); |

| CloudCacheBucket           |
|----------------------------|
| private String bucketName; |

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

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

```
ncloud vcache getCloudCacheBucketList --regionCode FKR --cloudCacheInstanceNo 821***
```

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

```json
{
  "getCloudCacheBucketListResponse": {
    "requestId": "40cb968e-72ef-42d3-adc3-e392e8f7cc99",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 2,
    "cloudCacheBucketList": [
      {
        "bucketName": "aab***"
      },
      {
        "bucketName": "asdsd****"
      }
    ]
  }
}
```

```xml

<getCloudCacheBucketListResponse>
    <requestId>9f2c90d3-9f6d-4891-af62-780c36949402</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>2</totalRows>
    <cloudCacheBucketList>
        <cloudCacheBucket>
            <bucketName>aab***</bucketName>
        </cloudCacheBucket>
        <cloudCacheBucket>
            <bucketName>asdsd****</bucketName>
        </cloudCacheBucket>
    </cloudCacheBucketList>
</getCloudCacheBucketListResponse>
```

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

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

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

| 파라미터명                | 필수 여부 | 타입     | 제약 사항 | 설명                                                                                                                                                                                                      |
|----------------------|-------|--------|-------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode           | No    | String |       | - 리전 코드<br>Cloud DB for Cache 백업 리스트가 조회될 리전(Region) 결정 가능<br>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능<br>Default : getRegionList 조회 결과의 첫 번째 리전을 선택 |
| cloudRedisInstanceNo | Yes   | String |       | - Cloud DB for Cache 인스턴스 번호<br>cloudRedisInstanceNo는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능                                                            |
| output               | No    | String |       | - 응답 결과의 포맷 타입<br>Options: xml \| json<br>Default: json                                                                                                                                               |

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

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

- CloudRedisBucketList 타입

| CloudRedisBucketList extends CommonResponse                                    |
|--------------------------------------------------------------------------------|
| private Integer totalRows;                                                     |
| private List&lt;CloudRedisBucket&gt; cloudRedisBucketList = new ArrayList<>(); |

| CloudRedisBucket           |
|----------------------------|
| private String bucketName; |

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

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

```
ncloud vredis getCloudRedisBucketList --regionCode FKR --cloudRedisInstanceNo 821***
```

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

```json
{
  "getCloudRedisBucketListResponse": {
    "requestId": "40cb968e-72ef-42d3-adc3-e392e8f7cc99",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 2,
    "cloudRedisBucketList": [
      {
        "bucketName": "aab***"
      },
      {
        "bucketName": "asdsd****"
      }
    ]
  }
}
```

```xml

<getCloudRedisBucketListResponse>
    <requestId>9f2c90d3-9f6d-4891-af62-780c36949402</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>2</totalRows>
    <cloudRedisBucketList>
        <cloudRedisBucket>
            <bucketName>aab***</bucketName>
        </cloudRedisBucket>
        <cloudRedisBucket>
            <bucketName>asdsd****</bucketName>
        </cloudRedisBucket>
    </cloudRedisBucketList>
</getCloudRedisBucketListResponse>
```