---
title: "getCloudCacheBucketList"
slug: "cli-vcache-getcloudcachebucketlist"
tags: ["Cloud DB for Cache", "Object Storage"]
updated: 2026-04-23T09:04:56Z
published: 2026-04-23T09:07:31Z
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

## 개요

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

참고

Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다.

- getCloudCacheBucketList CLI: Valkey, Redis DBMS 이용 가능
- getCloudRedisBucketList CLI: Redis DBMS 이용 가능

## getCloudCacheBucketList CLI

getCloudCacheBucketList CLI의 요청, 응답 형식을 설명합니다.

### 요청

#### 요청 파라미터

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

### 응답

#### 응답 데이터 타입

- CloudCacheBucketList 타입

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

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

### 예시

#### 호출 예시

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

#### 응답 예시

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

```

<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

getCloudRedisBucketList CLI의 요청, 응답 형식을 설명합니다.

### 요청

#### 요청 파라미터

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

### 응답

#### 응답 데이터 타입

- CloudRedisBucketList 타입

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

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

### 예시

#### 호출

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

#### 응답

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

```

<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>
```