createLoadBalancerListener

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

로드밸런서에 등록할 새로운 리스너를 생성합니다.

구문

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

./ncloud vloadbalancer createLoadBalancerListener \
    --loadBalancerInstanceNo <load-balancer-instance-no> \
    --protocolTypeCode <HTTP|HTTPS|TCP|UDP|TLS> \
    --port <port> \
    --targetGroupNo <target-group-no> \
    [--useHttp2 <true|false>] \
    [--sslCertificateNo <ssl-certificate-no>] \
    [--tlsMinVersionTypeCode <TLSV10|TLSV11|TLSV12>] \
    [--cipherSuiteList <cipher-suite-list>] \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

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

필수 옵션

createLoadBalancerListener의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--loadBalancerInstanceNo`	String	Required	로드밸런서 인스턴스 번호 getLoadBalancerInstanceList 참조
`--protocolTypeCode`	String	Required	로드밸런서 리스너의 프로토콜 유형 `HTTP` \| `HTTPS` \| `TCP` \| `UDP` \| `TLS` 로드밸런서의 유형에 따라서 선택할 수 있는 값이 제한됨 애플리케이션 로드밸런서: `HTTP` \| `HTTPS` 네트워크 로드밸런서: `TCP` \| `UDP` 네트워크 프록시 로드밸런서: `TCP` \| `TLS`
`--port`	Integer	Required	리스너 포트 `1`~`65534` 기존에 등록된 리스너 포트와 중복 불가
`--targetGroupNo`	String	Required	타깃 그룹의 번호 선택한 타깃 그룹은 리스너의 기본 규칙에 적용됨 다른 로드밸런서에서 사용 중인 타깃 그룹 이용 불가 로드밸런서의 유형과 타깃 그룹의 프로토콜 유형에 따라서 선택할 수 있는 타깃 그룹이 제한됨 애플리케이션 로드밸런서: `HTTP` \| `HTTPS` 네트워크 로드밸런서: `TCP` \| `UDP` 네트워크 프록시 로드밸런서: `PROXY_TCP` getTargetGroupList 참조
`--sslCertificateNo`	String	Conditional	SSL 인증서 번호 리스너의 프로토콜 유형이 `HTTPS` 또는 `TLS`이면 SSL 인증서 설정 필수 getCertificateList 참조

선택 옵션

createLoadBalancerListener의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`--useHttp2`	Boolean	Optional	HTTP/2 프로토콜 사용 여부 `true` \| `false` (기본값) `true`: 사용 `false`: 사용 안 함 리스너의 프로토콜 유형이 `HTTPS`이면 설정 가능
`--tlsMinVersionTypeCode`	String	Optional	TLS 최소 지원 버전 `TLSV10` (기본값) \| `TLSV11` \| `TLSV12` `TLSV10`: TLS 1.0 `TLSV11`: TLS 1.1 `TLSV12`: TLS 1.2 리스너의 프로토콜 유형이 `HTTPS` 또는 `TLS`이면 설정 가능
`--cipherSuiteList`	List	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`이면 설정 가능 공백으로 구분하여 여러 개 입력 가능

공통 옵션

vloadbalancer 명령에서 공통으로 사용하는 옵션에 대한 정보는 Load Balancer (VPC) 옵션을 참조해 주십시오.

예시

로드밸런서 리스너 생성 요청이 성공하면 로드밸런서에 등록된 리스너의 구성 정보가 반환됩니다.

명령

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

./ncloud vloadbalancer createLoadBalancerListener \
    --loadBalancerInstanceNo 41112223 \
    --protocolTypeCode HTTP \
    --port 8080 \
    --targetGroupNo 55667799 \
    --regionCode KR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "createLoadBalancerListenerResponse": {
    "totalRows": 2,
    "loadBalancerListenerList": [
      {
        "loadBalancerInstanceNo": "41112223",
        "loadBalancerListenerNo": "60001111",
        "protocolType": {
          "code": "HTTP",
          "codeName": "HTTP protocol"
        },
        "port": 80,
        "useHttp2": false,
        "sslCertificateNo": "",
        "tlsMinVersionType": {},
        "loadBalancerRuleNoList": [
          "70001111"
        ],
        "cipherSuiteList": []
      },
      {
        "loadBalancerInstanceNo": "41112223",
        "loadBalancerListenerNo": "60002222",
        "protocolType": {
          "code": "HTTP",
          "codeName": "HTTP protocol"
        },
        "port": 8080,
        "useHttp2": false,
        "sslCertificateNo": "",
        "tlsMinVersionType": {},
        "loadBalancerRuleNoList": [
          "70002222"
        ],
        "cipherSuiteList": []
      }
    ],
    "requestId": "9b5e1000-9fd1-47c0-ae17-7ee65fa35691",
    "returnCode": "0",
    "returnMessage": "success"
  }
}