---
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
```