VPC環境で利用できます。
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|CB2>] \
[--compressCode <SNPP|ZLIB|ZSTD|NONE>] \
[--memberPort <member-port>] \
[--mongosPort <mongos-port>] \
[--configPort <config-port>] \
[--backupTime <hh:mm>] \
[--backupFileRetentionPeriod <retention-days>] \
[--regionCode <KR|SGN|JPN>] \
[--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 (VPC)のオプションを参照してください。
例
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.HICPU.C002.M004.NET.SSD.B050.G002 \
--arbiterProductCode SVR.VMGDB.ARBIT.HICPU.C002.M004.NET.SSD.B050.G002 \
--mongosProductCode SVR.VMGDB.MNGOS.HICPU.C002.M004.NET.SSD.B050.G002 \
--configProductCode SVR.VMGDB.CFGSV.HICPU.C002.M004.NET.SSD.B050.G002 \
--shardCount 2 \
--memberServerCount 2 \
--arbiterServerCount 1 \
--mongosServerCount 2 \
--configServerCount 3 \
--regionCode KR \
--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-10T10:03:36+0900",
"cloudMongoDbServerInstanceList": [
{
"cloudMongoDbServerName": "mg-mongodb-ab001-98eb",
"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": "KR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-10T10:03:36+0900",
"zoneCode": "KR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.ARBIT.HICPU.C002.M004.NET.SSD.B050.G002",
"replicaSetName": "mongodb-01001",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-ab002-98ec",
"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": "KR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-10T10:03:36+0900",
"zoneCode": "KR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.ARBIT.HICPU.C002.M004.NET.SSD.B050.G002",
"replicaSetName": "mongodb-01002",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-c-98ef",
"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": "KR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-10T10:03:36+0900",
"zoneCode": "KR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.CFGSV.HICPU.C002.M004.NET.SSD.B050.G002",
"replicaSetName": "csmongodb-01",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-c-98eg",
"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": "KR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-10T10:03:36+0900",
"zoneCode": "KR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.CFGSV.HICPU.C002.M004.NET.SSD.B050.G002",
"replicaSetName": "csmongodb-01",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-c-98eh",
"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": "KR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-10T10:03:36+0900",
"zoneCode": "KR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.CFGSV.HICPU.C002.M004.NET.SSD.B050.G002",
"replicaSetName": "csmongodb-01",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-mb001-98e7",
"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": "KR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-10T10:03:36+0900",
"zoneCode": "KR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.MNGOD.HICPU.C002.M004.NET.SSD.B050.G002",
"replicaSetName": "mongodb-01001",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-mb001-98e8",
"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": "KR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-10T10:03:36+0900",
"zoneCode": "KR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.MNGOD.HICPU.C002.M004.NET.SSD.B050.G002",
"replicaSetName": "mongodb-01001",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-mb002-98e9",
"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": "KR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-10T10:03:36+0900",
"zoneCode": "KR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.MNGOD.HICPU.C002.M004.NET.SSD.B050.G002",
"replicaSetName": "mongodb-01002",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-mb002-98ea",
"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": "KR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-10T10:03:36+0900",
"zoneCode": "KR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.MNGOD.HICPU.C002.M004.NET.SSD.B050.G002",
"replicaSetName": "mongodb-01002",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-rt-98ed",
"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": "KR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-10T10:03:36+0900",
"zoneCode": "KR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.MNGOS.HICPU.C002.M004.NET.SSD.B050.G002",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMongoDbServerName": "mg-mongodb-rt-98ee",
"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": "KR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"createDate": "2026-06-10T10:03:36+0900",
"zoneCode": "KR-1",
"memorySize": 4294967296,
"cpuCount": 2,
"dataStorageSize": 10737418240,
"cloudMongoDbProductCode": "SVR.VMGDB.MNGOS.HICPU.C002.M004.NET.SSD.B050.G002",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
}
]
}
],
"requestId": "e5f6a7b8-c9d0-1234-ef01-234567890abc",
"returnCode": "0",
"returnMessage": "success"
}
}