changeLoadBalancerListenerConfiguration

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

로드밸런서 리스너의 설정을 변경합니다.

구문

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

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

옵션

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

필수 옵션

changeLoadBalancerListenerConfiguration의 필수 옵션입니다.

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

선택 옵션

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

옵션	타입	필수 여부	설명
`--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`로 신규 설정 시 전체 선택 (리스너 프로토콜을 변경하지 않으면 기존 설정 유지) 리스너의 프로토콜 유형이 `HTTPS` 또는 `TLS`이면 설정 가능

공통 옵션

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

예시

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

명령

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

./ncloud vloadbalancer changeLoadBalancerListenerConfiguration \
    --loadBalancerListenerNo 60002222 \
    --protocolTypeCode HTTP \
    --port 9090 \
    --regionCode KR \
    --output json

출력

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

{
  "changeLoadBalancerListenerConfigurationResponse": {
    "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": 9090,
        "useHttp2": false,
        "sslCertificateNo": "",
        "tlsMinVersionType": {},
        "loadBalancerRuleNoList": [
          "70002222"
        ],
        "cipherSuiteList": []
      }
    ],
    "requestId": "62f2071a-05c3-4880-9e1d-2b26777fa5ce",
    "returnCode": "0",
    "returnMessage": "success"
  }
}