---
title: "createLoadBalancerInstance"
slug: "networking-loadbalancing-createloadbalancerinstance"
updated: 2026-09-17T09:58:20Z
published: 2026-09-17T09:58:20Z
canonical: "api.ncloud-docs.com/networking-loadbalancing-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

Classic環境で利用できます。

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

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| GET | /loadbalancer/v2/createLoadBalancerInstance |

### リクエストヘッダ

Load Balancer APIで共通して使用されるヘッダの詳細は、[Load Balancerのリクエストヘッダ](/docs/ja/networking-loadbalancing#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `loadBalancerName` | String | Optional | 作成するロードバランサの名前 - NAVERクラウドプラットフォームが自動付与(デフォルト) - 3~30文字 |
| `loadBalancerAlgorithmTypeCode` | String | Optional | ロードバランシングに使用するアルゴリズムタイプ - `RR`(デフォルト) \| `SIPHS` \| `LC` - `RR`: Round Robin - `SIPHS`: Source IP Hash - `LC`: Least Connection |
| `loadBalancerDescription` | String | Optional | ロードバランサの説明(Byte) - 0~1,000 |
| `networkUsageTypeCode` | String | Optional | ロードバランサのネットワークタイプ - `PBLIP`(デフォルト) \| `PRVT` - `PBLIP` (Public): グローバル IPアドレス - `PRVT` (Private): プライベート IPアドレス |
| `serverInstanceNoList.N` | String | Optional | ロードバランサにバインドするサーバインスタンスの番号リスト - [getLoadBalancancerTargetServerInstanceList](/docs/ja/networking-loadbalancing-getloadbalancertargetserverinstancelist)を参照 |
| `loadBalancerRuleList.N.protocolTypeCode` | String | Required | ロードバランサルールのプロトコルタイプ - `HTTP` \| `HTTPS` \| `TCP` \| `SSL` |
| `loadBalancerRuleList.N.loadBalancerPort` | Integer | Required | ロードバランサルールのポート - 1~65534 - 同じロードバランサでポートは重複不可 - 22、3389、64000、65130、65131、18080~18095ポートはロードバランサ管理用として使用不可 |
| `loadBalancerRuleList.N.serverPort` | Integer | Required | ロードバランサルールのサーバポート - 1~65534 - 同じロードバランサでポート重複可能 |
| `loadBalancerRuleList.N.l7HealthCheckPath` | String | Conditional | ロードバランサルールのヘルスチェックパス - `/`(デフォルト) - `/`で始まる URLパス - `loadBalancerRuleList.N.protocolTypeCode`が`HTTP`または`HTTPS`の場合、必ず入力 |
| `loadBalancerRuleList.N.certificateName` | String | Conditional | ロードバランサの SSL証明書名 `loadBalancerRuleList.N.protocloTypeCode`が`SSL`または`HTTPS`の場合、必ず入力 |
| `loadBalancerRuleList.N.proxyProtocolUseYn` | String | Optional | プロキシプロトコルの使用有無 - `Y` \| `N` - `Y`: 設定 - `N`: 解除 - `loadBalancerRuleList.N.protocloTypeCode`が`TCP`または`SSL`の場合、設定可能 |
| `loadBalancerRuleList.N.stickySessionUseYn` | String | Optional | セッション別アクセスの使用有無 - `Y` \| `N` - `Y`: 設定 - `N`: 解除 - `loadBalancerRuleList.N.protocloTypeCode`が`HTTP`または`HTTPS`の場合、設定可能 |
| `loadBalancerRuleList.N.http2UseYn` | String | Optional | HTTP/2プロトコルの使用有無 - `Y` \| `N` - `Y`: 設定 - `N`: 解除 - `loadBalancerRuleList.N.protocloTypeCode`が`HTTPS`の場合、設定可能 |
| `loadBalancerRuleList.N.serverProtocolTypeCode` | String | Optional | サーバのプロトコルタイプ - `HTTP`(デフォルト) \| `HTTPS` - `loadBalancerRuleList.N.protocloTypeCode` `HTTPS`の場合、設定可能 |
| `regionNo` | String | Optional | ロードバランサ作成対象のリージョン番号[getRegionList](/docs/ja/compute-server-getregionlist)を参照リージョンとゾーンの両方を入力しない場合、韓国リージョンのゾーンに任意に割り当て |
| `zoneNoList` | List[String] | Optional | ロードバランサ作成対象のゾーン番号リスト - `zoneNo`は[getRegionList](/docs/ja/compute-server-getregionlist)を参照 - プライベート IPアドレスのロードバランサは1つのゾーンのみ選択可能で、マルチゾーンはサポート予定 |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location 'https://ncloud.apigw.ntruss.com/loadbalancer/v2/createLoadBalancerInstance?loadBalancerRuleList.1.l7HealthCheckPath=/&loadBalancerRuleList.1.loadBalancerPort=80&loadBalancerRuleList.1.protocolTypeCode=HTTP&loadBalancerRuleList.1.serverPort=80' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ

レスポンスボディの詳細は、[LoadBalancerInstance](/docs/ja/common-apidatatype-loadbalancerinstance)をご参照ください。

### レスポンスステータスコード

Load Balancer APIで共通して使用されるレスポンスステータスコードの詳細は、[Load Balancerのレスポンスステータスコード](/docs/ja/networking-loadbalancing#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

```
<createLoadBalancerInstanceResponse>
    <requestId>1e3eac26-c57e-4c8b-b6b0-ba3fe2330a61</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <loadBalancerInstanceList>
        <loadBalancerInstance>
            <loadBalancerInstanceNo>********</loadBalancerInstanceNo>
            <virtualIp>***.***.***.***,**.***.***.***</virtualIp>
            <loadBalancerName>YOUR_LOAD_BALANCER</loadBalancerName>
            <loadBalancerAlgorithmType>
                <code>RR</code>
                <codeName>Round Robin</codeName>
            </loadBalancerAlgorithmType>
            <loadBalancerDescription></loadBalancerDescription>
            <createDate>2024-06-07T19:28:24+0900</createDate>
            <domainName>slb-24784632.ncloudslb.com</domainName>
            <loadBalancerInstanceStatusName>creating</loadBalancerInstanceStatusName>
            <loadBalancerInstanceStatus>
                <code>INIT</code>
                <codeName>NET INIT state</codeName>
            </loadBalancerInstanceStatus>
            <loadBalancerInstanceOperation>
                <code>USE</code>
                <codeName>NET USE OP</codeName>
            </loadBalancerInstanceOperation>
            <networkUsageType>
                <code>PBLIP</code>
                <codeName>Public</codeName>
            </networkUsageType>
            <isHttpKeepAlive>false</isHttpKeepAlive>
            <connectionTimeout>60</connectionTimeout>
            <certificateName></certificateName>
            <region>
                <regionNo>1</regionNo>
                <regionCode>KR</regionCode>
                <regionName>Korea</regionName>
            </region>
            <zoneList>
                <zone>
                    <zoneNo>2</zoneNo>
                    <zoneName>KR-1</zoneName>
                    <zoneCode>KR-1</zoneCode>
                    <zoneDescription>加山 zone</zoneDescription>
                    <regionNo>1</regionNo>
                </zone>
            </zoneList>
            <loadBalancerRuleList>
                <loadBalancerRule>
                    <protocolType>
                        <code>HTTP</code>
                        <codeName>http</codeName>
                    </protocolType>
                    <loadBalancerPort>80</loadBalancerPort>
                    <serverPort>80</serverPort>
                    <l7HealthCheckPath>/</l7HealthCheckPath>
                    <certificateName></certificateName>
                    <proxyProtocolUseYn>N</proxyProtocolUseYn>
                    <stickySessionUseYn>N</stickySessionUseYn>
                    <http2UseYn>N</http2UseYn>
                </loadBalancerRule>
            </loadBalancerRuleList>
            <loadBalancedServerInstanceList/>
        </loadBalancerInstance>
    </loadBalancerInstanceList>
</createLoadBalancerInstanceResponse>
```