Cloud DB for MongoDB 인스턴스를 생성합니다.
구문
createCloudMongoDbInstance 구문은 다음과 같습니다.
./ncloud vmongodb createCloudMongoDbInstance \
--vpcNo <vpc-no> \
--subnetNo <subnet-no> \
--cloudMongoDbServiceName <service-name> \
--cloudMongoDbServerNamePrefix <server-name-prefix> \
--clusterTypeCode <STAND_ALONE|SINGLE_REPLICA_SET|SHARDED_CLUSTER> \
--cloudMongoDbUserName <user-name> \
--cloudMongoDbUserPassword <user-password> \
[--cloudMongoDbImageProductCode <image-product-code>] \
[--memberProductCode <member-product-code>] \
[--arbiterProductCode <arbiter-product-code>] \
[--mongosProductCode <mongos-product-code>] \
[--configProductCode <config-product-code>] \
[--shardCount <shard-count>] \
[--memberServerCount <member-server-count>] \
[--arbiterServerCount <arbiter-server-count>] \
[--mongosServerCount <mongos-server-count>] \
[--configServerCount <config-server-count>] \
[--engineVersionCode <engine-version-code>] \
[--dataStorageTypeCode <SSD|HDD>] \
[--compressCode <SNPP|ZLIB|ZSTD|NONE>] \
[--memberPort <member-port>] \
[--mongosPort <mongos-port>] \
[--configPort <config-port>] \
[--backupTime <hh:mm>] \
[--backupFileRetentionPeriod <retention-days>] \
[--regionCode <FKR>] \
[--output <json|xml>]
옵션
createCloudMongoDbInstance 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
createCloudMongoDbInstance의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--vpcNo |
String | Required | Cloud DB for MongoDB 인스턴스를 생성할 VPC 번호 |
--subnetNo |
String | Required | Cloud DB for MongoDB 인스턴스에서 사용할 기본 네트워크 인터페이스의 Subnet 번호
|
--cloudMongoDbServiceName |
String | Required | Cloud DB for MongoDB 서비스 이름
|
--cloudMongoDbServerNamePrefix |
String | Required | Cloud DB for MongoDB 서버 이름 접두사
|
--clusterTypeCode |
String | Required | Cloud DB for MongoDB 인스턴스의 클러스터 타입 코드
|
--cloudMongoDbUserName |
String | Required | DB User 계정 ID
|
--cloudMongoDbUserPassword |
String | Required | DB User 계정 비밀번호
|
선택 옵션
createCloudMongoDbInstance의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--cloudMongoDbImageProductCode |
String | Optional | Cloud DB for MongoDB 이미지 상품 코드
|
--memberProductCode |
String | Optional | Cloud DB for MongoDB Member 서버 상품 코드
|
--arbiterProductCode |
String | Optional | Cloud DB for MongoDB Arbiter 서버 상품 코드
|
--mongosProductCode |
String | Optional | Cloud DB for MongoDB Mongos 서버 상품 코드
|
--configProductCode |
String | Optional | Cloud DB for MongoDB Config 서버 상품 코드
|
--shardCount |
Integer | Optional | Cloud DB for MongoDB 샤드 수
|
--memberServerCount |
Integer | Optional | Cloud DB for MongoDB Member 서버 대수
|
--arbiterServerCount |
Integer | Optional | Cloud DB for MongoDB Arbiter 서버 대수
|
--mongosServerCount |
Integer | Optional | Cloud DB for MongoDB Mongos 서버 대수
|
--configServerCount |
Integer | Optional | Cloud DB for MongoDB Config 서버 대수
|
--engineVersionCode |
String | Optional | DB 엔진 버전
|
--dataStorageTypeCode |
String | Optional | 데이터 스토리지 타입 코드
|
--compressCode |
String | Optional | Cloud DB for MongoDB 인스턴스의 데이터 압축 알고리즘 코드
|
--memberPort |
Integer | Optional | Cloud DB for MongoDB Member 서버에 접근하기 위한 TCP 포트 번호
|
--mongosPort |
Integer | Optional | Cloud DB for MongoDB Mongos 서버에 접근하기 위한 TCP 포트 번호
|
--configPort |
Integer | Optional | Cloud DB for MongoDB Config 서버에 접근하기 위한 TCP 포트 번호
|
--backupTime |
String | Optional | 백업 시점 설정 (HH:MM)
|
--backupFileRetentionPeriod |
Integer | Optional | 백업 파일 보관 기간 (일)
|
공통 옵션
vmongodb 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for MongoDB 옵션을 참조해 주십시오.
예시
Cloud DB for MongoDB 인스턴스 생성 요청이 성공하면 인스턴스의 구성 정보와 생성 상태가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./ncloud vmongodb createCloudMongoDbInstance \
--vpcNo 12345678 \
--subnetNo 23456789 \
--cloudMongoDbServiceName mongodb-01 \
--cloudMongoDbServerNamePrefix mongodb \
--clusterTypeCode SHARDED_CLUSTER \
--cloudMongoDbUserName testuser \
--cloudMongoDbUserPassword Examplepw123! \
--cloudMongoDbImageProductCode SW.VMGDB.OS.LNX64.ROCKY.0810.MNGDB.CE.B050 \
--memberProductCode SVR.VMGDB.MNGOD.STAND.C002.M004.NET.SSD.B050.G001 \
--arbiterProductCode SVR.VMGDB.ARBIT.STAND.C002.M004.NET.SSD.B050.G001 \
--mongosProductCode SVR.VMGDB.MNGOS.STAND.C002.M004.NET.SSD.B050.G001 \
--configProductCode SVR.VMGDB.CFGSV.STAND.C002.M004.NET.SSD.B050.G001 \
--shardCount 2 \
--memberServerCount 2 \
--arbiterServerCount 1 \
--mongosServerCount 2 \
--configServerCount 3 \
--regionCode FKR \
--output json
출력
출력 예시는 다음과 같습니다.
{
"createCloudMongoDbInstanceResponse": {
"totalRows": 1,
"cloudMongoDbInstanceList": [
{
"cloudMongoDbInstanceNo": "34567890",
"cloudMongoDbServiceName": "mongodb-01",
"cloudMongoDbInstanceStatusName": "creating",
"cloudMongoDbInstanceStatus": {
"code": "INIT",
"codeName": "CLOUD DATABASE(VPC) Init 상태"
},
"cloudMongoDbInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) Creat OP"
},
"generationCode": "G2",
"clusterType": {
"code": "SHARDED_CLUSTER",
"codeName": "Sharding Cluster Type - Cloud DB for MongoDB (VPC)"
},
"engineVersion": "MongoDB 7.0.28 Community Edition",
"licence": {
"code": "OEM",
"codeName": "라이센스코드-CLOUD DATABASE(VPC)"
},
"backupFileRetentionPeriod": 1,
"backupTime": "02:00",
"cloudMongoDbImageProductCode": "SW.VMGDB.OS.LNX64.ROCKY.0810.MNGDB.CE.B050",
"accessControlGroupNoList": [],
"shardCount": 2,
"compress": {
"code": "SNPP",
"codeName": "Snappy"
},
"memberPort": 17017,
"arbiterPort": 17017,
"mongosPort": 17017,
"configPort": 17017,
"createDate": "2026-06-22T13:07:24+0900",
"cloudMongoDbServerInstanceList": [
{
"cloudMongoDbServerName": "mg-mongodb-ab001-3onw",
"clusterRole": {
"code": "SHARD",
"codeName": "Shard Cluster Role - Cloud DB for MongoDB"
},
"cloudMongoDbServerInstanceStatusName": "creating",
"cloudMongoDbServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudMongoDbServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudMongoDbServerRole": {
"code": "AB",
"codeName": "Arbiter"
},
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-22T13:07:24+0900",
"zoneCode": "FKR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.ARBIT.STAND.C002.M004.NET.SSD.B050.G001",
"replicaSetName": "mongodb-01001",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-ab002-3onx",
"clusterRole": {
"code": "SHARD",
"codeName": "Shard Cluster Role - Cloud DB for MongoDB"
},
"cloudMongoDbServerInstanceStatusName": "creating",
"cloudMongoDbServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudMongoDbServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudMongoDbServerRole": {
"code": "AB",
"codeName": "Arbiter"
},
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-22T13:07:24+0900",
"zoneCode": "FKR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.ARBIT.STAND.C002.M004.NET.SSD.B050.G001",
"replicaSetName": "mongodb-01002",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-c-3oo0",
"clusterRole": {
"code": "CONFIG_SERVER",
"codeName": "Config Server Cluster Role - Cloud DB for MongoDB"
},
"cloudMongoDbServerInstanceStatusName": "creating",
"cloudMongoDbServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudMongoDbServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudMongoDbServerRole": {
"code": "C",
"codeName": "Config Server"
},
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-22T13:07:24+0900",
"zoneCode": "FKR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.CFGSV.STAND.C002.M004.NET.SSD.B050.G001",
"replicaSetName": "csmongodb-01",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-c-3oo1",
"clusterRole": {
"code": "CONFIG_SERVER",
"codeName": "Config Server Cluster Role - Cloud DB for MongoDB"
},
"cloudMongoDbServerInstanceStatusName": "creating",
"cloudMongoDbServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudMongoDbServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudMongoDbServerRole": {
"code": "C",
"codeName": "Config Server"
},
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-22T13:07:24+0900",
"zoneCode": "FKR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.CFGSV.STAND.C002.M004.NET.SSD.B050.G001",
"replicaSetName": "csmongodb-01",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-c-3oo2",
"clusterRole": {
"code": "CONFIG_SERVER",
"codeName": "Config Server Cluster Role - Cloud DB for MongoDB"
},
"cloudMongoDbServerInstanceStatusName": "creating",
"cloudMongoDbServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudMongoDbServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudMongoDbServerRole": {
"code": "C",
"codeName": "Config Server"
},
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-22T13:07:24+0900",
"zoneCode": "FKR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.CFGSV.STAND.C002.M004.NET.SSD.B050.G001",
"replicaSetName": "csmongodb-01",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-mb001-3ons",
"clusterRole": {
"code": "SHARD",
"codeName": "Shard Cluster Role - Cloud DB for MongoDB"
},
"cloudMongoDbServerInstanceStatusName": "creating",
"cloudMongoDbServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudMongoDbServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudMongoDbServerRole": {
"code": "MB",
"codeName": "Member"
},
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-22T13:07:24+0900",
"zoneCode": "FKR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.MNGOD.STAND.C002.M004.NET.SSD.B050.G001",
"replicaSetName": "mongodb-01001",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-mb001-3ont",
"clusterRole": {
"code": "SHARD",
"codeName": "Shard Cluster Role - Cloud DB for MongoDB"
},
"cloudMongoDbServerInstanceStatusName": "creating",
"cloudMongoDbServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudMongoDbServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudMongoDbServerRole": {
"code": "MB",
"codeName": "Member"
},
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-22T13:07:24+0900",
"zoneCode": "FKR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.MNGOD.STAND.C002.M004.NET.SSD.B050.G001",
"replicaSetName": "mongodb-01001",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-mb002-3onu",
"clusterRole": {
"code": "SHARD",
"codeName": "Shard Cluster Role - Cloud DB for MongoDB"
},
"cloudMongoDbServerInstanceStatusName": "creating",
"cloudMongoDbServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudMongoDbServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudMongoDbServerRole": {
"code": "MB",
"codeName": "Member"
},
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-22T13:07:24+0900",
"zoneCode": "FKR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.MNGOD.STAND.C002.M004.NET.SSD.B050.G001",
"replicaSetName": "mongodb-01002",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-mb002-3onv",
"clusterRole": {
"code": "SHARD",
"codeName": "Shard Cluster Role - Cloud DB for MongoDB"
},
"cloudMongoDbServerInstanceStatusName": "creating",
"cloudMongoDbServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudMongoDbServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudMongoDbServerRole": {
"code": "MB",
"codeName": "Member"
},
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-22T13:07:24+0900",
"zoneCode": "FKR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.MNGOD.STAND.C002.M004.NET.SSD.B050.G001",
"replicaSetName": "mongodb-01002",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-rt-3ony",
"clusterRole": {
"code": "MONGOS",
"codeName": "Mongos Cluster Role - Cloud DB for MongoDB"
},
"cloudMongoDbServerInstanceStatusName": "creating",
"cloudMongoDbServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudMongoDbServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudMongoDbServerRole": {
"code": "RT",
"codeName": "Mongos"
},
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-22T13:07:24+0900",
"zoneCode": "FKR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.MNGOS.STAND.C002.M004.NET.SSD.B050.G001",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-rt-3onz",
"clusterRole": {
"code": "MONGOS",
"codeName": "Mongos Cluster Role - Cloud DB for MongoDB"
},
"cloudMongoDbServerInstanceStatusName": "creating",
"cloudMongoDbServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudMongoDbServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudMongoDbServerRole": {
"code": "RT",
"codeName": "Mongos"
},
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-22T13:07:24+0900",
"zoneCode": "FKR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.MNGOS.STAND.C002.M004.NET.SSD.B050.G001",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
}
]
}
],
"requestId": "c0e08d31-cb4c-454e-a2ed-f43d073bbf36",
"returnCode": "0",
"returnMessage": "success"
}
}