createCloudPostgresqlInstance

VPC環境で利用できます。

Cloud DB for PostgreSQLインスタンスを作成します。

構文

createCloudPostgresqlInstance構文は次の通りです。

./ncloud vpostgresql createCloudPostgresqlInstance \
    --vpcNo <vpc-no> \
    --subnetNo <subnet-no> \
    --cloudPostgresqlServiceName <service-name> \
    --cloudPostgresqlServerNamePrefix <server-name-prefix> \
    --cloudPostgresqlDatabaseName <database-name> \
    --cloudPostgresqlUserName <user-name> \
    --cloudPostgresqlUserPassword <user-password> \
    --clientCidr <client-cidr> \
    [--cloudPostgresqlImageProductCode <image-product-code>] \
    [--cloudPostgresqlProductCode <product-code>] \
    [--engineVersionCode <engine-version-code>] \
    [--dataStorageTypeCode <SSD|HDD|CB2>] \
    [--isStorageEncryption <true|false>] \
    [--isHa <true|false>] \
    [--isMultiZone <true|false>] \
    [--secondarySubnetNo <secondary-subnet-no>] \
    [--isBackup <true|false>] \
    [--isAutomaticBackup <true|false>] \
    [--backupTime <hh:mm>] \
    [--backupFileRetentionPeriod <retention-days>] \
    [--backupFileStorageCount <storage-count>] \
    [--isBackupFileCompression <true|false>] \
    [--cloudPostgresqlPort <port>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

createCloudPostgresqlInstanceの実行時に指定できるオプションについて説明します。

必須オプション

createCloudPostgresqlInstanceの必須オプションです。

任意オプション

createCloudPostgresqlInstanceの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

共通オプション

vpostgresqlコマンドで共通して使用するオプションについては、Cloud DB for PostgreSQL (VPC)のオプションを参照してください。

例

Cloud DB for PostgreSQLインスタンスの作成リクエストが成功すると、インスタンスの構成情報と作成状態が返されます。

コマンド

コマンドの例は次の通りです。

./ncloud vpostgresql createCloudPostgresqlInstance \
    --vpcNo 12345678 \
    --subnetNo 23456789 \
    --cloudPostgresqlServiceName test-pgsql \
    --cloudPostgresqlServerNamePrefix testpg \
    --cloudPostgresqlDatabaseName testdb \
    --cloudPostgresqlUserName testuser \
    --cloudPostgresqlUserPassword Examplepw123! \
    --clientCidr 0.0.0.0/0 \
    --cloudPostgresqlImageProductCode SW.VPGSL.OS.LNX64.ROCKY.0810.PGSQL.B050 \
    --cloudPostgresqlProductCode SVR.VPGSL.DBSVR.HICPU.C002.M004.NET.SSD.B050.G002 \
    --dataStorageTypeCode SSD \
    --isHa true \
    --cloudPostgresqlPort 13432 \
    --regionCode KR \
    --output json

出力

出力の例は次の通りです。

{
  "createCloudPostgresqlInstanceResponse": {
    "totalRows": 1,
    "cloudPostgresqlInstanceList": [
      {
        "cloudPostgresqlInstanceNo": "34567890",
        "cloudPostgresqlServiceName": "test-pgsql",
        "cloudPostgresqlInstanceStatusName": "creating",
        "cloudPostgresqlInstanceStatus": {
          "code": "INIT",
          "codeName": "CLOUD DATABASE(VPC) Init状態"
        },
        "cloudPostgresqlInstanceOperation": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Creat OP"
        },
        "cloudPostgresqlImageProductCode": "SW.VPGSL.OS.LNX64.ROCKY.0810.PGSQL.B050",
        "generationCode": "G2",
        "engineVersion": "PostgreSQL 15.15",
        "license": "PostgreSQL License",
        "cloudPostgresqlPort": 13432,
        "isHa": true,
        "isMultiZone": false,
        "isBackup": true,
        "backupFileRetentionPeriod": 1,
        "backupTime": "AUTO",
        "createDate": "2026-06-09T18:40:14+0900",
        "accessControlGroupNoList": [],
        "cloudPostgresqlServerInstanceList": [
          {
            "cloudPostgresqlServerName": "testpg-001-98b4",
            "cloudPostgresqlServerRole": {
              "code": "M",
              "codeName": "Primary"
            },
            "cloudPostgresqlServerInstanceStatusName": "creating",
            "cloudPostgresqlServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC)サーバ Pending状態"
            },
            "cloudPostgresqlServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC)サーバ Create OP"
            },
            "cloudPostgresqlProductCode": "SVR.VPGSL.DBSVR.HICPU.C002.M004.NET.SSD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-1",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "createDate": "2026-06-09T18:40:14+0900"
          },
          {
            "cloudPostgresqlServerName": "testpg-002-98b5",
            "cloudPostgresqlServerRole": {
              "code": "H",
              "codeName": "Secondary"
            },
            "cloudPostgresqlServerInstanceStatusName": "creating",
            "cloudPostgresqlServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC)サーバ Pending状態"
            },
            "cloudPostgresqlServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC)サーバ Create OP"
            },
            "cloudPostgresqlProductCode": "SVR.VPGSL.DBSVR.HICPU.C002.M004.NET.SSD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-1",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "createDate": "2026-06-09T18:40:14+0900"
          }
        ]
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}