--- title: "getCloudCacheConfigGroupList" slug: "database-vcache-getcloudcacheconfiggrouplist" tags: ["Cloud DB for Cache"] updated: 2026-09-17T09:16:23Z published: 2026-09-17T09:16:23Z canonical: "api.ncloud-docs.com/database-vcache-getcloudcacheconfiggrouplist" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # getCloudCacheConfigGroupList VPC 환경에서 이용 가능합니다. Cloud DB for Cache Config Group 리스트를 조회합니다. 참고 Cloud DB for Cache API는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다. - getCloudCacheConfigGroupList API: Valkey, Redis DBMS 이용 가능 - getCloudRedisConfigGroupList API: Redis DBMS 이용 가능 ## getCloudCacheConfigGroupList API getCloudCacheConfigGroupList API의 요청, 응답 형식을 설명합니다. ### 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | GET \| POST | /vcache/v2/getCloudCacheConfigGroupList | 참고 가이드는 GET 방식 기준으로 안내합니다. POST 방식의 호출 테스트는 네이버 클라우드 플랫폼 콘솔의 API Gateway 서비스에서 Swagger를 통해서 가능합니다. ### 요청 헤더 Cloud DB for Cache (VPC) API에서 공통으로 사용하는 헤더에 대한 정보는 [Cloud DB for Cache (VPC) 요청 헤더](/docs/database-vcache#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. #### 요청 쿼리 파라미터 요청 쿼리 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `regionCode` | String | Optional | 조회할 Cloud DB for Cache Config Group 리스트의 리전 코드 - [getRegionList](/docs/compute-vserver-server-common-getregionlist) 참조 - `getRegionList` 조회 결과의 첫 번째 리전(기본값) | | `cloudCacheInstanceNo` | String | Optional | Cloud DB for Cache 인스턴스 번호로 필터링 - [getCloudCacheInstanceList](/docs/database-vcache-getcloudcacheinstancelist) 참조 | | `cloudCacheServiceName` | String | Optional | Cloud DB for Cache 인스턴스 이름으로 필터링 - [getCloudCacheInstanceList](/docs/database-vcache-getcloudcacheinstancelist) 참조 | | `configGroupNo` | String | Optional | Config Group 번호로 필터링 - [getCloudCacheConfigGroupList](/docs/database-vcache-getcloudcacheconfiggrouplist) 참조 | | `configGroupName` | String | Optional | Config Group 이름으로 필터링 - [getCloudCacheConfigGroupList](/docs/database-vcache-getcloudcacheconfiggrouplist) 참조 | | `cloudCacheImageProductCode` | String | Optional | 조회할 Config Group의 버전에 해당하는 Cloud Cache 이미지 상품 코드로 필터링 - [getCloudCacheImageProductList](/docs/database-vcache-getcloudcacheimageproductlist) 참조 | | `cloudCacheModeCode` | String | Optional | Cloud DB for Cache 구성Cloud DB for Cache의 구성 유형으로 필터링 - `SIMPLE` \| `CLUSTER` - [getCloudCacheInstanceList](/docs/database-vcache-getcloudcacheinstancelist) 참조 | | `cloudCacheDbmsCode` | String | Optional | Cloud DB for Cache 인스턴스의 DBMS 코드 - `Redis` \| `Valkey` | | `responseFormatType` | String | Optional | 응답 결과의 형식 - `xml` (기본값) \| `json` | #### 요청 예시 요청 예시는 다음과 같습니다. ``` curl --location --request GET 'https://ncloud.apigw.ntruss.com/vcache/v2/getCloudCacheConfigGroupList ?regionCode=KR &cloudCacheInstanceNo=****511 &cloudCacheServiceName=test-**** &configGroupNo=***9 &configGroupName=test-***-config &cloudCacheImageProductCode=SW.VRDS.OS.LNX64.ROCKY.0810.VALKY.B050 &cloudCacheModeCode=SIMPLE' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ### 응답 응답 형식을 설명합니다. #### 응답 바디 응답 바디는 [CloudCacheConfigGroupList](/docs/common-vapidatatype-cloudcacheconfiggrouplist)를 참조해 주십시오. #### 응답 상태 코드 Cloud DB for Cache (VPC) API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Cloud DB for Cache (VPC) 응답 상태 코드](/docs/database-vcache#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. #### 응답 예시 응답 예시는 다음과 같습니다. - `responseFormatType=json` 일 때 ``` { "getCloudCacheConfigGroupListResponse": { "totalRows": 1, "cloudCacheConfigGroupList": [ { "configGroupNo": "***9", "configGroupName": "test-***-config", "configGroupDescription": "decription", "configGroupStatusName": "running", "configGroupStatus": { "code": "RUN", "codeName": "CONFIG GROUP Running 상태" }, "cloudCacheVersion": "7.2.11-simple", "cloudCacheDbmsCode": "Redis", "createDate": "2024-07-01T16:36:38+0900", "modifyDate": "2024-07-01T16:36:40+0900", "cloudCacheInstanceNoList": [ "****511" ] } ], "requestId": "8d112bd6-****-****-****-ab3793ad0676", "returnCode": "0", "returnMessage": "success" } } ``` - `responseFormatType=xml` (기본값) 일 때 ``` 8d112bd6-****-****-****-ab3793ad0676 0 success 1 ***9 test-***-config decription running RUN CONFIG GROUP Running 상태 7.2.11-simple Valkey 2024-07-01T16:36:38+0900 2024-07-01T16:36:40+0900 ****511 ``` ## getCloudRedisConfigGroupList API getCloudRedisConfigGroupList API의 요청, 응답 형식을 설명합니다. ### 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | GET \| POST | /vredis/v2/getCloudRedisConfigGroupList | 참고 가이드는 GET 방식 기준으로 안내합니다. POST 방식의 호출 테스트는 네이버 클라우드 플랫폼 콘솔의 API Gateway 서비스에서 Swagger를 통해서 가능합니다. ### 요청 헤더 Cloud DB for Cache API에서 공통으로 사용하는 헤더에 대한 정보는 [Cloud DB for Cache 요청 헤더](/docs/database-vcache#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. #### 요청 쿼리 파라미터 요청 쿼리 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `regionCode` | String | Optional | 조회할 Cloud DB for Cache Config Group 리스트의 리전 코드 - [getRegionList](/docs/compute-vserver-server-common-getregionlist) 참조 - `getRegionList` 조회 결과의 첫 번째 리전(기본값) | | `cloudRedisInstanceNo` | String | Optional | Cloud DB for Cache 인스턴스 번호로 필터링 - [getCloudCacheInstanceList](/docs/database-vcache-getcloudcacheinstancelist) 참조 | | `cloudRedisServiceName` | String | Optional | Cloud DB for Cache 인스턴스 이름으로 필터링 - [getCloudCacheInstanceList](/docs/database-vcache-getcloudcacheinstancelist) 참조 | | `configGroupNo` | String | Optional | Config Group 번호로 필터링 - [getCloudCacheConfigGroupList](/docs/database-vcache-getcloudcacheconfiggrouplist) 참조 | | `configGroupName` | String | Optional | Config Group 이름으로 필터링 - [getCloudCacheConfigGroupList](/docs/database-vcache-getcloudcacheconfiggrouplist) 참조 | | `cloudRedisImageProductCode` | String | Optional | 조회할 Config Group의 버전에 해당하는 Cloud Redis 이미지 상품 코드로 필터링 - [getCloudCacheImageProductList](/docs/database-vcache-getcloudcacheimageproductlist) 참조 | | `cloudRedisModeCode` | String | Optional | Cloud DB for Cache 구성Cloud DB for Cache의 구성 유형으로 필터링 - `CLUSTER` \| `SIMPLE` - [getCloudCacheInstanceList](/docs/database-vcache-getcloudcacheinstancelist) 참조 | | `responseFormatType` | String | Optional | 응답 결과의 형식 - `xml` (기본값) \| `json` | #### 요청 예시 요청 예시는 다음과 같습니다. ``` curl --location --request GET 'https://ncloud.apigw.ntruss.com/vredis/v2/getCloudRedisConfigGroupList ?regionCode=KR &cloudRedisInstanceNo=****511 &cloudRedisServiceName=test-**** &configGroupNo=***9 &configGroupName=test-***-config &cloudRedisImageProductCode=SW.VDBAS.VRDS.LNX64.CNTOS.0708.REDIS.7015.B050 &cloudRedisModeCode=CLUSTER' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ### 응답 응답 형식을 설명합니다. #### 응답 바디 응답 바디는 [ConfigGroupList](/docs/common-vapidatatype-cloudredisconfiggrouplist)를 참조해 주십시오. #### 응답 상태 코드 Cloud DB for Cache (VPC) API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Cloud DB for Cache (VPC) 응답 상태 코드](/docs/database-vcache#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. #### 응답 예시 응답 예시는 다음과 같습니다. - `responseFormatType=json` 일 때 ``` { "getCloudRedisConfigGroupListResponse": { "totalRows": 1, "cloudRedisConfigGroupList": [ { "configGroupNo": "***9", "configGroupName": "test-***-config", "configGroupDescription": "decription", "configGroupStatusName": "running", "configGroupStatus": { "code": "RUN", "codeName": "CONFIG GROUP Running State" }, "cloudRedisVersion": "7.0.15-cluster", "createDate": "2024-07-01T16:36:38+0900", "modifyDate": "2024-07-01T16:36:40+0900", "cloudRedisInstanceNoList": [ "****511" ] } ], "requestId": "8d112bd6-****-****-****-ab3793ad0676", "returnCode": "0", "returnMessage": "success" } } ``` - `responseFormatType=xml` (기본값) 일 때 ``` 8d112bd6-****-****-****-ab3793ad0676 0 success 1 ***9 test-***-config decription running RUN CONFIG GROUP Running State 7.0.15-cluster 2024-07-01T16:36:38+0900 2024-07-01T16:36:40+0900 ****511 ```