changeLoadBalancerListenerConfiguration

Available in VPC

Change the load balancer listener settings.

Syntax

The changeLoadBalancerListenerConfiguration syntax is as follows:

./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|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running changeLoadBalancerListenerConfiguration.

Required options

The following options are required for changeLoadBalancerListenerConfiguration.

Options	Type	Required	Description
`--loadBalancerListenerNo`	String	Required	Load balancer listener number See getLoadBalancerListenerList.
`--protocolTypeCode`	String	Required	Load balancer listener protocol type `HTTP` \| `HTTPS` \| `TCP` \| `UDP` \| `TLS` Available values are limited depending on the load balancer type. Application Load Balancer: `HTTP` \| `HTTPS` Network Load Balancer: `TCP` \| `UDP` Network Proxy Load Balancer: `TCP` \| `TLS` `UDP` protocol is available only in the Singapore and Japan Regions.
`--port`	Integer	Required	Load balancer listener port `1`-`65534` Can't be duplicated with existing listener ports.
`--sslCertificateNo`	String	Conditional	SSL certificate number An SSL certificate must be configured if the listener’s protocol type is `HTTPS` or `TLS`. See getCertificateList.

Optional options

These are the optional options for changeLoadBalancerListenerConfiguration. Options that are not specified will use their default values.

Options	Type	Required	Description
`--useHttp2`	Boolean	Optional	Whether to use the HTTP/2 protocol `true` \| `false` (default) `true`: Enabled. `false`: Disabled. Can be set if the listener's protocol type is `HTTPS`.
`--tlsMinVersionTypeCode`	String	Optional	Minimum supported TLS version `TLSV10` (default) \| `TLSV11` \| `TLSV12` `TLSV10`: TLS 1.0 `TLSV11`: TLS 1.1 `TLSV12`: TLS 1.2 Can be set if the listener protocol type is `HTTPS` or `TLS`.
`--cipherSuiteList`	List	Optional	List of cipher suites provided by the load balancer during encryption negotiation with the client `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` Default: Select all when setting up a new listener protocol as `HTTPS` or `TLS` (existing settings are retained if the listener protocol is not changed). This setting is available if the listener's protocol type is `HTTPS` or `TLS`.

Common options

For information about the options common to all vloadbalancer subcommands, see Load Balancer (VPC) options.

Examples

If the request to change the load balancer listener settings is successful, the configuration information for the listeners registered with the load balancer is returned.

Command

The command example is as follows:

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

Output

The output example is as follows:

{
  "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": "d0e1f2a3-b4c5-6789-defa-012345678901",
    "returnCode": "0",
    "returnMessage": "success"
  }
}