--- title: "getCloudCacheInstanceList" slug: "cli-vcache-getcloudcacheinstancelist" tags: ["Cloud DB for Cache"] updated: 2026-10-22T09:07:19Z published: 2026-10-22T09:07:19Z canonical: "cli-gov.ncloud-docs.com/cli-vcache-getcloudcacheinstancelist" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # getCloudCacheInstanceList VPC 환경에서 이용 가능합니다. Cloud DB for Cache 인스턴스 목록을 조회합니다. 참고 Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다. - getCloudCacheInstanceList CLI: Valkey, Redis DBMS 이용 가능 - getCloudRedisInstanceList CLI: Redis DBMS 이용 가능 ## getCloudCacheInstanceList CLI getCloudCacheInstanceList CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다. ### 구문 `getCloudCacheInstanceList` 구문은 다음과 같습니다. ``` ./ncloud vcache getCloudCacheInstanceList \ [--zoneCode ] \ [--vpcNo ] \ [--subnetNo ] \ [--cloudCacheServiceName ] \ [--cloudCacheInstanceNoList ] \ [--cloudCacheServerName ] \ [--cloudCacheServerInstanceNoList ] \ [--generationCode ] \ [--cloudCacheDbmsCode ] \ [--pageNo ] \ [--pageSize ] \ [--regionCode ] \ [--output ] ``` ### 옵션 `getCloudCacheInstanceList` 실행 시 지정할 수 있는 옵션을 설명합니다. #### 필수 옵션 `getCloudCacheInstanceList`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--pageSize` | Integer | Conditional | 페이지당 항목 수 - `1`~N - `pageNo` 입력 시 필수 입력 | #### 선택 옵션 `getCloudCacheInstanceList`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--zoneCode` | String | Optional | 존 코드 - [getZoneList](/docs/cli-vserver-server-common-getzonelist) 참조 | | `--vpcNo` | String | Optional | VPC 번호 - [getCloudCacheTargetVpcList](/docs/cli-vcache-getcloudcachetargetvpclist) 참조 | | `--subnetNo` | String | Optional | Subnet 번호 - [getCloudCacheTargetSubnetList](/docs/cli-vcache-getcloudcachetargetsubnetlist) 참조 | | `--cloudCacheServiceName` | String | Optional | Cloud DB for Cache 서비스 이름 | | `--cloudCacheInstanceNoList` | List | Optional | Cloud DB for Cache 인스턴스 번호 목록 - 공백으로 구분하여 여러 개 입력 가능 (예시: `--cloudCacheInstanceNoList 1234 2345`) | | `--cloudCacheServerName` | String | Optional | Cloud DB for Cache 서버 이름 | | `--cloudCacheServerInstanceNoList` | List | Optional | Cloud DB for Cache 서버 인스턴스 번호 목록 - 공백으로 구분하여 여러 개 입력 가능 (예시: `--cloudCacheServerInstanceNoList 1234 2345`) | | `--generationCode` | String | Optional | 서버 세대 코드 - `G2` \| `G3` | | `--cloudCacheDbmsCode` | String | Optional | Cloud DB for Cache 인스턴스의 DBMS 코드 - `Redis` \| `Valkey` | | `--pageNo` | Integer | Optional | 페이지 번호 - `0`~N | #### 공통 옵션 `vcache` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud DB for Cache 옵션](/docs/database-vcache#%EC%98%B5%EC%85%98)을 참조해 주십시오. ### 예시 Cloud DB for Cache 인스턴스 목록 조회 요청이 성공하면 각 인스턴스의 구성 정보와 상태가 반환됩니다. #### 명령 명령 예시는 다음과 같습니다. ``` ./ncloud vcache getCloudCacheInstanceList \ --zoneCode KR-1 \ --vpcNo 12345678 \ --subnetNo 23456789 \ --cloudCacheServiceName test-cache-01 \ --cloudCacheInstanceNoList 34567890 \ --generationCode G2 \ --cloudCacheDbmsCode Valkey \ --pageNo 0 \ --pageSize 10 \ --regionCode KR \ --output json ``` #### 출력 출력 예시는 다음과 같습니다. ``` { "getCloudCacheInstanceListResponse": { "totalRows": 1, "cloudCacheInstanceList": [ { "cloudCacheInstanceNo": "34567890", "cloudCacheServiceName": "test-cache-01", "cloudCacheInstanceStatusName": "running", "cloudCacheInstanceStatus": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Created 상태" }, "cloudCacheInstanceOperation": { "code": "NULL", "codeName": "CLOUD DATABASE(VPC) Null OP" }, "isHa": false, "generationCode": "G2", "role": { "code": "SIMPLE", "codeName": "Cluster Role-CLOUD Cache(VPC)" }, "cloudCacheServerInstanceList": [ { "cloudCacheServerInstanceNo": "34567891", "cloudCacheServerName": "testcache-001-4r98", "cloudCacheServerRole": { "code": "A", "codeName": "Stand Alone" }, "cloudCacheServerInstanceStatusName": "running", "cloudCacheServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태" }, "cloudCacheServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) 서버 Null OP" }, "regionCode": "KR", "zoneCode": "KR-1", "vpcNo": "12345678", "subnetNo": "23456789", "cpuCount": 4, "memorySize": 1610612736 } ] } ], "requestId": "db12f98b-1837-42ea-ae10-091e2f7bb978", "returnCode": "0", "returnMessage": "success" } } ``` ## getCloudRedisInstanceList CLI getCloudRedisInstanceList CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다. ### 구문 `getCloudRedisInstanceList` 구문은 다음과 같습니다. ``` ./ncloud vredis getCloudRedisInstanceList \ [--zoneCode ] \ [--vpcNo ] \ [--subnetNo ] \ [--cloudRedisServiceName ] \ [--cloudRedisInstanceNoList ] \ [--cloudRedisServerName ] \ [--cloudRedisServerInstanceNoList ] \ [--generationCode ] \ [--pageNo ] \ [--pageSize ] \ [--regionCode ] \ [--output ] ``` ### 옵션 `getCloudRedisInstanceList` 실행 시 지정할 수 있는 옵션을 설명합니다. #### 필수 옵션 `getCloudRedisInstanceList`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--pageSize` | Integer | Conditional | 페이지당 항목 수 - `1`~N - `pageNo` 입력 시 필수 입력 | #### 선택 옵션 `getCloudRedisInstanceList`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--zoneCode` | String | Optional | 존 코드 - [getZoneList](/docs/cli-vserver-server-common-getzonelist) 참조 | | `--vpcNo` | String | Optional | VPC 번호 - [getCloudCacheTargetVpcList](/docs/cli-vcache-getcloudcachetargetvpclist) 참조 | | `--subnetNo` | String | Optional | Subnet 번호 - [getCloudCacheTargetSubnetList](/docs/cli-vcache-getcloudcachetargetsubnetlist) 참조 | | `--cloudRedisServiceName` | String | Optional | Cloud DB for Cache 서비스 이름 | | `--cloudRedisInstanceNoList` | List | Optional | Cloud DB for Cache 인스턴스 번호 목록 - 공백으로 구분하여 여러 개 입력 가능 (예시: `--cloudRedisInstanceNoList 1234 2345`) | | `--cloudRedisServerName` | String | Optional | Cloud DB for Cache 서버 이름 | | `--cloudRedisServerInstanceNoList` | List | Optional | Cloud DB for Cache 서버 인스턴스 번호 목록 - 공백으로 구분하여 여러 개 입력 가능 (예시: `--cloudRedisServerInstanceNoList 1234 2345`) | | `--generationCode` | String | Optional | 서버 세대 코드 - `G2` \| `G3` | | `--pageNo` | Integer | Optional | 페이지 번호 - `0`~N | #### 공통 옵션 `vredis` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud DB for Cache 옵션](/docs/database-vcache#%EC%98%B5%EC%85%98)을 참조해 주십시오. ### 예시 Cloud DB for Cache 인스턴스 목록 조회 요청이 성공하면 각 인스턴스의 구성 정보와 상태가 반환됩니다. #### 명령 명령 예시는 다음과 같습니다. ``` ./ncloud vredis getCloudRedisInstanceList \ --zoneCode KR-1 \ --vpcNo 12345678 \ --subnetNo 23456789 \ --cloudRedisServiceName test-redis-01 \ --cloudRedisInstanceNoList 34567890 \ --generationCode G2 \ --pageNo 0 \ --pageSize 10 \ --regionCode KR \ --output json ``` #### 출력 출력 예시는 다음과 같습니다. ``` { "getCloudRedisInstanceListResponse": { "totalRows": 1, "cloudRedisInstanceList": [ { "cloudRedisInstanceNo": "34567890", "cloudRedisServiceName": "test-redis-01", "cloudRedisInstanceStatusName": "running", "cloudRedisInstanceStatus": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Created 상태" }, "cloudRedisInstanceOperation": { "code": "NULL", "codeName": "CLOUD DATABASE(VPC) Null OP" }, "isHa": false, "generationCode": "G2", "role": { "code": "SIMPLE", "codeName": "Cluster Role-CLOUD Cache(VPC)" }, "cloudRedisServerInstanceList": [ { "cloudRedisServerInstanceNo": "34567891", "cloudRedisServerName": "testredis-001-4ra8", "cloudRedisServerRole": { "code": "A", "codeName": "Stand Alone" }, "cloudRedisServerInstanceStatusName": "running", "cloudRedisServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태" }, "cloudRedisServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) 서버 Null OP" }, "regionCode": "KR", "zoneCode": "KR-1", "vpcNo": "12345678", "subnetNo": "23456789", "cpuCount": 4, "memorySize": 1610612736 } ] } ], "requestId": "e53cd3fd-f731-4362-8f25-8b01e5cc7774", "returnCode": "0", "returnMessage": "success" } } ```