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.

createCloudPostgresqlReadReplicaInstance

Prev Next

Cloud DB for PostgreSQL 인스턴스에 Read Replica 서버 인스턴스를 추가합니다.

구문

createCloudPostgresqlReadReplicaInstance 구문은 다음과 같습니다.

./ncloud vpostgresql createCloudPostgresqlReadReplicaInstance \
    --cloudPostgresqlInstanceNo <instance-no> \
    [--subnetNo <subnet-no>] \
    [--regionCode <FKR>] \
    [--output <json|xml>]

옵션

createCloudPostgresqlReadReplicaInstance 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

createCloudPostgresqlReadReplicaInstance의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--cloudPostgresqlInstanceNo String Required Cloud DB for PostgreSQL 인스턴스 번호
--subnetNo String Conditional Cloud DB for PostgreSQL 인스턴스에서 사용할 기본 네트워크 인터페이스의 Subnet 번호
  • Cloud DB for PostgreSQL 인스턴스가 멀티존인 경우, 필수 입력
  • 멀티존이 아닌 경우, subnetNo 입력을 무시하며 기존 Subnet에 생성됨
  • Cloud DB for PostgreSQL Read Replica 서버 인스턴스 생성 이후 Subnet 이전 불가
  • getCloudPostgresqlTargetSubnetList 참조

공통 옵션

vpostgresql 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for PostgreSQL 옵션을 참조해 주십시오.

예시

Read Replica 서버 인스턴스 추가 요청이 성공하면 Cloud DB for PostgreSQL 인스턴스의 서버 구성과 추가된 Read Replica 서버의 생성 상태가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud vpostgresql createCloudPostgresqlReadReplicaInstance \
    --cloudPostgresqlInstanceNo 34567890 \
    --regionCode FKR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "createCloudPostgresqlReadReplicaInstanceResponse": {
    "totalRows": 1,
    "cloudPostgresqlInstanceList": [
      {
        "cloudPostgresqlInstanceNo": "34567890",
        "cloudPostgresqlServiceName": "test-pgsql",
        "cloudPostgresqlInstanceStatusName": "running",
        "cloudPostgresqlInstanceStatus": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Created 상태"
        },
        "cloudPostgresqlInstanceOperation": {
          "code": "NULL",
          "codeName": "CLOUD DATABASE(VPC) Null 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-22T13:27:26+0900",
        "accessControlGroupNoList": [
          "67890123"
        ],
        "cloudPostgresqlConfigList": [],
        "cloudPostgresqlServerInstanceList": [
          {
            "cloudPostgresqlServerInstanceNo": "34567891",
            "cloudPostgresqlServerName": "testpg-001-3oo3",
            "cloudPostgresqlServerRole": {
              "code": "M",
              "codeName": "Primary"
            },
            "cloudPostgresqlServerInstanceStatusName": "running",
            "cloudPostgresqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudPostgresqlServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudPostgresqlProductCode": "SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "pg-****.vpc-cdb-fkr.fin-ntruss.com",
            "privateIp": "192.168.4.19",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 233353876,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "uptime": "2026-06-22T13:34:38+0900",
            "createDate": "2026-06-22T13:27:26+0900"
          },
          {
            "cloudPostgresqlServerInstanceNo": "34567892",
            "cloudPostgresqlServerName": "testpg-002-3oo4",
            "cloudPostgresqlServerRole": {
              "code": "H",
              "codeName": "Secondary"
            },
            "cloudPostgresqlServerInstanceStatusName": "running",
            "cloudPostgresqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudPostgresqlServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudPostgresqlProductCode": "SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "pg-****.vpc-cdb-fkr.fin-ntruss.com",
            "privateIp": "192.168.4.20",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 166092191,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "uptime": "2026-06-22T13:33:24+0900",
            "createDate": "2026-06-22T13:27:26+0900"
          },
          {
            "cloudPostgresqlServerName": "testpg-003-3otb",
            "cloudPostgresqlServerRole": {
              "code": "S",
              "codeName": "Read Replica"
            },
            "cloudPostgresqlServerInstanceStatusName": "creating",
            "cloudPostgresqlServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
            },
            "cloudPostgresqlServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
            },
            "cloudPostgresqlProductCode": "SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "createDate": "2026-06-24T15:34:57+0900"
          }
        ]
      }
    ],
    "requestId": "22773967-0984-4837-8ee8-58d734fde295",
    "returnCode": "0",
    "returnMessage": "success"
  }
}