--- title: "createLoadBalancerInstance" slug: "cli-vloadbalancer-loadbalancer-createloadbalancerinstance" tags: ["Load Balancer", "VPC"] updated: 2026-10-08T09:57:50Z published: 2026-10-08T09:57:50Z canonical: "cli.ncloud-docs.com/cli-vloadbalancer-loadbalancer-createloadbalancerinstance" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # createLoadBalancerInstance VPC環境で利用できます。 ロードバランサインスタンスを作成します。 ## 構文 `createLoadBalancerInstance`構文は次の通りです。 ``` ./ncloud vloadbalancer createLoadBalancerInstance \ --loadBalancerTypeCode \ --vpcNo \ --subnetNoList | --loadBalancerSubnetList \ --loadBalancerListenerList \ [--loadBalancerName ] \ [--loadBalancerNetworkTypeCode ] \ [--throughputTypeCode ] \ [--idleTimeout ] \ [--loadBalancerDescription ] \ [--regionCode ] \ [--output ] ``` ## オプション `createLoadBalancerInstance`の実行時に指定できるオプションについて説明します。 ### 必須オプション `createLoadBalancerInstance`の必須オプションです。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--loadBalancerTypeCode` | String | Required | ロードバランサのタイプ - `APPLICATION` \| `NETWORK` \| `NETWORK_PROXY` - `APPLICATION`: アプリケーションロードバランサ - `NETWORK`: ネットワークロードバランサ - `NETWORK_PROXY`: ネットワークプロキシロードバランサ | | `--vpcNo` | String | Required | VPC番号 - [getVpcList](/docs/ja/cli-vpc-vpcmanagement-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](/docs/ja/cli-vloadbalancer-targetgroup-gettargetgrouplist)を参照 - `useHttp2`(任意): HTTP/2プロトコルを使用するか。`true` \| `false` (デフォルト)。リスナーのプロトコルタイプが`HTTPS`の場合に設定可能 - `sslCertificateNo` (条件付き): SSL証明書番号。リスナーのプロトコルタイプが`HTTPS`または`TLS`の場合、SSL証明書の設定は必須。[getCertificateList](/docs/ja/security-certificatemanager-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](/docs/ja/cli-vpc-subnetmanagement-getsubnetlist)を参照 | | `--loadBalancerSubnetList` | List | Conditional | ロードバランサ専用サブネットリスト - `subnetNoList`または`loadBalancerSubnetList`のいずれかは必ず入力 (両方渡す場合は`loadBalancerSubnetList`を適用) - 各サブネットは、二重引用符の中に{フィールド=‘値’}のペアをコンマで区切って入力 - `subnetNo` (条件付き): サブネット番号。`loadBalancerSubnetList`適用時は必ず入力。選択した VPCに存在するサブネットを選択。[getSubnetList](/docs/ja/cli-vpc-subnetmanagement-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)のオプション](/docs/ja/cli-vloadbalancer#%EC%98%B5%EC%85%98)をご参照ください。 ## 例 ロードバランサインスタンスの作成リクエストが成功すると、インスタンスの構成情報と作成状態が返されます。 ### コマンド コマンドの例は次の通りです。 ``` ./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" } } ```