--- title: "createLoadBalancerInstance" slug: "cli-vloadbalancer-loadbalancer-createloadbalancerinstance" tags: ["Load Balancer"] updated: 2026-09-17T09:10:37Z published: 2026-09-17T09:10:37Z canonical: "cli-fin.ncloud-docs.com/cli-vloadbalancer-loadbalancer-createloadbalancerinstance" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # createLoadBalancerInstance 로드밸런서 인스턴스를 생성합니다. ## 구문 `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/cli-vpc-vpcmanagement-getvpclist) 참조 | | `--loadBalancerListenerList` | List | Required | 로드밸런서 리스너 목록 - 각 리스너는 따옴표 안에 {필드='값'} 쌍을 콤마로 구분하여 입력 - `protocolTypeCode` (Optional): 로드밸런서 리스너의 프로토콜 유형. 로드밸런서의 유형에 따라서 선택할 수 있는 값이 제한됨. 애플리케이션 로드밸런서: `HTTP` (기본값) \| `HTTPS`, 네트워크 로드밸런서: `TCP` (기본값) \| `UDP`, 네트워크 프록시 로드밸런서: `TCP` (기본값) \| `TLS` - `port` (Optional): 로드밸런서 리스너의 포트. `1`~`65534`. 리스너의 프로토콜 유형에 따라서 기본값이 결정됨 (`HTTP`, `TCP`, `UDP`: `80`, `HTTPS`, `TLS`: `443`). 기존에 등록된 리스너 포트와 중복 불가 - `targetGroupNo` (Required): 각 리스너의 기본 규칙에 적용되는 타깃 그룹 번호. 다른 로드밸런서에서 이미 사용 중인 타깃 그룹 이용 불가. 로드밸런서의 유형과 타깃 그룹의 프로토콜 유형에 따라서 사용 가능한 타깃 그룹이 제한됨 (애플리케이션 로드밸런서: `HTTP` \| `HTTPS`, 네트워크 로드밸런서: `TCP` \| `UDP`, 네트워크 프록시 로드밸런서: `PROXY_TCP`). [getTargetGroupList](/docs/cli-vloadbalancer-targetgroup-gettargetgrouplist) 참조 - `useHttp2` (Optional): HTTP/2 프로토콜 사용 여부. `true` \| `false` (기본값). 리스너의 프로토콜 유형이 `HTTPS`이면 설정 가능 - `sslCertificateNo` (Conditional): SSL 인증서 번호. 리스너의 프로토콜 유형이 `HTTPS` 또는 `TLS`이면 SSL 인증서 설정 필수. [getCertificateList](/docs/security-certificatemanager-getcertificatelist) 참조 - `tlsMinVersionTypeCode` (Optional): 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` (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`. 기본값: 전체 선택. 리스너의 프로토콜 유형이 `HTTPS` 또는 `TLS`이면 설정 가능 | | `--subnetNoList` | List | Conditional | 서브넷의 번호 목록 - `subnetNoList` 또는 `loadBalancerSubnetList` 중 하나는 필수 입력 (모두 전달 시 `loadBalancerSubnetList` 적용) - 선택한 VPC에 위치하는 로드밸런서 전용 서브넷 선택 - [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 참조 | | `--loadBalancerSubnetList` | List | Conditional | 로드밸런서 전용 서브넷 목록 - `subnetNoList` 또는 `loadBalancerSubnetList` 중 하나는 필수 입력 (모두 전달 시 `loadBalancerSubnetList` 적용) - 각 서브넷은 따옴표 안에 {필드='값'} 쌍을 콤마로 구분하여 입력 - `subnetNo` (Conditional): 서브넷 번호. `loadBalancerSubnetList` 적용 시 필수 입력. 선택한 VPC에 위치하는 로드밸런서 전용 서브넷 선택. [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 참조 - `publicIpInstanceNo` (Optional): 공인 IP 인스턴스 번호. 미입력 시 새로운 공인 IP를 생성하여 할당. 로드밸런서의 네트워크의 유형이 `PUBLIC`이면 설정 가능 | ### 선택 옵션 `createLoadBalancerInstance`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--loadBalancerName` | String | Optional | 로드밸런서 이름 - 영문자, 숫자, 특수문자 `-`를 조합하여 3~30자 이내로 입력 - 문자열의 시작은 영문자, 마지막은 영문자 또는 숫자로 구성 - 미입력 시 네이버 클라우드 플랫폼에서 자동으로 부여 | | `--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 옵션](/docs/cli-vloadbalancer#%EC%98%B5%EC%85%98)을 참조해 주십시오. ## 예시 로드밸런서 인스턴스 생성 요청이 성공하면 인스턴스의 구성 정보와 생성 상태가 반환됩니다. ### 명령 명령 예시는 다음과 같습니다. ``` ./ncloud vloadbalancer createLoadBalancerInstance \ --loadBalancerTypeCode APPLICATION \ --vpcNo 12345678 \ --subnetNoList 23456789 \ --loadBalancerListenerList "protocolTypeCode='HTTP', port='80', targetGroupNo='55667788'" \ --loadBalancerName lb-test-01 \ --loadBalancerNetworkTypeCode PRIVATE \ --throughputTypeCode SMALL \ --idleTimeout 60 \ --loadBalancerDescription "Test load balancer" \ --regionCode FKR \ --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-08-13T14:48:47+0900", "loadBalancerName": "lb-test-01", "loadBalancerDomain": "lb-test-01-41112223-acf08113c1c9.kr-fin.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": "FKR", "accessLogUseYn": "N", "subnetNoList": [ "23456789" ], "loadBalancerSubnetList": [ { "zoneCode": "FKR-1", "subnetNo": "23456789", "publicIpInstanceNo": "" } ], "loadBalancerListenerNoList": [ "60001111" ] } ], "requestId": "d8c58cc1-a34c-43b0-90b2-fd3903b451a4", "returnCode": "0", "returnMessage": "success" } } ```