--- title: "getCloudMongoDbInstanceList" slug: "cli-vmongodb-getcloudmongodbinstancelist" tags: ["Cloud DB for MongoDB"] updated: 2026-06-25T09:10:29Z published: 2026-06-25T09:10:29Z canonical: "cli-fin.ncloud-docs.com/cli-vmongodb-getcloudmongodbinstancelist" --- > ## 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. # getCloudMongoDbInstanceList ## 개요 Cloud DB for MongoDB 인스턴스 리스트를 조회합니다. ## 요청 ### 요청 파라미터 | 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 | | ----- | ----- | ----- | ----- | ----- | | regionCode | No | String | | - 리전 코드
Cloud DB for MongoDB 인스턴스 리스트가 조회될 리전(Region) 결정 가능
regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능
Default : getRegionList 조회 결과의 첫 번째 리전을 선택 | | zoneCode | No | String | | - ZONE 코드
Cloud DB for MongoDB 인스턴스 리스트가 조회될 Zone을 결정 가능
zoneCode는 [getZoneList](/docs/cli-vserver-server-common-getzonelist) 액션을 통해 획득 가능 | | vpcNo | No | String | | - VPC 번호
Cloud DB for MongoDB 인스턴스 리스트가 조회될 VPC 결정 가능
vpcNo는 [getCloudMongoDbTargetVpcList](/docs/cli-vmongodb-getcloudmongodbtargetvpclist) 액션을 통해 획득 가능 | | subnetNo | No | String | | - Subnet 번호
Cloud DB for MongoDB 인스턴스 리스트가 조회될 Subnet 결정 가능
SubnetNo는 [getCloudMongoDbTargetSubnetList](/docs/cli-vmongodb-getcloudmongodbtargetsubnetlist) 액션을 통해 획득 가능 | | cloudMongoDbServiceName | No | String | | - Cloud DB for MongoDB 서비스 이름
Cloud DB for MongoDB 서비스 이름으로 필터링하여 검색 가능
cloudMongoDbServiceName은 [getCloudMongoDbInstanceList](/docs/cli-vmongodb-getcloudmongodbinstancelist) 액션을 통해 획득 가능 | | cloudMongoDbInstanceNoList | No | List<String> | | - Cloud DB for MongoDB 인스턴스 번호 리스트
Cloud DB for MongoDB 인스턴스 번호로 필터링하여 검색 가능
cloudMongoDbInstanceNoList는 [getCloudMongoDbInstanceList](/docs/cli-vmongodb-getcloudmongodbinstancelist) 액션을 통해 획득 가능
ex) cloudMongoDbInstanceNoList 1234 2345 | | cloudMongoDbServerName | No | String | | - Cloud DB for MongoDB 서버 이름
Cloud DB for MongoDB 서버 이름으로 필터링하여 검색 가능
cloudMongoDbServerName은 [getCloudMongoDbInstanceList](/docs/cli-vmongodb-getcloudmongodbinstancelist) 액션을 통해 획득 가능 | | cloudMongoDbServerInstanceNoList | No | List<String> | | - Cloud DB for MongoDB 서버 인스턴스 번호 리스트
Cloud DB for MongoDB 서버 인스턴스 번호로 필터링하여 검색 가능
cloudMongoDbServerInstanceNoList [getCloudMongoDbInstanceList](/docs/cli-vmongodb-getcloudmongodbinstancelist) 액션을 통해 획득 가능
ex) cloudMongoDbServerInstanceNoList 1234 2345 | | generationCode | No | String | | - 서버 세대 코드
Options: G2 \| G3 | | pageNo | No | Integer | Min: 0 | - 페이징된 결과의 페이지 번호
결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능 | | pageSize | Conditional | Integer | Min: 1 | - 페이징 시 보여줄 각 페이지 사이즈
결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능
pageNo 입력시 반드시 입력함 | | output | No | String | | - 응답 결과의 포맷 타입
Options : xml \| json
Default : json | ## 응답 ### 응답 데이터 타입 - CloudMongoDbInstanceList 타입 | CloudMongoDbInstanceList extends CommonResponse | | ---------- | |private Integer totalRows;| |private List<CloudMongoDbInstance> cloudMongoDbInstanceList = new ArrayList<>();| | CloudMongoDbInstance | | ---------- | | CloudMongoDbInstance | | ---------- | |private String cloudMongoDbInstanceNo;| |private String cloudMongoDbServiceName;| |private String cloudMongoDbInstanceStatusName; | |private CommonCode cloudMongoDbInstanceStatus;| |private CommonCode cloudMongoDbInstanceOperation;| |private String generationCode;| |private String engineVersion;| |private CommonCode licence; | |private Integer backupFileRetentionPeriod; | |private String backupTime;| |private String cloudMongoDbImageProductCode; | |private AccessControlGroupNoList accessControlGroupNoList;| |private Integer shardCount;| |private CommonCode compress;| |private CommonCode clusterType;| |private Integer memberPort;| |private Integer arbiterPort;| |private Integer mongosPort;| |private Integer configPort;| |private Date createDate;| |private List<CloudMongoDbInstance> cloudMongoDbServerInstanceList;| | AccessControlGroupNoList | | ---------- | |private List<String> accessControlGroupNoList = new ArrayList<>(); | | CloudMongoDbServerInstance | | ---------- | |private String cloudMongoDbServerInstanceNo; | |private String cloudMongoDbServerName; | |private CommonCode clusterRole; | |private String cloudMongoDbServerInstanceStatusName;| |private CommonCode cloudMongoDbServerInstanceStatus;| |private CommonCode cloudMongoDbServerInstanceOperation;| |private CommonCode cloudMongoDbServerRole;| |private String regionCode; | |private String vpcNo;| |private String subnetNo;| |private Date createDate;| |private Date uptime;| |private String zoneCode;| |private String privateDomain;| |private String publicDomain;| |private Long memorySize;| |private Integer cpuCount;| |private Long dataStorageSize;| |private Long usedDataStorageSize;| |private String cloudMongoDbProductCode;| |private String replicaSetName;| |private CommonCode dataStorageType;| ## 예시 ### 호출 ``` ncloud vmongodb getCloudMongoDbInstanceList --regionCode FKR --zoneCode FKR-1 --vpcNo ****87 --subnetNo ****32 --cloudMongoDbServiceName test-**** --cloudMongoDbInstanceNoList 178**** --cloudMongoDbServerName test--**** --cloudMongoDbServerInstanceNoList 1781*** --generationCode G2 --pageNo 0 --pageSize 10 ``` ### 응답 ```xml bb5d1f02-604c-453c-adb1-d644b309b91f 0 success 2 178*** test-**** running CREAT CLOUD DATABASE(VPC) Created State NULL CLOUD DATABASE(VPC) Null OP G2 1781*** mg-178****-c-eim CONFIG_SERVER Config Server Cluster Role - Cloud DB For MongoDB running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP C Config Server FKR ***87 ***32 FKR-1 4294967296 2 10737418240 1781*** mg-178****-c-ein CONFIG_SERVER Config Server Cluster Role - Cloud DB For MongoDB running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP C Config Server FKR ***87 ***32 FKR-1 4294967296 2 10737418240 1781*** mg-178****-c-eio CONFIG_SERVER Config Server Cluster Role - Cloud DB For MongoDB running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP C Config Server FKR ***87 ***32 FKR-1 4294967296 2 10737418240 1781*** mg-178****-mb001-eie SHARD Shard Cluster Role - Cloud DB For MongoDB running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP MB Member FKR ***87 ***32 FKR-1 4294967296 2 10737418240 1781*** mg-178****-mb001-eif SHARD Shard Cluster Role - Cloud DB For MongoDB running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP MB Member FKR ***87 ***32 FKR-1 4294967296 2 10737418240 1781*** mg-178****-mb001-eig SHARD Shard Cluster Role - Cloud DB For MongoDB running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP MB Member FKR ***87 ***32 FKR-1 4294967296 2 10737418240 1781*** mg-178****-mb002-eih SHARD Shard Cluster Role - Cloud DB For MongoDB running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP MB Member FKR ***87 ***32 FKR-1 4294967296 2 10737418240 1781*** mg-178****-mb002-eii SHARD Shard Cluster Role - Cloud DB For MongoDB running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP MB Member FKR ***87 ***32 FKR-1 4294967296 2 10737418240 1781*** mg-178****-mb002-eij SHARD Shard Cluster Role - Cloud DB For MongoDB running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP MB Member FKR ***87 ***32 FKR-1 4294967296 2 10737418240 1781*** mg-178****-rt-eik MONGOS Mongos Cluster Role - Cloud DB For MongoDB running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP RT Mongos FKR ***87 ***32 FKR-1 4294967296 2 10737418240 1781*** mg-178****-rt-eil MONGOS Mongos Cluster Role - Cloud DB For MongoDB running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP RT Mongos FKR ***87 ***32 FKR-1 4294967296 2 10737418240 ```