Cloud DB for Cache Config Group 목록을 조회합니다.
Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다.
- getCloudCacheConfigGroupList CLI: Valkey, Redis DBMS 이용 가능
- getCloudRedisConfigGroupList CLI: Redis DBMS 이용 가능
getCloudCacheConfigGroupList CLI
getCloudCacheConfigGroupList CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다.
구문
getCloudCacheConfigGroupList 구문은 다음과 같습니다.
./ncloud vcache getCloudCacheConfigGroupList \
[--cloudCacheInstanceNo <instance-no>] \
[--cloudCacheServiceName <service-name>] \
[--configGroupNo <config-group-no>] \
[--configGroupName <config-group-name>] \
[--cloudCacheModeCode <SIMPLE|CLUSTER>] \
[--cloudCacheDbmsCode <Redis|Valkey>] \
[--regionCode <FKR>] \
[--output <json|xml>]
옵션
getCloudCacheConfigGroupList 실행 시 지정할 수 있는 옵션을 설명합니다.
선택 옵션
getCloudCacheConfigGroupList의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--cloudCacheInstanceNo |
String | Optional | Cloud DB for Cache 인스턴스 번호 |
--cloudCacheServiceName |
String | Optional | Cloud DB for Cache 인스턴스 이름 |
--configGroupNo |
String | Optional | Config Group 번호 |
--configGroupName |
String | Optional | Config Group 이름 |
--cloudCacheModeCode |
String | Optional | Cloud DB for Cache 구성
|
--cloudCacheDbmsCode |
String | Optional | Cloud DB for Cache 인스턴스의 DBMS 코드
|
공통 옵션
vcache 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for Cache 옵션을 참조해 주십시오.
예시
Config Group 목록 조회 요청이 성공하면 각 Config Group의 구성 정보가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./ncloud vcache getCloudCacheConfigGroupList \
--cloudCacheInstanceNo 34567890 \
--cloudCacheServiceName test-cache-01 \
--configGroupNo 11099 \
--configGroupName test-cfg-01 \
--cloudCacheModeCode CLUSTER \
--cloudCacheDbmsCode Valkey \
--regionCode FKR \
--output json
출력
출력 예시는 다음과 같습니다.
{
"getCloudCacheConfigGroupListResponse": {
"totalRows": 1,
"cloudCacheConfigGroupList": [
{
"configGroupNo": "11099",
"configGroupName": "test-cfg-01",
"configGroupDescription": "Test cluster config group",
"configGroupStatusName": "running",
"configGroupStatus": {
"code": "RUN",
"codeName": "CONFIG GROUP Running 상태"
},
"cloudCacheVersion": "7.2.11-cluster",
"cloudCacheDbmsCode": "Valkey",
"createDate": "2026-06-22T14:00:32+0900",
"modifyDate": "2026-06-22T14:00:35+0900",
"cloudCacheInstanceNoList": [
"141673651"
]
}
],
"requestId": "cca79bd4-1b4a-4956-a525-310333a76e8c",
"returnCode": "0",
"returnMessage": "success"
}
}
getCloudRedisConfigGroupList CLI
getCloudRedisConfigGroupList CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다.
구문
getCloudRedisConfigGroupList 구문은 다음과 같습니다.
./ncloud vredis getCloudRedisConfigGroupList \
[--cloudRedisInstanceNo <instance-no>] \
[--cloudRedisServiceName <service-name>] \
[--configGroupNo <config-group-no>] \
[--configGroupName <config-group-name>] \
[--cloudRedisModeCode <SIMPLE|CLUSTER>] \
[--regionCode <FKR>] \
[--output <json|xml>]
옵션
getCloudRedisConfigGroupList 실행 시 지정할 수 있는 옵션을 설명합니다.
선택 옵션
getCloudRedisConfigGroupList의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--cloudRedisInstanceNo |
String | Optional | Cloud DB for Cache 인스턴스 번호 |
--cloudRedisServiceName |
String | Optional | Cloud DB for Cache 인스턴스 이름 |
--configGroupNo |
String | Optional | Config Group 번호 |
--configGroupName |
String | Optional | Config Group 이름 |
--cloudRedisModeCode |
String | Optional | Cloud DB for Cache 구성
|
공통 옵션
vredis 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for Cache 옵션을 참조해 주십시오.
예시
Config Group 목록 조회 요청이 성공하면 각 Config Group의 구성 정보가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./ncloud vredis getCloudRedisConfigGroupList \
--cloudRedisInstanceNo 34567890 \
--cloudRedisServiceName test-cache-01 \
--configGroupNo 11099 \
--configGroupName test-cfg-01 \
--cloudRedisModeCode CLUSTER \
--regionCode FKR \
--output json
출력
출력 예시는 다음과 같습니다.
{
"getCloudRedisConfigGroupListResponse": {
"totalRows": 1,
"cloudRedisConfigGroupList": [
{
"configGroupNo": "11099",
"configGroupName": "test-cfg-01",
"configGroupDescription": "Test cluster config group",
"configGroupStatusName": "running",
"configGroupStatus": {
"code": "RUN",
"codeName": "CONFIG GROUP Running 상태"
},
"cloudRedisVersion": "4.0.14-cluster",
"createDate": "2026-06-10T14:45:32+0900",
"modifyDate": "2026-06-10T14:45:35+0900",
"cloudRedisInstanceNoList": [
"34567890"
]
}
],
"requestId": "96bceb85-b1b8-4c6c-bacb-7207a1890af8",
"returnCode": "0",
"returnMessage": "success"
}
}