---
title: "getCloudCacheBucketList"
slug: "cli-vcache-getcloudcachebucketlist"
updated: 2026-09-17T10:08:39Z
published: 2026-09-17T10:08:39Z
canonical: "cli.ncloud-docs.com/cli-vcache-getcloudcachebucketlist"
---

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

# getCloudCacheBucketList

Available in VPC

Get the list of Object Storage buckets available in Cloud DB for Cache.

              Note

              

Cloud DB for Cache CLI offers two versions based on the supported DBMS range.

- getCloudCacheBucketList CLI: Support for Valkey and Redis DBMS
- getCloudRedisBucketList CLI: Support for Redis DBMS

## getCloudCacheBucketList CLI

This section describes the command syntax, options, commands, and output examples for the getCloudCacheBucketList CLI.

### Syntax

The `getCloudCacheBucketList` syntax is as follows:

```
./ncloud vcache getCloudCacheBucketList \
    --cloudCacheInstanceNo <instance-no> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

### Options

This section describes the options available when running `getCloudCacheBucketList`.

#### Required options

The following options are required for `getCloudCacheBucketList`.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `--cloudCacheInstanceNo` | String | Required | Cloud DB for Cache instance number - See [getCloudCacheInstanceList](/docs/en/cli-vcache-getcloudcacheinstancelist). |

#### Common options

For information about the options common to all `vcache` subcommands, see [Cloud DB for Cache (VPC) options](/docs/en/cli-vcache#%EC%98%B5%EC%85%98).

### Examples

If the request to retrieve the list of Object Storage buckets is successful, the names of the available buckets are returned.

#### Command

The command example is as follows:

```
./ncloud vcache getCloudCacheBucketList \
    --cloudCacheInstanceNo 34567890 \
    --regionCode KR \
    --output json
```

#### Output

The output example is as follows:

```
{
  "getCloudCacheBucketListResponse": {
    "totalRows": 1,
    "cloudCacheBucketList": [
      {
        "bucketName": "my-test-bucket"
      }
    ],
    "requestId": "e5f6a7b8-c9d0-1234-efab-567890123456",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

## getCloudRedisBucketList CLI

This section describes the command syntax, options, commands, and output examples for the getCloudRedisBucketList CLI.

### Syntax

The `getCloudRedisBucketList` syntax is as follows:

```
./ncloud vredis getCloudRedisBucketList \
    --cloudRedisInstanceNo <instance-no> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

### Options

This section describes the options available when running `getCloudRedisBucketList`.

#### Required options

The following options are required for `getCloudRedisBucketList`.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `--cloudRedisInstanceNo` | String | Required | Cloud DB for Cache instance number - See [getCloudCacheInstanceList](/docs/en/cli-vcache-getcloudcacheinstancelist). |

#### Common options

For information about the options common to all `vredis` subcommands, see [Cloud DB for Cache (VPC) options](/docs/en/cli-vcache#%EC%98%B5%EC%85%98).

### Examples

If the request to retrieve the list of Object Storage buckets is successful, the names of the available buckets are returned.

#### Command

The command example is as follows:

```
./ncloud vredis getCloudRedisBucketList \
    --cloudRedisInstanceNo 34567890 \
    --regionCode KR \
    --output json
```

#### Output

The output example is as follows:

```
{
  "getCloudRedisBucketListResponse": {
    "totalRows": 1,
    "cloudRedisBucketList": [
      {
        "bucketName": "my-test-bucket"
      }
    ],
    "requestId": "e5f6a7b8-c9d0-1234-efab-567890123456",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```