Available in VPC
Get the list of Object Storage buckets available in Cloud DB for Cache.
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 |
Common options
For information about the options common to all vcache subcommands, see Cloud DB for Cache (VPC) options.
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 |
Common options
For information about the options common to all vredis subcommands, see Cloud DB for Cache (VPC) options.
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"
}
}