changeLoadBalancerListenerConfiguration

Article Summary

Share feedback

Thanks for sharing your feedback!

Available in VPC

Overview

Changes the load balancer listener settings.

Requests

Request parameters

Parameter name	Requirement status	Type	Restrictions	Description
regionCode	No	String		- Region code You can decide the region of the load balancer instance to change the load balancer listener settings. regionCode can be obtained via the getRegionList action Default: Selects the first region of the getRegionList query results
loadBalancerListenerNo	Yes	String		- Listener number of the load balancer to change settings for You can obtain loadBalancerListenerNo through getLoadBalancerListenerList action.
protocolTypeCode	Yes	String		- Listener protocol type code The available type of listener protocols is limited, depending on the load balancer type where the listener is registered. `APPLICATION : HTTP / HTTPS` `NETWORK : TCP / UDP` `NETWORK_PROXY : TCP / TLS` UDP protocol is only available in SGN (Singapore) and JPN (Japan) regions.
port	Yes	Integer	Min : 1, Max : 65534	- Listener port The listener port must be unique.
useHttp2	No	Boolean		- HTTP/2 protocol usage status Options : true \| false Default : false It is only valid if the listener protocol type is HTTPS.
sslCertificateNo	Conditional	String		- SSL certificate number If the listener protocol type is either HTTPS or TLS, you must set the SSL certificate. You can obtain the sslCertificateNo through the GET https://certificatemanager.apigw.ntruss.com/api/v1/certificates action.
tlsMinVersionTypeCode	No	String		- Minimum support version type code of TLS It is only valid if the listener protocol type is either HTTPS or TLS. Options : `TLSV10 (TLSv1.0)` `TLSV11 (TLSv1.1)` `TLSV12 (TLSv1.2)` Default : TLSV10
cipherSuiteList.N	No	List<String>		- Cipher suite list Selects the encryption features to be provided by the load balancer in encryption negotiation with the client. It can only be specified if the listener protocol type is HTTPS or TLS. Options : `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 : If you are setting a new listener protocol as HTTPS or TLS `Select All` If there is no listener protocol change `Maintain existing cipher suite settings`
responseFormatType	No	String		- Format type of the response result Options : xml \| json Default : xml

Responses

Response bodies

LoadBalancerListenerList

Examples

Request examples

GET {API_URL}/changeLoadBalancerListenerConfiguration
?regionCode=KR
&loadBalancerListenerNo=***961
&protocolTypeCode=HTTP
&port=80

Response examples

<changeLoadBalancerListenerConfigurationResponse>
  <requestId>55fc050c-3006-4472-bd96-2cb3b1547a53</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <loadBalancerListenerList>
    <loadBalancerListener>
      <loadBalancerInstanceNo>***887</loadBalancerInstanceNo>
      <loadBalancerListenerNo>***961</loadBalancerListenerNo>
      <protocolType>
        <code>HTTP</code>
        <codeName>HTTP protocol</codeName>
      </protocolType>
      <port>80</port>
      <useHttp2>false</useHttp2>
      <sslCertificateNo></sslCertificateNo>
      <tlsMinVersionType/>
      <loadBalancerRuleNoList>
        <loadBalancerRuleNo>***444</loadBalancerRuleNo>
      </loadBalancerRuleNoList>
      <cipherSuiteList/>
    </loadBalancerListener>
  </loadBalancerListenerList>
</changeLoadBalancerListenerConfigurationResponse>

Was this article helpful?

What's Next

getLoadBalancerRuleList

Table of contents

Overview
Requests
Responses
Examples