createLoadBalancerInstance

VPC環境で利用できます。

ロードバランサインスタンスを作成します。

構文

createLoadBalancerInstance構文は次の通りです。

./ncloud vloadbalancer createLoadBalancerInstance \
    --loadBalancerTypeCode <APPLICATION|NETWORK|NETWORK_PROXY> \
    --vpcNo <vpc-no> \
    --subnetNoList <subnet-no-list> | --loadBalancerSubnetList <lb-subnet-config> \
    --loadBalancerListenerList <listener-config> \
    [--loadBalancerName <load-balancer-name>] \
    [--loadBalancerNetworkTypeCode <PUBLIC|PRIVATE>] \
    [--throughputTypeCode <SMALL|MEDIUM|LARGE|DYNAMIC|XLARGE>] \
    [--idleTimeout <idle-timeout>] \
    [--loadBalancerDescription <load-balancer-description>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

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

必須オプション

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

オプション	タイプ	必須の有無	説明
`--loadBalancerTypeCode`	String	Required	ロードバランサのタイプ `APPLICATION` \| `NETWORK` \| `NETWORK_PROXY` `APPLICATION`: アプリケーションロードバランサ `NETWORK`: ネットワークロードバランサ `NETWORK_PROXY`: ネットワークプロキシロードバランサ
`--vpcNo`	String	Required	VPC番号 getVpcListを参照
`--loadBalancerListenerList`	List	Required	ロードバランサのリスナーリスト各リスナーは、二重引用符の中に{フィールド=‘値’}のペアをコンマで区切って入力 `protocolTypeCode` (任意): ロードバランサのリスナーのプロトコルタイプ。ロードバランサのタイプによって、選択できる値に制限がある。アプリケーションロードバランサ: `HTTP` (デフォルト) \|`HTTPS`、ネットワークロードバランサ: `TCP` (デフォルト) \| `UDP`、ネットワークプロキシロードバランサ: `TCP` (デフォルト) \|`TLS` `port` (任意): ロードバランサリスナーのポート。`1`~`65534`. リスナーのプロトコルタイプによってデフォルト値が決まる (`HTTP`、`TCP`、`UDP`: `80`、`HTTPS`、`TLS`: `443`)。現在登録されているのリスナーポートと重複不可 `targetGroupNo` (必須): 各リスナーの基本ルールに適用されるターゲットグループ番号。他のロードバランサで既に使用されているターゲットグループは利用不可。ロードバランサのタイプとターゲットグループのプロトコルタイプによって、使用可能なターゲットグループが制限される(アプリケーションロードバランサ: `HTTP`\|`HTTPS`、ネットワークロードバランサ: `TCP`\|`UDP`、ネットワークプロキシロードバランサ: `PROXY_TCP`)。getTargetGroupListを参照 `useHttp2`(任意): HTTP/2プロトコルを使用するか。`true` \| `false` (デフォルト)。リスナーのプロトコルタイプが`HTTPS`の場合に設定可能 `sslCertificateNo` (条件付き): SSL証明書番号。リスナーのプロトコルタイプが`HTTPS`または`TLS`の場合、SSL証明書の設定は必須。getCertificateListを参照 `tlsMinVersionTypeCode`(任意): TLSの最小サポートバージョン。`TLSV10` (TLS 1.0、デフォルト) \| `TLSV11` (TLS 1.1) \| `TLSV12` (TLS 1.2) \| `TLSV13` (TLS 1.3)。`TLS_AES_256_GCM_SHA384`、`TLS_CHACHA20_POLY1305_SHA256`、`TLS_AES_128_GCM_SHA256`の暗号ツールは必ず含まれる。リスナーのプロトコルタイプが`HTTPS`または`TLS`の場合、設定可能 `cipherSuiteList` (任意): クライアントとの暗号化ネゴシエーション時にロードバランサが提供する暗号ツールリスト. `TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA` \| `TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256` \| `TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256` \| `TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA` \| `TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384` \| `TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384` \| `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA` \| `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256` \| `TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256` \| `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA` \| `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384` \| `TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384` \| `TLS_RSA_WITH_AES_128_CBC_SHA` \| `TLS_RSA_WITH_AES_128_CBC_SHA256` \| `TLS_RSA_WITH_AES_128_GCM_SHA256` \| `TLS_RSA_WITH_AES_256_CBC_SHA` \| `TLS_RSA_WITH_AES_256_CBC_SHA256` \| `TLS_RSA_WITH_AES_256_GCM_SHA384` \| `TLS_DHE_RSA_WITH_AES_128_CBC_SHA` \| `TLS_DHE_RSA_WITH_AES_128_CBC_SHA256` \| `TLS_DHE_RSA_WITH_AES_256_CBC_SHA` \| `TLS_DHE_RSA_WITH_AES_256_CBC_SHA256`. デフォルト: すべて選択。リスナーのプロトコルタイプが`HTTPS`または`TLS`の場合、設定可能
`--subnetNoList`	List	Conditional	サブネット番号リスト `subnetNoList`または`loadBalancerSubnetList`のいずれか一方は必ず入力 (両方送信時、`loadBalancerSubnetList`を適用) 選択した VPCに存在するサブネットを選択ゾーンごとにロードバランサ専用サブネットを1つ選択可能スペースで区切って複数入力可能 (例: `--subnetNoList 23456790 23456791`) getSubnetListを参照
`--loadBalancerSubnetList`	List	Conditional	ロードバランサ専用サブネットリスト `subnetNoList`または`loadBalancerSubnetList`のいずれかは必ず入力 (両方渡す場合は`loadBalancerSubnetList`を適用) 各サブネットは、二重引用符の中に{フィールド=‘値’}のペアをコンマで区切って入力 `subnetNo` (条件付き): サブネット番号。`loadBalancerSubnetList`適用時は必ず入力。選択した VPCに存在するサブネットを選択。getSubnetListを参照 `publicIpInstanceNo` (任意): パブリック IPアドレスインスタンス番号。未入力の場合、新しいパブリック IPアドレスを作成して割り当て。ロードバランサのネットワークタイプが`PUBLIC`の場合、設定可能ゾーンごとにロードバランサ専用サブネットを1つ選択可能

任意オプション

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

オプション	タイプ	必須の有無	説明
`--loadBalancerName`	String	Optional	ロードバランサ名英字、数字、記号の`-`を組み合わせて3~30文字以内で入力先頭文字は英字、末尾文字は英字または数字のみ使用未入力の場合、NAVERクラウドプラットフォームが自動付与
`--loadBalancerNetworkTypeCode`	String	Optional	ロードバランサネットワークのタイプ `PUBLIC` (デフォルト)\| `PRIVATE`
`--throughputTypeCode`	String	Optional	負荷処理性能タイプ `SMALL` \| `MEDIUM` \| `LARGE` \| `DYNAMIC` \| `XLARGE` ロードバランサのタイプによって選択できる値が制限されるアプリケーションロードバランサ、ネットワークプロキシロードバランサ: `SMALL`(デフォルト) \| `MEDIUM` \| `LARGE` \| `XLARGE` ネットワークロードバランサ: `DYNAMIC`(デフォルト)
`--idleTimeout`	Integer	Optional	接続維持時間 (秒) `1`~`3600` (デフォルト: `60`) ロードバランサのタイプが`NETWORK`の場合、設定不可
`--loadBalancerDescription`	String	Optional	ロードバランサの説明 (Byte) 0~1,000

共通オプション

vloadbalancerコマンドで共通して使用するオプションについては、Load Balancer (VPC)のオプションをご参照ください。

例

ロードバランサインスタンスの作成リクエストが成功すると、インスタンスの構成情報と作成状態が返されます。

コマンド

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

./ncloud vloadbalancer createLoadBalancerInstance \
    --loadBalancerTypeCode APPLICATION \
    --vpcNo 12345678 \
    --subnetNoList 23456790 \
    --loadBalancerListenerList "protocolTypeCode='HTTP', port='80', targetGroupNo='55667788'" \
    --loadBalancerName lb-test-01 \
    --loadBalancerNetworkTypeCode PRIVATE \
    --throughputTypeCode SMALL \
    --idleTimeout 60 \
    --loadBalancerDescription "Test load balancer" \
    --regionCode KR \
    --output json

出力

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

{
  "createLoadBalancerInstanceResponse": {
    "totalRows": 1,
    "loadBalancerInstanceList": [
      {
        "loadBalancerInstanceNo": "41112223",
        "loadBalancerInstanceStatus": {
          "code": "INIT",
          "codeName": "LB INIT state"
        },
        "loadBalancerInstanceOperation": {
          "code": "CREAT",
          "codeName": "LB CREATE OP"
        },
        "loadBalancerInstanceStatusName": "Creating",
        "loadBalancerDescription": "Test load balancer",
        "createDate": "2026-07-07T17:12:11+0900",
        "loadBalancerName": "lb-test-01",
        "loadBalancerDomain": "lb-test-01-41112223-16dd7a5738c1.kr.lb.naverncp.com",
        "loadBalancerIpList": [],
        "loadBalancerType": {
          "code": "APPLICATION",
          "codeName": "Application Load Balancer"
        },
        "loadBalancerNetworkType": {
          "code": "PRIVATE",
          "codeName": "Private"
        },
        "throughputType": {
          "code": "SMALL",
          "codeName": "Small"
        },
        "idleTimeout": 60,
        "vpcNo": "12345678",
        "regionCode": "KR",
        "accessLogUseYn": "N",
        "subnetNoList": [
          "23456790"
        ],
        "loadBalancerSubnetList": [
          {
            "zoneCode": "KR-1",
            "subnetNo": "23456790",
            "publicIpInstanceNo": ""
          }
        ],
        "loadBalancerListenerNoList": [
          "60001111"
        ]
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}