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

オプション

changeLoadBalancerListenerConfigurationの実行時に指定できるオプションについて説明します。

必須オプション

changeLoadBalancerListenerConfigurationの必須オプションです。

オプション	タイプ	必須の有無	説明
`--loadBalancerListenerNo`	String	Required	ロードバランサリスナー番号 getLoadBalancerListenerListを参照
`--protocolTypeCode`	String	Required	ロードバランサのリスナーのプロトコルタイプ `HTTP` \| `HTTPS` \| `TCP` \| `UDP` \| `TLS` ロードバランサのタイプによって、選択できる値に制限があるアプリケーションロードバランサ: `HTTP` \| `HTTPS` ネットワークロードバランサ: `TCP` \| `UDP` ネットワークプロキシロードバランサ: `TCP` \| `TLS` `UDP`プロトコルは、シンガポールおよび日本のリージョンでのみ利用可能
`--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": "d0e1f2a3-b4c5-6789-defa-012345678901",
    "returnCode": "0",
    "returnMessage": "success"
  }
}