---
title: "getCloudMongoDbInstanceList"
slug: "cli-vmongodb-getcloudmongodbinstancelist"
tags: ["Cloud DB for MongoDB"]
updated: 2026-04-23T09:04:57Z
published: 2026-04-23T09:07:33Z
---

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

### 응답

```

<getCloudMongoDbInstanceListResponse>
    <requestId>bb5d1f02-604c-453c-adb1-d644b309b91f</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>2</totalRows>
    <cloudMongoDbInstanceList>
        <cloudMongoDbInstance>
            <cloudMongoDbInstanceNo>178***</cloudMongoDbInstanceNo>
            <cloudMongoDbServiceName>test-****</cloudMongoDbServiceName>
            <cloudMongoDbInstanceStatusName>running</cloudMongoDbInstanceStatusName>
            <cloudMongoDbInstanceStatus>
                <code>CREAT</code>
                <codeName>CLOUD DATABASE(VPC) Created State</codeName>
            </cloudMongoDbInstanceStatus>
            <cloudMongoDbInstanceOperation>
                <code>NULL</code>
                <codeName>CLOUD DATABASE(VPC) Null OP</codeName>
            </cloudMongoDbInstanceOperation>
            <generationCode>G2</generationCode>
            <cloudMongoDbServerInstanceList>
                <cloudMongoDbServerInstance>
                    <cloudMongoDbServerInstanceNo>1781***</cloudMongoDbServerInstanceNo>
                    <cloudMongoDbServerName>mg-178****-c-eim</cloudMongoDbServerName>
                    <clusterRole>
                        <code>CONFIG_SERVER</code>
                        <codeName>Config Server Cluster Role - Cloud DB For MongoDB</codeName>
                    </clusterRole>
                    <cloudMongoDbServerInstanceStatusName>running</cloudMongoDbServerInstanceStatusName>
                    <cloudMongoDbServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudMongoDbServerInstanceStatus>
                    <cloudMongoDbServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudMongoDbServerInstanceOperation>
                    <cloudMongoDbServerRole>
                        <code>C</code>
                        <codeName>Config Server</codeName>
                    </cloudMongoDbServerRole>
                    <regionCode>FKR</regionCode>
                    <vpcNo>***87</vpcNo>
                    <subnetNo>***32</subnetNo>
                    <zoneCode>FKR-1</zoneCode>
                    <memorySize>4294967296</memorySize>
                    <cpuCount>2</cpuCount>
                    <dataStorageSize>10737418240</dataStorageSize>
                </cloudMongoDbServerInstance>
                <cloudMongoDbServerInstance>
                    <cloudMongoDbServerInstanceNo>1781***</cloudMongoDbServerInstanceNo>
                    <cloudMongoDbServerName>mg-178****-c-ein</cloudMongoDbServerName>
                    <clusterRole>
                        <code>CONFIG_SERVER</code>
                        <codeName>Config Server Cluster Role - Cloud DB For MongoDB</codeName>
                    </clusterRole>
                    <cloudMongoDbServerInstanceStatusName>running</cloudMongoDbServerInstanceStatusName>
                    <cloudMongoDbServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudMongoDbServerInstanceStatus>
                    <cloudMongoDbServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudMongoDbServerInstanceOperation>
                    <cloudMongoDbServerRole>
                        <code>C</code>
                        <codeName>Config Server</codeName>
                    </cloudMongoDbServerRole>
                    <regionCode>FKR</regionCode>
                    <vpcNo>***87</vpcNo>
                    <subnetNo>***32</subnetNo>
                    <zoneCode>FKR-1</zoneCode>
                    <memorySize>4294967296</memorySize>
                    <cpuCount>2</cpuCount>
                    <dataStorageSize>10737418240</dataStorageSize>
                </cloudMongoDbServerInstance>
                <cloudMongoDbServerInstance>
                    <cloudMongoDbServerInstanceNo>1781***</cloudMongoDbServerInstanceNo>
                    <cloudMongoDbServerName>mg-178****-c-eio</cloudMongoDbServerName>
                    <clusterRole>
                        <code>CONFIG_SERVER</code>
                        <codeName>Config Server Cluster Role - Cloud DB For MongoDB</codeName>
                    </clusterRole>
                    <cloudMongoDbServerInstanceStatusName>running</cloudMongoDbServerInstanceStatusName>
                    <cloudMongoDbServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudMongoDbServerInstanceStatus>
                    <cloudMongoDbServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudMongoDbServerInstanceOperation>
                    <cloudMongoDbServerRole>
                        <code>C</code>
                        <codeName>Config Server</codeName>
                    </cloudMongoDbServerRole>
                    <regionCode>FKR</regionCode>
                    <vpcNo>***87</vpcNo>
                    <subnetNo>***32</subnetNo>
                    <zoneCode>FKR-1</zoneCode>
                    <memorySize>4294967296</memorySize>
                    <cpuCount>2</cpuCount>
                    <dataStorageSize>10737418240</dataStorageSize>
                </cloudMongoDbServerInstance>
                <cloudMongoDbServerInstance>
                    <cloudMongoDbServerInstanceNo>1781***</cloudMongoDbServerInstanceNo>
                    <cloudMongoDbServerName>mg-178****-mb001-eie</cloudMongoDbServerName>
                    <clusterRole>
                        <code>SHARD</code>
                        <codeName>Shard Cluster Role - Cloud DB For MongoDB</codeName>
                    </clusterRole>
                    <cloudMongoDbServerInstanceStatusName>running</cloudMongoDbServerInstanceStatusName>
                    <cloudMongoDbServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudMongoDbServerInstanceStatus>
                    <cloudMongoDbServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudMongoDbServerInstanceOperation>
                    <cloudMongoDbServerRole>
                        <code>MB</code>
                        <codeName>Member</codeName>
                    </cloudMongoDbServerRole>
                    <regionCode>FKR</regionCode>
                    <vpcNo>***87</vpcNo>
                    <subnetNo>***32</subnetNo>
                    <zoneCode>FKR-1</zoneCode>
                    <memorySize>4294967296</memorySize>
                    <cpuCount>2</cpuCount>
                    <dataStorageSize>10737418240</dataStorageSize>
                </cloudMongoDbServerInstance>
                <cloudMongoDbServerInstance>
                    <cloudMongoDbServerInstanceNo>1781***</cloudMongoDbServerInstanceNo>
                    <cloudMongoDbServerName>mg-178****-mb001-eif</cloudMongoDbServerName>
                    <clusterRole>
                        <code>SHARD</code>
                        <codeName>Shard Cluster Role - Cloud DB For MongoDB</codeName>
                    </clusterRole>
                    <cloudMongoDbServerInstanceStatusName>running</cloudMongoDbServerInstanceStatusName>
                    <cloudMongoDbServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudMongoDbServerInstanceStatus>
                    <cloudMongoDbServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudMongoDbServerInstanceOperation>
                    <cloudMongoDbServerRole>
                        <code>MB</code>
                        <codeName>Member</codeName>
                    </cloudMongoDbServerRole>
                    <regionCode>FKR</regionCode>
                    <vpcNo>***87</vpcNo>
                    <subnetNo>***32</subnetNo>
                    <zoneCode>FKR-1</zoneCode>
                    <memorySize>4294967296</memorySize>
                    <cpuCount>2</cpuCount>
                    <dataStorageSize>10737418240</dataStorageSize>
                </cloudMongoDbServerInstance>
                <cloudMongoDbServerInstance>
                    <cloudMongoDbServerInstanceNo>1781***</cloudMongoDbServerInstanceNo>
                    <cloudMongoDbServerName>mg-178****-mb001-eig</cloudMongoDbServerName>
                    <clusterRole>
                        <code>SHARD</code>
                        <codeName>Shard Cluster Role - Cloud DB For MongoDB</codeName>
                    </clusterRole>
                    <cloudMongoDbServerInstanceStatusName>running</cloudMongoDbServerInstanceStatusName>
                    <cloudMongoDbServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudMongoDbServerInstanceStatus>
                    <cloudMongoDbServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudMongoDbServerInstanceOperation>
                    <cloudMongoDbServerRole>
                        <code>MB</code>
                        <codeName>Member</codeName>
                    </cloudMongoDbServerRole>
                    <regionCode>FKR</regionCode>
                    <vpcNo>***87</vpcNo>
                    <subnetNo>***32</subnetNo>
                    <zoneCode>FKR-1</zoneCode>
                    <memorySize>4294967296</memorySize>
                    <cpuCount>2</cpuCount>
                    <dataStorageSize>10737418240</dataStorageSize>
                </cloudMongoDbServerInstance>
                <cloudMongoDbServerInstance>
                    <cloudMongoDbServerInstanceNo>1781***</cloudMongoDbServerInstanceNo>
                    <cloudMongoDbServerName>mg-178****-mb002-eih</cloudMongoDbServerName>
                    <clusterRole>
                        <code>SHARD</code>
                        <codeName>Shard Cluster Role - Cloud DB For MongoDB</codeName>
                    </clusterRole>
                    <cloudMongoDbServerInstanceStatusName>running</cloudMongoDbServerInstanceStatusName>
                    <cloudMongoDbServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudMongoDbServerInstanceStatus>
                    <cloudMongoDbServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudMongoDbServerInstanceOperation>
                    <cloudMongoDbServerRole>
                        <code>MB</code>
                        <codeName>Member</codeName>
                    </cloudMongoDbServerRole>
                    <regionCode>FKR</regionCode>
                    <vpcNo>***87</vpcNo>
                    <subnetNo>***32</subnetNo>
                    <zoneCode>FKR-1</zoneCode>
                    <memorySize>4294967296</memorySize>
                    <cpuCount>2</cpuCount>
                    <dataStorageSize>10737418240</dataStorageSize>
                </cloudMongoDbServerInstance>
                <cloudMongoDbServerInstance>
                    <cloudMongoDbServerInstanceNo>1781***</cloudMongoDbServerInstanceNo>
                    <cloudMongoDbServerName>mg-178****-mb002-eii</cloudMongoDbServerName>
                    <clusterRole>
                        <code>SHARD</code>
                        <codeName>Shard Cluster Role - Cloud DB For MongoDB</codeName>
                    </clusterRole>
                    <cloudMongoDbServerInstanceStatusName>running</cloudMongoDbServerInstanceStatusName>
                    <cloudMongoDbServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudMongoDbServerInstanceStatus>
                    <cloudMongoDbServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudMongoDbServerInstanceOperation>
                    <cloudMongoDbServerRole>
                        <code>MB</code>
                        <codeName>Member</codeName>
                    </cloudMongoDbServerRole>
                    <regionCode>FKR</regionCode>
                    <vpcNo>***87</vpcNo>
                    <subnetNo>***32</subnetNo>
                    <zoneCode>FKR-1</zoneCode>
                    <memorySize>4294967296</memorySize>
                    <cpuCount>2</cpuCount>
                    <dataStorageSize>10737418240</dataStorageSize>
                </cloudMongoDbServerInstance>
                <cloudMongoDbServerInstance>
                    <cloudMongoDbServerInstanceNo>1781***</cloudMongoDbServerInstanceNo>
                    <cloudMongoDbServerName>mg-178****-mb002-eij</cloudMongoDbServerName>
                    <clusterRole>
                        <code>SHARD</code>
                        <codeName>Shard Cluster Role - Cloud DB For MongoDB</codeName>
                    </clusterRole>
                    <cloudMongoDbServerInstanceStatusName>running</cloudMongoDbServerInstanceStatusName>
                    <cloudMongoDbServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudMongoDbServerInstanceStatus>
                    <cloudMongoDbServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudMongoDbServerInstanceOperation>
                    <cloudMongoDbServerRole>
                        <code>MB</code>
                        <codeName>Member</codeName>
                    </cloudMongoDbServerRole>
                    <regionCode>FKR</regionCode>
                    <vpcNo>***87</vpcNo>
                    <subnetNo>***32</subnetNo>
                    <zoneCode>FKR-1</zoneCode>
                    <memorySize>4294967296</memorySize>
                    <cpuCount>2</cpuCount>
                    <dataStorageSize>10737418240</dataStorageSize>
                </cloudMongoDbServerInstance>
                <cloudMongoDbServerInstance>
                    <cloudMongoDbServerInstanceNo>1781***</cloudMongoDbServerInstanceNo>
                    <cloudMongoDbServerName>mg-178****-rt-eik</cloudMongoDbServerName>
                    <clusterRole>
                        <code>MONGOS</code>
                        <codeName>Mongos Cluster Role - Cloud DB For MongoDB</codeName>
                    </clusterRole>
                    <cloudMongoDbServerInstanceStatusName>running</cloudMongoDbServerInstanceStatusName>
                    <cloudMongoDbServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudMongoDbServerInstanceStatus>
                    <cloudMongoDbServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudMongoDbServerInstanceOperation>
                    <cloudMongoDbServerRole>
                        <code>RT</code>
                        <codeName>Mongos</codeName>
                    </cloudMongoDbServerRole>
                    <regionCode>FKR</regionCode>
                    <vpcNo>***87</vpcNo>
                    <subnetNo>***32</subnetNo>
                    <zoneCode>FKR-1</zoneCode>
                    <memorySize>4294967296</memorySize>
                    <cpuCount>2</cpuCount>
                    <dataStorageSize>10737418240</dataStorageSize>
                </cloudMongoDbServerInstance>
                <cloudMongoDbServerInstance>
                    <cloudMongoDbServerInstanceNo>1781***</cloudMongoDbServerInstanceNo>
                    <cloudMongoDbServerName>mg-178****-rt-eil</cloudMongoDbServerName>
                    <clusterRole>
                        <code>MONGOS</code>
                        <codeName>Mongos Cluster Role - Cloud DB For MongoDB</codeName>
                    </clusterRole>
                    <cloudMongoDbServerInstanceStatusName>running</cloudMongoDbServerInstanceStatusName>
                    <cloudMongoDbServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudMongoDbServerInstanceStatus>
                    <cloudMongoDbServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudMongoDbServerInstanceOperation>
                    <cloudMongoDbServerRole>
                        <code>RT</code>
                        <codeName>Mongos</codeName>
                    </cloudMongoDbServerRole>
                    <regionCode>FKR</regionCode>
                    <vpcNo>***87</vpcNo>
                    <subnetNo>***32</subnetNo>
                    <zoneCode>FKR-1</zoneCode>
                    <memorySize>4294967296</memorySize>
                    <cpuCount>2</cpuCount>
                    <dataStorageSize>10737418240</dataStorageSize>
                </cloudMongoDbServerInstance>
            </cloudMongoDbServerInstanceList>
        </cloudMongoDbInstance>
    </cloudMongoDbInstanceList>
</getCloudMongoDbInstanceListResponse>
```