createLoadBalancerInstance

VPC 환경에서 이용 가능합니다.

로드밸런서 인스턴스를 생성합니다.

구문

createLoadBalancerInstance 구문은 다음과 같습니다.

./ncloud vloadbalancer createLoadBalancerInstance \
    --loadBalancerTypeCode <APPLICATION|NETWORK|NETWORK_PROXY> \
    --vpcNo <vpc-no> \
    --subnetNoList <subnet-no-list> | --loadBalancerSubnetList <lb-subnet-config> \
    --loadBalancerListenerList <listener-config> \
    [--loadBalancerName <load-balancer-name>] \
    [--loadBalancerNetworkTypeCode <PUBLIC|PRIVATE>] \
    [--throughputTypeCode <SMALL|MEDIUM|LARGE|DYNAMIC|XLARGE>] \
    [--idleTimeout <idle-timeout>] \
    [--loadBalancerDescription <load-balancer-description>] \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

createLoadBalancerInstance 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

createLoadBalancerInstance의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--loadBalancerTypeCode`	String	Required	로드밸런서 유형 `APPLICATION` \| `NETWORK` \| `NETWORK_PROXY` `APPLICATION`: 애플리케이션 로드밸런서 `NETWORK`: 네트워크 로드밸런서 `NETWORK_PROXY`: 네트워크 프록시 로드밸런서
`--vpcNo`	String	Required	VPC 번호 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 참조 `useHttp2` (Optional): HTTP/2 프로토콜 사용 여부. `true` \| `false` (기본값). 리스너의 프로토콜 유형이 `HTTPS`이면 설정 가능 `sslCertificateNo` (Conditional): SSL 인증서 번호. 리스너의 프로토콜 유형이 `HTTPS` 또는 `TLS`이면 SSL 인증서 설정 필수. 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 참조
`--loadBalancerSubnetList`	List	Conditional	로드밸런서 전용 서브넷 목록 `subnetNoList` 또는 `loadBalancerSubnetList` 중 하나는 필수 입력 (모두 전달 시 `loadBalancerSubnetList` 적용) 각 서브넷은 따옴표 안에 {필드='값'} 쌍을 콤마로 구분하여 입력 `subnetNo` (Conditional): 서브넷 번호. `loadBalancerSubnetList` 적용 시 필수 입력. 선택한 VPC에 위치하는 로드밸런서 전용 서브넷 선택. 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 (VPC) 옵션을 참조해 주십시오.

예시

로드밸런서 인스턴스 생성 요청이 성공하면 인스턴스의 구성 정보와 생성 상태가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./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 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-21T10:51:04+0900",
        "loadBalancerName": "lb-test-01",
        "loadBalancerDomain": "lb-test-01-41112223-8839ccafe6cb.kr-gov.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": [
          "23456789"
        ],
        "loadBalancerSubnetList": [
          {
            "zoneCode": "KR-1",
            "subnetNo": "23456789",
            "publicIpInstanceNo": ""
          }
        ],
        "loadBalancerListenerNoList": [
          "60001111"
        ]
      }
    ],
    "requestId": "a12c4eef-8b61-4ff0-ab94-4a3397020223",
    "returnCode": "0",
    "returnMessage": "success"
  }
}