createCloudPostgresqlInstance
    • PDF

    createCloudPostgresqlInstance

    • PDF

    Article Summary

    VPC環境で利用できます。

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

    コマンド

    コマンド構文は、次のとおりです。

    ncloud vpostgresql createCloudPostgresqlInstance [regionCode] [vpcNo] [subnetNo] [secondarySubnetNo] [cloudPostgresqlImageProductCode] [cloudPostgresqlProductCode] [dataStorageTypeCode] [isHa] [isMultiZone] [isStorageEncryption] [isBackup] [backupFileRetentionPeriod] [backupTime] [isAutomaticBackup] [cloudPostgresqlServiceName] [cloudPostgresqlServerNamePrefix] [cloudPostgresqlUserName] [cloudPostgresqlUserPassword] [clientCidr] [cloudPostgresqlPort] [cloudPostgresqlDatabaseName] [output]
    

    パラメータ

    パラメータについての説明は、次のとおりです。

    パラメータタイプ要否説明制約事項
    regionCodeStringNリージョンコード
    - regionCodeは、getRegionListアクションを通じて取得
    - default: getRegionList照会結果の最初のリージョンを選択
    -
    vpcNoStringYVPC番号
    - vpcNoは、getCloudPostgresqlTargetVpcListアクションを通じて取得
    -
    subnetNoStringYSubnet番号
    - subnetNoは、getCloudPostgresqlTargetSubnetListアクションを通じて取得
    - Publicドメインは、Public Subnetに作成された DBサーバでのみご利用の申し込みができる
    - Cloud DB for PostgreSQLインスタンス作成後に Subnet移転は不可
    -
    secondarySubnetNoStringNSecondaryサーバの Subnet番号
    - マルチゾーンの有無(isMultiZone)が falseの場合は入力せず、マルチゾーンの有無(isMultiZone)が trueの場合は必ず入力
    - Primaryサーバの Subnetと Zoneが異なり、同じ Publicまたは Privateでなければならない
    - secondarySubnetNoは、getCloudPostgresqlTargetSubnetListアクションを通じて取得
    -
    cloudPostgresqlImageProductCodeStringNCloud DB for PostgreSQLの画像商品コード
    - cloudPostgresqlImageProductCodeは、getCloudPostgresqlImageProductListアクションの productCodeで取得
    - 入力しない場合、Default値で作成
    -
    cloudPostgresqlProductCodeStringNCloud DB for PostgreSQLの商品コード
    - 作成する Cloud DB for PostgreSQLインスタンスのサーバスペックを決定
    - cloudPostgresqlProductCodeは、getCloudPostgresqlProductListアクションの productCodeで取得
    - default: 最小スペックが選択される。最小スペックの基準は、1. メモリ、2. CPU
    -
    dataStorageTypeCodeStringNデータストレージのタイプコード
    - インストール後にデータストレージタイプの変更は不可
    - options: SSD | HDD
    - default: SSD
    -
    isHaBooleanN高可用性の有無
    - 高可用性を選択すると、Secondaryサーバーを含む2台のサーバーで作成され、追加料金が発生する
    - 高可用性の有無(isHa)が falseの場合、isMultiZone、secondarySubnetNoパラメータは使用不可
    - default: true
    -
    isMultiZoneBooleanNマルチゾーンの有無
    - 高可用性の有無(isHa)が trueである場合、マルチゾーンの有無を選択可能
    - マルチゾーンを選択すると、Primaryサーバーと Secondaryサーバーを異なる Zoneに作成し、より高い可用性を提供
    - 高可用性の有無(isHa)が trueである場合、必ず入力
    - Neurocloud環境では利用不可
    - default: false
    -
    isStorageEncryptionBooleanNデータストレージ暗号化の適用有無
    - 暗号化を適用する時、DBデータは暗号化されてストレージに保存
    - Cloud DB for PostgreSQLインスタンス作成後は、ストレージの暗号化設定を変更不可
    - Neurocloud環境では利用不可
    - default: false
    -
    isBackupBooleanNバックアップの有無
    - 高可用性の有無(isHa)が trueである場合、バックアップの有無(isBackup)は trueに固定
    - default: true
    -
    backupFileRetentionPeriodIntegerNバックアップファイルの保存期間
    - バックアップは毎日行われ、バックアップファイルは別のバックアップ ストレージに保存
    - 料金は使用するスペース分だけ課金
    - default: 1(1日)
    -
    backupTimeStringNバックアップ時間
    -バックアップが行われる時間を設定。バックアップの有無(isBackup)が trueで、自動バックアップの有無(isAutomaticBackup)が falseであれば、必ず入力
    - 01:15
    -
    isAutomaticBackupBooleanNバックアップ時間の自動有無
    - 自動でバックアップ時間を設定するかどうかを選択、自動バックアップの有無(isAutomaticBackup)が trueの場合は backupTimeを入力不可
    - default: true
    -
    cloudPostgresqlServiceNameStringYCloud DB for PostgreSQLのサービス名- アルファベット、数字、特殊文字の「-」、ハングルのみ入力可能
    - Min: 3
    - Max: 30
    cloudPostgresqlServerNamePrefixStringYCloud DB for PostgreSQLサーバ名接頭辞
    - ホスト名の重複防止のため、 伝えられた cloudPostgresqlServerNamePrefixの値の後に任意の textを追加して作成
    - DB Server名は、アルファベットの小文字、数字、特殊文字の「-」のみで構成
    - 先頭文字はアルファベットにし、末尾文字はアルファベットまたは数字にする
    - Min: 3
    - Max: 20
    cloudPostgresqlUserNameStringY管理者 ID
    - DB管理者用に使用するユーザー名を入力
    - アルファベットの小文字、数字、アンダースコア(_)文字のみ許可し、先頭文字はアルファベットにする
    - Min: 4
    - Max: 16
    cloudPostgresqlUserPasswordStringY管理者パスワード
    - DB管理者用に使用するユーザーのパスワードを入力
    - 8文字以上、英語/特殊文字/数字の3項目について1文字以上含む
    - ` & + \ " ' / スペースはパスワードとして使用不可
    - User IDは含まない
    - Min: 8
    - Max: 20
    clientCidrStringYアクセス制御
    - 接続したい Clientの CIDRを入力
    - 全体アクセス許可: 0.0.0.0/0
    - 特定 IPアドレスアクセスを許可: 192.168.1.1/32
    - IPアドレス帯域アクセスを許可: 192.168.1.0/24
    cloudPostgresqlPortIntegerNCloud DB for PostgreSQLポート
    - PostgreSQLアクセスのための TCPポート番号を入力
    - default: 5432
    5432
    or
    - Min: 10000
    - Max: 20000
    cloudPostgresqlDatabaseNameStringYCloud DB for PostgreSQLの DB名
    - 基本的に作成する DB名を入力
    - アルファベットの小文字、数字、アンダースコア(_)文字のみ許可し、先頭文字はアルファベットにする
    - Min: 1
    - Max: 30
    outputStringNレスポンス結果のフォーマットタイプ
    - options: xml | json
    - default: json
    -

    レスポンス

    レスポンスデータのタイプ

    • CloudPostgresqlInstanceListタイプ
    CloudPostgresqlInstanceList extends CommonResponse説明
    private Integer totalRows;照会されたリストの総数
    private List<CloudPostgresqlInstance> cloudPostgresqlInstanceList = new ArrayList<>();Cloud DB for PostgreSQLインスタンスリスト
    • CloudPostgresqlInstanceタイプ
    CloudPostgresqlInstance説明
    private String cloudPostgresqlInstanceNo;Cloud DB for PostgreSQLのインスタンス番号
    private String cloudPostgresqlServiceName;Cloud DB for PostgreSQLのサービス名
    private String cloudPostgresqlInstanceStatusName;Cloud DB for PostgreSQLインスタンスステータス名
    - creating
    - deleted
    - deleting
    - downgrading
    - pending
    - recovering
    - reinstalling
    - restarting
    - running
    - settingup
    - shuttingdown
    - stopped
    - upgrading
    private CommonCode cloudPostgresqlInstanceStatus;Cloud DB for PostgreSQLインスタンスステータスコード
    - INIT (initiate)
    - CREAT (created)
    - DEL (deleted)
    private CommonCode cloudPostgresqlInstanceOperation;Cloud DB for PostgreSQLインスタンス Operationコード
    - CREAT (create)
    - DEL (delete)
    - FO (failover)
    - NULL (no operation)
    - SETUP (setup)
    - UPGD (upgrade)
    - DWGD (downgrade)
    - BKP (backup)
    private String cloudPostgresqlImageProductCode;Cloud DB for PostgreSQLの画像商品コード
    private String engineVersion;Cloud DB for PostgreSQLエンジンバージョン
    private String license;Cloud DB for PostgreSQLライセンス
    private Integer cloudPostgresqlPort;Cloud DB for PostgreSQLポート
    private Boolean isHa;高可用性の有無
    private Boolean isMultiZone;マルチゾーンの有無
    private Boolean isBackup;バックアップの有無
    private Integer backupFileRetentionPeriod;バックアップファイルの保存期間
    private String backupTime;バックアップ時間
    private Date createDate;作成日
    private AccessControlGroupNoList accessControlGroupNoList;ACG番号リスト
    private CloudPostgresqlConfigList cloudPostgresqlConfigList;Cloud DB for PostgreSQL Configリスト
    private List<CloudPostgresqlServerInstance> cloudPostgresqlServerInstanceList;Cloud DB for PostgreSQLサーバインスタンスリスト
    • AccessControlGroupNoListタイプ
    AccessControlGroupNoList説明
    private List<String> accessControlGroupNoList = new ArrayList<>();ACG番号リスト
    • CloudPostgresqlConfigListタイプ
    CloudPostgresqlConfigList説明
    private List<String> cloudPostgresqlConfigList = new ArrayList<>();Cloud DB for PostgreSQL Configリスト
    • CloudPostgresqlServerInstanceタイプ
    CloudPostgresqlServerInstance説明
    private String cloudPostgresqlServerInstanceNo;Cloud DB for PostgreSQLのサーバインスタンス番号
    private String cloudPostgresqlServerName;Cloud DB for PostgreSQLのサーバ名
    private CommonCode cloudPostgresqlServerRole;Cloud DB for PostgreSQLサーバ役割
    private String cloudPostgresqlServerInstanceStatusName;Cloud DB for PostgreSQLサーバインスタンスステータス名
    - creating
    - deleted
    - deleting
    - downgrading
    - pending
    - recovering
    - reinstalling
    - restarting
    - running
    - settingup
    - shuttingdown
    - stopped
    - upgrading
    - downgrading
    private CommonCode cloudPostgresqlServerInstanceStatus;Cloud DB for PostgreSQLサーバインスタンスステータスコード
    - DEL (deleted)
    - PEND (pending)
    - RUN (running)
    - STOP (stopped)
    - FSTOP (failure stopped)
    private CommonCode cloudPostgresqlServerInstanceOperation;Cloud DB for PostgreSQLサーバインスタンス Operationコード
    - NOOP (no operation)
    - CREAT (create)
    - START (start)
    - RSTRT (restart)
    - SETUP (setup)
    - STOP (stop)
    - FO (failover)
    - DEL (delete)
    - UPGD (upgrade)
    - DWGD (downgrade)
    - RISTL (reinstall)
    private String cloudPostgresqlProductCode;Cloud DB for PostgreSQLの商品コード
    private String regionCode;リージョンコード
    private String zoneCode;Zoneコード
    private String vpcNo;VPC番号
    private String subnetNo;Subnet番号
    private Boolean isPublicSubnet;Public Subnetの有無
    private String publicDomain;グローバルドメイン名
    private String privateDomain;プライベートドメイン名
    private CommonCode dataStorageType;データストレージタイプ
    private Boolean isStorageEncryption;データストレージの暗号化の有無
    private Long dataStorageSize;データストレージサイズ
    private Long usedDataStorageSize;使用中のデータストレージサイズ
    private Integer cpuCount;CPU数
    private Long memorySize;メモリサイズ
    private Date uptime;VM起動完了時間
    private Date createDate;作成日

    呼び出しとレスポンス例を説明します。

    呼び出し例

    呼び出し例は、次のとおりです。

    ncloud vpostgresql createCloudPostgresqlInstance --regionCode KR --vpcNo ****87 --subnetNo ****49 --secondarySubnetNo ****51 --cloudPostgresqlImageProductCode SW.VPGSL.OS.LNX64.CNTOS.0708.PGSQL.133.B050 --cloudPostgresqlProductCode SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001 --dataStorageTypeCode SSD --isHa true --isMultiZone true --isStorageEncryption true --isBackup true --backupFileRetentionPeriod 10 --backupTime 02:00 --isAutomaticBackup false --cloudPostgresqlServiceName test-**** --cloudPostgresqlServerNamePrefix test-**** --cloudPostgresqlUserName test**** --cloudPostgresqlUserPassword ******** --clientCidr 0.0.0.0/0 --cloudPostgresqlPort 15432 --cloudPostgresqlDatabaseName test****
    

    レスポンス例

    レスポンス例は、次のとおりです。

    レスポンス結果フォーマットタイプ(output)が jsonのとき

    {
      "createCloudPostgresqlInstanceResponse": {
        "requestId": "9f76fa24-67a4-4cdf-bf70-f62f251d5138",
        "returnCode": 0,
        "returnMessage": "success",
        "totalRows": 1,
        "cloudPostgresqlInstanceList": [
          {
            "cloudPostgresqlInstanceNo": "****925",
            "cloudPostgresqlServiceName": "test-****",
            "cloudPostgresqlInstanceStatusName": "creating",
            "cloudPostgresqlInstanceStatus": {
              "code": "INIT",
              "codeName": "CLOUD DATABASE(VPC) Init State"
            },
            "cloudPostgresqlInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC) Creat OP"
            },
            "cloudPostgresqlImageProductCode": "SW.VPGSL.OS.LNX64.CNTOS.0708.PGSQL.133.B050",
            "engineVersion": "PostgreSQL 13.3",
            "license": "PostgreSQL License",
            "cloudPostgresqlPort": 15432,
            "isHa": true,
            "isMultiZone": true,
            "isBackup": true,
            "backupFileRetentionPeriod": 10,
            "backupTime": "02:00",
            "createDate": "2021-09-16T18:00:00+0900",
            "accessControlGroupNoList": [],
            "cloudPostgresqlServerInstanceList": [
              {
                "cloudPostgresqlServerName": "test-****-001-gcb",
                "cloudPostgresqlServerRole": {
                  "code": "M",
                  "codeName": "Primary"
                },
                "cloudPostgresqlServerInstanceStatusName": "creating",
                "cloudPostgresqlServerInstanceStatus": {
                  "code": "PEND",
                  "codeName": "CLOUD DATABASE(VPC) Server Pending State"
                },
                "cloudPostgresqlServerInstanceOperation": {
                  "code": "CREAT",
                  "codeName": "CLOUD DATABASE(VPC) Server Create OP"
                },
                "cloudPostgresqlProductCode": "SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001",
                "regionCode": "KR",
                "zoneCode": "KR-1",
                "vpcNo": "****87",
                "subnetNo": "****49",
                "isPublicSubnet": true,
                "dataStorageType": {
                  "code": "SSD",
                  "codeName": "SSD"
                },
                "isStorageEncryption": true,
                "dataStorageSize": 10737418240,
                "cpuCount": 2,
                "memorySize": 4294967296,
                "createDate": "2021-09-16T18:00:00+0900"
              },
              {
                "cloudPostgresqlServerName": "test-****-002-gcc",
                "cloudPostgresqlServerRole": {
                  "code": "H",
                  "codeName": "Secondary"
                },
                "cloudPostgresqlServerInstanceStatusName": "creating",
                "cloudPostgresqlServerInstanceStatus": {
                  "code": "PEND",
                  "codeName": "CLOUD DATABASE(VPC) Server Pending State"
                },
                "cloudPostgresqlServerInstanceOperation": {
                  "code": "CREAT",
                  "codeName": "CLOUD DATABASE(VPC) Server Create OP"
                },
                "cloudPostgresqlProductCode": "SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001",
                "regionCode": "KR",
                "zoneCode": "KR-2",
                "vpcNo": "****87",
                "subnetNo": "****51",
                "isPublicSubnet": true,
                "dataStorageType": {
                  "code": "SSD",
                  "codeName": "SSD"
                },
                "isStorageEncryption": true,
                "dataStorageSize": 10737418240,
                "cpuCount": 2,
                "memorySize": 4294967296,
                "createDate": "2021-09-16T18:00:00+0900"
              }
            ]
          }
        ]
      }
    }
    

    レスポンス結果フォーマットタイプ(output)が xmlの場合

    <createCloudPostgresqlInstanceResponse>
        <requestId>9f76fa24-67a4-4cdf-bf70-f62f251d5138</requestId>
        <returnCode>0</returnCode>
        <returnMessage>success</returnMessage>
        <totalRows>1</totalRows>
        <cloudPostgresqlInstanceList>
            <cloudPostgresqlInstance>
                <cloudPostgresqlInstanceNo>****925</cloudPostgresqlInstanceNo>
                <cloudPostgresqlServiceName>test-****</cloudPostgresqlServiceName>
                <cloudPostgresqlInstanceStatusName>creating</cloudPostgresqlInstanceStatusName>
                <cloudPostgresqlInstanceStatus>
                    <code>INIT</code>
                    <codeName>CLOUD DATABASE(VPC) Init State</codeName>
                </cloudPostgresqlInstanceStatus>
                <cloudPostgresqlInstanceOperation>
                    <code>CREAT</code>
                    <codeName>CLOUD DATABASE(VPC) Creat OP</codeName>
                </cloudPostgresqlInstanceOperation>
                <cloudPostgresqlImageProductCode>SW.VPGSL.OS.LNX64.CNTOS.0708.PGSQL.133.B050</cloudPostgresqlImageProductCode>
                <engineVersion>PostgreSQL 13.3</engineVersion>
                <license>PostgreSQL License</license>
                <cloudPostgresqlPort>15432</cloudPostgresqlPort>
                <isHa>true</isHa>
                <isMultiZone>true</isMultiZone>
                <isBackup>true</isBackup>
                <backupFileRetentionPeriod>10</backupFileRetentionPeriod>
                <backupTime>02:00</backupTime>
                <createDate>2021-09-16T18:00:00+0900</createDate>
                <accessControlGroupNoList/>
                <cloudPostgresqlServerInstanceList>
                    <cloudPostgresqlServerInstance>
                        <cloudPostgresqlServerName>test-****-001-gcb</cloudPostgresqlServerName>
                        <cloudPostgresqlServerRole>
                            <code>M</code>
                            <codeName>Primary</codeName>
                        </cloudPostgresqlServerRole>
                        <cloudPostgresqlServerInstanceStatusName>creating</cloudPostgresqlServerInstanceStatusName>
                        <cloudPostgresqlServerInstanceStatus>
                            <code>PEND</code>
                            <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                        </cloudPostgresqlServerInstanceStatus>
                        <cloudPostgresqlServerInstanceOperation>
                            <code>CREAT</code>
                            <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                        </cloudPostgresqlServerInstanceOperation>
                        <cloudPostgresqlProductCode>SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001</cloudPostgresqlProductCode>
                        <regionCode>KR</regionCode>
                        <zoneCode>KR-1</zoneCode>
                        <vpcNo>****87</vpcNo>
                        <subnetNo>****49</subnetNo>
                        <isPublicSubnet>true</isPublicSubnet>
                        <dataStorageType>
                            <code>SSD</code>
                            <codeName>SSD</codeName>
                        </dataStorageType>
                        <isStorageEncryption>true</isStorageEncryption>
                        <dataStorageSize>10737418240</dataStorageSize>
                        <cpuCount>2</cpuCount>
                        <memorySize>4294967296</memorySize>
                        <createDate>2021-09-16T18:00:00+0900</createDate>
                    </cloudPostgresqlServerInstance>
                    <cloudPostgresqlServerInstance>
                        <cloudPostgresqlServerName>test-****-002-gcc</cloudPostgresqlServerName>
                        <cloudPostgresqlServerRole>
                            <code>H</code>
                            <codeName>Secondary</codeName>
                        </cloudPostgresqlServerRole>
                        <cloudPostgresqlServerInstanceStatusName>creating</cloudPostgresqlServerInstanceStatusName>
                        <cloudPostgresqlServerInstanceStatus>
                            <code>PEND</code>
                            <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                        </cloudPostgresqlServerInstanceStatus>
                        <cloudPostgresqlServerInstanceOperation>
                            <code>CREAT</code>
                            <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                        </cloudPostgresqlServerInstanceOperation>
                        <cloudPostgresqlProductCode>SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001</cloudPostgresqlProductCode>
                        <regionCode>KR</regionCode>
                        <zoneCode>KR-2</zoneCode>
                        <vpcNo>****87</vpcNo>
                        <subnetNo>****51</subnetNo>
                        <isPublicSubnet>true</isPublicSubnet>
                        <dataStorageType>
                            <code>SSD</code>
                            <codeName>SSD</codeName>
                        </dataStorageType>
                        <isStorageEncryption>true</isStorageEncryption>
                        <dataStorageSize>10737418240</dataStorageSize>
                        <cpuCount>2</cpuCount>
                        <memorySize>4294967296</memorySize>
                        <createDate>2021-09-16T18:00:00+0900</createDate>
                    </cloudPostgresqlServerInstance>
                </cloudPostgresqlServerInstanceList>
            </cloudPostgresqlInstance>
        </cloudPostgresqlInstanceList>
    </createCloudPostgresqlInstanceResponse>
    

    この記事は役に立ちましたか?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.