--- title: "getCloudCacheInstanceList" slug: "cli-vcache-getcloudcacheinstancelist" tags: ["Cloud DB for Cache"] updated: 2026-06-25T09:10:27Z published: 2026-06-25T09:10:27Z canonical: "cli-fin.ncloud-docs.com/cli-vcache-getcloudcacheinstancelist" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # getCloudCacheInstanceList ## 개요 Cloud DB for Cache 인스턴스 리스트를 조회합니다. :::(info) (참고) Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다. * getCloudCacheInstanceList CLI: Valkey, Redis DBMS 이용 가능 * getCloudRedisInstanceList CLI: Redis DBMS 이용 가능 ::: ## getCloudCacheInstanceList CLI getCloudCacheInstanceList CLI의 요청, 응답 형식을 설명합니다. ### 요청 #### 요청 파라미터 | 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 | |--------------------------------|-------------|--------------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | regionCode | No | String | | - 리전 코드
Cloud DB for Cache 인스턴스 리스트가 조회될 리전(Region) 결정 가능
regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능
Default : getRegionList 조회 결과의 첫 번째 리전을 선택 | | zoneCode | No | String | | - ZONE 코드
Cloud DB for Cache 인스턴스 리스트가 조회될 Zone 결정 가능
zoneCode는 [getZoneList](/docs/cli-vserver-server-common-getzonelist) 액션을 통해 획득 가능 | | vpcNo | No | String | | - VPC 번호
Cloud DB for Cache 인스턴스 리스트가 조회될 VPC 결정 가능
vpcNo는 [getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 액션을 통해 획득 가능 | | subnetNo | No | String | | - Subnet 번호
Cloud DB for Cache 인스턴스 리스트가 조회될 Subnet 결정 가능
SubnetNo는 [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 액션을 통해 획득 가능 | | cloudCacheServiceName | No | String | | - Cloud DB for Cache 서비스 이름
Cloud DB for Cache 서비스 이름으로 필터링하여 검색 가능
cloudCacheServiceName은 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해 획득 가능 | | cloudCacheInstanceNoList | No | List<String> | | - Cloud DB for Cache 인스턴스 번호 리스트
Cloud DB for Cache 인스턴스 번호로 필터링하여 검색 가능
cloudCacheInstanceNoList는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해 획득 가능
ex) cloudCacheInstanceNoList 1234 2345 | | cloudCacheServerName | No | String | | - Cloud DB for Cache 서버 이름
Cloud DB for Cache 서버 이름으로 필터링하여 검색 가능
cloudCacheServerName은 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해 획득 가능 | cloudCacheServerInstanceNoList | No | List<String> | | - Cloud DB for Cache 서버 인스턴스 번호 리스트
Cloud DB for Cache 서버 인스턴스 번호로 필터링하여 검색 가능
cloudCacheServerInstanceNoList [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해 획득 가능
ex) cloudCacheServerInstanceNoList 1234 2345 | | generationCode | No | String | | - 서버 세대 코드
options: G2 | | pageNo | No | Integer | Min: 0 | - 페이징된 결과의 페이지 번호
결괏값을 pageNo, pageSize를 이용하여 페이징 처리 가능 | | pageSize | Conditional | Integer | Min: 1 | - 페이징 시 보여줄 각 페이지 사이즈
결괏값을 pageNo, pageSize를 이용하여 페이징 처리 가능
pageNo 입력시 반드시 입력 바람 | | cloudCacheDbmsCode | No | String | | Cloud DB for Cache 인스턴스의 DBMS 코드
Options: Redis \| Valkey | | output | No | String | | - 응답 결과의 포맷 타입
Options : xml \| json
Default : json | ### 응답 #### 응답 데이터 타입 - CloudCacheInstanceList 타입 | CloudCacheInstanceList extends CommonResponse | |------------------------------------------------------------------------------------| | private Integer totalRows; | | private List<CloudCacheInstance> cloudCacheInstanceList = new ArrayList<>(); | | CloudCacheInstance | |----------------------------------------------------------------------| | private String cloudCacheInstanceNo; | | private String cloudCacheDbmsCode; | | private String cloudCacheServiceName; | | private String cloudCacheInstanceStatusName; | | private CommonCode cloudCacheInstanceStatus; | | private CommonCode cloudCacheInstanceOperation; | | private String cloudCacheImageProductCode; | | private String engineVersion; | | private CommonCode licence; | | private Integer cloudCachePort; | | private Boolean isHa; | | private String cloudCacheServerPrefix; | | private Boolean isBackup; | | private Integer backupFileRetentionPeriod; | | private String backupTime; | | private String backupSchedule; | | private String generationCode; | | private Date createDate; | | private Integer shardCount; | | private Integer shardCopyCount; | | private AccessControlGroupNoList accessControlGroupNoList; | | private String configGroupNo; | | private String configGroupName; | | private CommonCode role; | | private List<CloudCacheInstance> cloudCacheServerInstanceList; | | AccessControlGroupNoList | |--------------------------------------------------------------------------| | private List<String> accessControlGroupNoList = new ArrayList<>(); | | CloudCacheServerInstance | |-------------------------------------------------------| | private String cloudCacheServerInstanceNo; | | private String cloudCacheServerName; | | private CommonCode cloudCacheServerRole; | | private String cloudCacheServerInstanceStatusName; | | private CommonCode cloudCacheServerInstanceStatus; | | private CommonCode cloudCacheServerInstanceOperation; | | private String cloudCacheProductCode; | | private String regionCode; | | private String zoneCode; | | private String vpcNo; | | private String subnetNo; | | private String privateDomain; | | private Integer cpuCount; | | private Long memorySize; | | private Long osMemorySize; | | private Date uptime; | | private Date createDate; | | private String slotName; | ### 예시 #### 호출 ``` ncloud vcache getCloudCacheInstanceList --regionCode FKR --zoneCode FKR-1 --vpcNo ****65 --subnetNo ****92 --cloudCacheServiceName test-**** --cloudCacheInstanceNoList ****890 --cloudCacheServerName test--**** --cloudCacheServerInstanceNoList ****518 --pageNo 0 --pageSize 10 --generationCode G2 --cloudCacheDbmsCode Redis ``` #### 응답 ```xml 61afef97-c2fa-492e-98ad-a04125d46f9c 0 success 1 182**** Redis test-**** running CREAT CLOUD DATABASE(VPC) Created State NULL CLOUD DATABASE(VPC) Null OP false SIMPLE CLOUD CACHE(VPC) Cluster Role G2 182**** test-******-001-j4a A Stand Alone running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP FKR FKR-1 1665 1792 4 1610612736 ``` ## getCloudRedisInstanceList CLI getCloudRedisInstanceList CLI의 요청, 응답 형식을 설명합니다. ### 요청 #### 요청 파라미터 | 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 | |--------------------------------|-------------|--------------------|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | regionCode | No | String | | - 리전 코드
Cloud DB for Cache 인스턴스 리스트가 조회될 리전(Region) 결정 가능
regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능
Default : getRegionList 조회 결과의 첫 번째 리전을 선택 | | zoneCode | No | String | | - ZONE 코드
Cloud DB for Cache 인스턴스 리스트가 조회될 Zone을 결정 가능
zoneCode는 [getZoneList](/docs/cli-vserver-server-common-getzonelist) 액션을 통해서 획득 가능 | | vpcNo | No | String | | - VPC 번호
Cloud DB for Cache 인스턴스 리스트가 조회될 VPC 결정
vpcNo는 [getCloudCacheTargetVpcList](/docs/cli-vcache-getcloudcachetargetvpclist) 액션을 통해서 획득 가능 | | subnetNo | No | String | | - Subnet 번호
Cloud DB for Cache 인스턴스 리스트가 조회될 Subnet을 결정 가능
SubnetNo는 [getCloudCacheTargetSubnetList](/docs/cli-vcache-getcloudcachetargetsubnetlist) 액션을 통해서 획득 가능 | | cloudRedisServiceName | No | String | | - Cloud DB for Cache 서비스 이름
Cloud DB for Cache 서비스 이름으로 필터링하여 검색 가능
cloudRedisServiceName은 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능 | | cloudRedisInstanceNoList | No | List<String> | | - Cloud DB for Cache 인스턴스 번호 리스트
Cloud DB for Cache 인스턴스 번호로 필터링하여 검색 가능
cloudRedisInstanceNoList는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능
ex) cloudRedisInstanceNoList 1234 2345 | | cloudRedisServerName | No | String | | - Cloud DB for Cache 서버 이름
Cloud DB for Cache 서버 이름으로 필터링하여 검색 가능.
cloudRedisServerName은 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능 | | cloudRedisServerInstanceNoList | No | List<String> | | - Cloud DB for Cache 서버 인스턴스 번호 리스트
Cloud DB for Cache 서버 인스턴스 번호로 필터링하여 검색 가능
cloudRedisServerInstanceNoList [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능
ex) cloudRedisServerInstanceNoList 1234 2345 | | generationCode | No | String | | - 서버 세대 코드
options: G2 | | pageNo | No | Integer | Min: 0 | - 페이징된 결과의 페이지 번호
결괏값을 pageNo, pageSize를 이용하여 페이징 처리 가능 | | pageSize | Conditional | Integer | Min: 1 | - 페이징 시 보여줄 각 페이지 사이즈
결괏값을 pageNo, pageSize를 이용하여 페이징 처리 가능
pageNo 입력시 반드시 입력 | | output | No | String | | - 응답 결과의 포맷 타입
Options : xml \| json
Default : json | ### 응답 #### 응답 데이터 타입 - CloudRedisInstanceList 타입 | CloudRedisInstanceList extends CommonResponse | |------------------------------------------------------------------------------------| | private Integer totalRows; | | private List<CloudRedisInstance> cloudRedisInstanceList = new ArrayList<>(); | | CloudRedisInstance | |----------------------------------------------------------------------| | private String cloudRedisInstanceNo; | | private String cloudRedisServiceName; | | private String cloudRedisInstanceStatusName; | | private CommonCode cloudRedisInstanceStatus; | | private CommonCode cloudRedisInstanceOperation; | | private String cloudRedisImageProductCode; | | private String engineVersion; | | private CommonCode licence; | | private Integer cloudRedisPort; | | private Boolean isHa; | | private String cloudRedisServerPrefix; | | private Boolean isBackup; | | private Integer backupFileRetentionPeriod; | | private String backupTime; | | private String backupSchedule; | | private String generationCode; | | private Date createDate; | | private Integer shardCount; | | private Integer shardCopyCount; | | private AccessControlGroupNoList accessControlGroupNoList; | | private String configGroupNo; | | private String configGroupName; | | private CommonCode role; | | private List<CloudRedisInstance> cloudRedisServerInstanceList; | | AccessControlGroupNoList | |--------------------------------------------------------------------------| | private List<String> accessControlGroupNoList = new ArrayList<>(); | | CloudRedisServerInstance | |-------------------------------------------------------| | private String cloudRedisServerInstanceNo; | | private String cloudRedisServerName; | | private CommonCode cloudRedisServerRole; | | private String cloudRedisServerInstanceStatusName; | | private CommonCode cloudRedisServerInstanceStatus; | | private CommonCode cloudRedisServerInstanceOperation; | | private String cloudRedisProductCode; | | private String regionCode; | | private String zoneCode; | | private String vpcNo; | | private String subnetNo; | | private String privateDomain; | | private Integer cpuCount; | | private Long memorySize; | | private Long osMemorySize; | | private Date uptime; | | private Date createDate; | | private String slotName; | ### 예시 #### 호출 ``` ncloud vredis getCloudRedisInstanceList --regionCode FKR --zoneCode FKR-1 --vpcNo ****65 --subnetNo ****92 --cloudRedisServiceName test-**** --cloudRedisInstanceNoList ****890 --cloudRedisServerName test--**** --cloudRedisServerInstanceNoList ****518 --pageNo 0 --pageSize 10 --generationCode G2 ``` #### 응답 ```xml 722951df-d6d8-45a5-b3e1-7a16df4670f8 0 success 1 ****890 test-**** running CREAT CLOUD DATABASE(VPC) Created State NULL CLOUD DATABASE(VPC) Null OP false CLUSTER CLOUD REDIS(VPC) Cluster Role G2 ****518 test-****-001-001-ehs M Master running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP FKR FKR-1 ****65 ****92 redisc-*****-fkr.cdb.fin-ntruss.com 4 1610612736 ****616 test-****-002-001-eht M Master running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP FKR FKR-1 ****65 ****92 redisc-*****-fkr.cdb.fin-ntruss.com 4 1610612736 ****619 test-****-003-001-ehu M Master running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP FKR FKR-1 ****65 ****92 redisc-*****-fkr.cdb.fin-ntruss.com 4 1610612736 ****622 test-****-001-002-ehv S Slave running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP FKR FKR-1 ****65 ****92 redisc-*****-fkr.cdb.fin-ntruss.com 4 1610612736 ****625 test-****-002-002-ehw S Slave running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP FKR FKR-1 ****65 ****92 redisc-*****-fkr.cdb.fin-ntruss.com 4 1610612736 ****628 test-****-003-002-ehx S Slave running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP FKR FKR-1 ****65 ****92 redisc-*****-fkr.cdb.fin-ntruss.com 4 1610612736 ```