--- title: "createLoadBalancerInstance" slug: "networking-vloadbalancer-loadbalancer-createloadbalancerinstance" tags: ["Load Balancer"] updated: 2026-09-17T09:16:52Z published: 2026-09-17T09:16:52Z 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/networking-vloadbalancer#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. ### 요청 쿼리 파라미터 요청 쿼리 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `regionCode` | String | Optional | 생성하려는 로드 밸런서 인스턴스의 리전 코드 - getRegionList 조회 결과의 첫 번째 리전(기본값) - [getRegionList](/docs/compute-vserver-server-common-getregionlist) 참조 | | `loadBalancerTypeCode` | String | Required | 로드 밸런서의 유형 - `APPLICATION` \| `NETWORK` \| `NETWORK_PROXY` | | `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~3,600 (기본값: 60) - 로드 밸런서의 유형이 `NETWORK`이면 설정 불가 | | `vpcNo` | String | Required | 생성하려는 로드 밸런서의 VPC 번호 - [getVpcList](/docs/networking-vpc-vpcmanagement-getvpclist) 참조 | | `loadBalancerDescription` | String | Optional | 로드 밸런서에 대한 설명(Byte) - 0~1,000 | | `subnetNoList.N` | List[String] | Conditional | 서브넷의 번호 목록 - `subnetNoList` 또는 `loadBalancerSubnetList` 필수 입력 - 모두 전달 시 `loadBalancerSubnetList` 적용 - 선택한 VPC에 위치하는 서브넷 선택 - 존별로 한 개의 로드 밸런서 전용 서브넷 선택 가능 - `subnetNo`는 [getSubnetList](/docs/networking-vpc-subnetmanagement-getsubnetlist) 참조 - <예시> subnetNoList.1=1234&subnetNoList.2=2345 | | `loadBalancerSubnetList.N.subnetNo` | String | Conditional | 서브넷 번호 - `subnetNoList` 또는 `loadBalancerSubnetList` 필수 입력 - 모두 전달 시 `loadBalancerSubnetList` 적용 - `loadBalancerSubnetList` 적용 시 `loadBalancerSubnetList.N.subnetNo` 필수 입력 - 선택한 VPC에 위치하는 서브넷 선택 - 존별로 한 개의 로드 밸런서 전용 서브넷 선택 가능 - `subnetNo`는 [getSubnetList](/docs/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/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/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/common-vapidatatype-loadbalancerinstancelist)를 참조해 주십시오. ### 응답 상태 코드 Load Balancer API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Load Balancer 응답 상태 코드](/docs/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 ****** ****** ```