--- title: "createLoadBalancerInstance" slug: "networking-vloadbalancer-loadbalancer-createloadbalancerinstance" tags: ["Load Balancer"] updated: 2026-09-17T09:58:20Z published: 2026-09-17T09:58:20Z canonical: "api.ncloud-docs.com/networking-vloadbalancer-loadbalancer-createloadbalancerinstance" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # createLoadBalancerInstance VPC環境で利用できます。 ロードバランサインスタンスを作成します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | GET | /vloadbalancer/v2/createLoadBalancerInstance | ### リクエストヘッダ Load Balancer APIで共通して使用されるヘッダの詳細は、[Load Balancerのリクエストヘッダ](/docs/ja/networking-vloadbalancer#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `regionCode` | String | Optional | 作成するロードバランサインスタンスのリージョンコード - getRegionList照会結果の最初のリージョン(デフォルト) - [getRegionList](/docs/ja/compute-vserver-server-common-getregionlist)を参照 | | `loadBalancerTypeCode` | String | Required | ロードバランサタイプ - `APPLICATION` \| `NETWORK` \| `NETWORK_PROXY` | | `loadBalancerName` | String | Optional | ロードバランサの名前 - NAVERクラウドプラットフォームが自動付与(デフォルト) - 英数字、記号の「-」を組み合わせて3~30文字以内で入力 - 先頭文字は英字のみを、末尾文字は英字または数字のみ使用 | | `loadBalancerNetworkTypeCode` | String | Optional | ロードバランサのネットワークタイプ - `PUBLIC` (デフォルト) \| `PRIVATE` | | `throughputTypeCode` | String | Optional | 負荷処理性能タイプ - `SMALL` \| `MEDIUM` \| `LARGE` \| `DYNAMIC`\| `XLARGE` - ロードバランサのタイプによって選択できる値が制限される - アプリケーション、ネットワークプロキシロードバランサ: `SMALL` (デフォルト) \| `MEDIUM` \| `LARGE`\| `XLARGE` - ネットワークロードバランサ: `DYNAMIC` (デフォルト) | | `idleTimeout` | Integer | Optional | 接続維持時間(秒) - 1~3,600 (デフォルト: 60) - ロードバランサのタイプが`NETWORK`の場合、設定不可 | | `vpcNo` | String | Required | 作成するロードバランサの VPC番号 - [getVpcList](/docs/ja/networking-vpc-vpcmanagement-getvpclist)を参照 | | `loadBalancerDescription` | String | Optional | ロードバランサの説明(Byte) - 0~1,000 | | `subnetNoList.N` | List[String] | Conditional | サブネットの番号リスト - `subnetNoList`または`loadBalancerSubnetList`は必ず入力 - すべて渡す場合、`loadBalancerSubnetList`を適用 - 選択した VPCに位置するサブネットを選択 - ゾーンごとに1つのロードバランサ専用サブネットを選択可能 - `subnetNo`は[getSubnetList](/docs/ja/networking-vpc-subnetmanagement-getsubnetlist)を参照 - <例> subnetNoList.1=1234&subnetNoList.2=2345 | | `loadBalancerSubnetList.N.subnetNo` | String | Conditional | サブネット番号 - `subnetNoList`または`loadBalancerSubnetList`は必ず入力 - すべて渡す場合、`loadBalancerSubnetList`を適用 - `loadBalancerSubnetList`を適用する場合、`loadBalancerSubnetList.N.subnetNo`は必須入力 - 選択した VPCに位置するサブネットを選択 - ゾーンごとに1つのロードバランサ専用サブネットを選択可能 - `subnetNo`は[getSubnetList](/docs/ja/networking-vpc-subnetmanagement-getsubnetlist)を参照 | | `loadBalancerSubnetList.N.publicIpInstanceNo` | String | Optional | グローバル IPアドレスインスタンス番号 - 新しいグローバル IPアドレスを作成して割り当て(デフォルト) - ロードバランサのネットワークタイプが`PUBLIC`の場合、設定可能 | | `loadBalancerListenerList.N.protocolTypeCode` | String | Optional | ロードバランサリスナーのプロトコルタイプ - `HTTP` \| `HTTPS` \| `TCP` \| `UDP` \| `TLS` - ロードバランサのタイプに応じて選択可能な値が制限される - アプリケーションロードバランサ: `HTTP` (デフォルト) \| `HTTPS` - ネットワークロードバランサ: `TCP` (デフォルト) \| `UDP` - ネットワークプロキシロードバランサ: `TCP` (デフォルト) \| `TLS` | | `loadBalancerListenerList.N.port` | Integer | Optional | ロードバランサリスナーのポート - 1~65534 - リスナーのプロトコルタイプに応じてデフォルト値が決まる - `HTTP`、`TCP`、`UDP`プロトコル: 80 - `HTTPS`、`TLS`プロトコル: 443 - 現在登録されているリスナーポートと重複不可 | | `loadBalancerListenerList.N.targetGroupNo` | String | Required | 各リスナーの基本ルールに適用されるターゲットグループ番号 - `targetGroupNo`は[getTargetGroupList](/docs/ja/networking-vloadbalancer-targetgroup-gettargetgrouplist)を参照 - ロードバランサのタイプとターゲットグループのプロトコルタイプに応じて使用可能なターゲットグループが制限される - アプリケーションロードバランサ: `HTTP` \| `HTTPS` - ネットワークロードバランサ: `TCP` \| `UDP` - ネットワークプロキシロードバランサ: `PROXY_TCP` - 他のロードバランサで既に使用中のターゲットグループは使用不可 | | `loadBalancerListenerList.N.useHttp2` | Boolean | Optional | HTTP/2プロトコルの使用有無 - `true` \| `false` (デフォルト) - リスナーのプロトコルタイプが`HTTPS`の場合、設定可能 | | `loadBalancerListenerList.N.sslCertificateNo` | String | Conditional | SSL証明書番号 - `sslCertificateNo`は[getCertificateList](/docs/ja/security-certificatemanager-getcertificatelist)を参照 - リスナーのプロトコルタイプが`HTTPS`または`TLS`の場合、SSL証明書を必ず設定 | | `loadBalancerListenerList.N.tlsMinVersionTypeCode` | String | Optional | TLSの最小サポートバージョン - `TLSV10` (デフォルト) \| `TLSV11` \| `TLSV12` \| `TLSV13` - `TLSV10`: TLS 1.0 - `TLSV11`: TLS 1.1 - `TLSV12`: TLS 1.2 - `TLSV13`: TLS 1.3 - リスナーのプロトコルタイプが`HTTPS`または`TLS`の場合、設定可能 - `TLS_AES_256_GCM_SHA384`、`TLS_CHACHA20_POLY1305_SHA256`、`TLS_AES_128_GCM_SHA256`暗号化ツールは常に含める | | `loadBalancerListenerList.N.cipherSuiteList.N` | List[String] | Optional | クライアントとの暗号化ネゴシエーション時にロードバランサが提供する暗号ツールリスト - `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` - Select All (デフォルト) - リスナーのプロトコルタイプが`HTTPS`または`TLS`の場合、設定可能 | | `responseFormatType` | String | Optional | レスポンス結果の形式 - `xml`(デフォルト) \| `json` | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl --location 'https://ncloud.apigw.ntruss.com/vloadbalancer/v2/createLoadBalancerInstance?regionCode=KR&loadBalancerTypeCode=APPLICATION&loadBalancerName=YOUR_LOAD_BALANCER&loadBalancerNetworkTypeCode=PRIVATE&throughputTypeCode=SMALL&idleTimeout=60&vpcNo=*****&subnetNoList.1=******&loadBalancerListenerList.1.protocolTypeCode=HTTP&loadBalancerListenerList.1.port=80&loadBalancerListenerList.1.targetGroupNo=*******' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの詳細は、[LoadBalancerInstanceList](/docs/ja/common-vapidatatype-loadbalancerinstancelist)をご参照ください。 ### レスポンスステータスコード Load Balancer APIで共通して使用されるレスポンスステータスコードの詳細は、[Load Balancerのレスポンスステータスコード](/docs/ja/networking-vloadbalancer#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` 48df95ef-b0bc-4338-bbc8-7126965c0987 0 success 1 ******** INIT LB INIT state CREAT LB CREATE OP Creating 2024-06-03T18:52:28+0900 YOUR_LOAD_BALANCER ***.com APPLICATION Application Load Balancer PRIVATE Private SMALL Small 60 ***** KR ****** KR-1 ****** ****** ```