changeLoadBalancedServerInstances

Article Summary

Share feedback

Thanks for sharing your feedback!

Overview

Changes server instances bound to a load balancer. The previous binding information is reset, and new server instances are bound to the load balancer.

Request

Request header

Header	Description
x-ncp-apigw-timestamp	It is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC. If the time difference with the API Gateway server is more than 5 minutes, the request is considered invalid.
x-ncp-apigw-api-key	API key issued by API Gateway (not used in the API v2.)
x-ncp-iam-access-key	API key issued by NAVER Cloud Platform or access key issued by IAM
x-ncp-apigw-signature-v2	Signature used to encrypt the body with the “secret key” that maps with the “access key.” The HMAC encryption algorithm is HMAC SHA256.

Request parameters

Parameter	Required	Type	Limitations	Description
loadBalancerInstanceNo	Y	String		Load balancer instance number to change binding settings for
serverInstanceNoList.N	Y	String	Duplicates not allowed.	List of server instance numbers to bind to the load balancer. Example) serverInstanceNoList.1=123&serverInstanceNoList.2=124

Response

Response body

LoadBalancerInstance

Examples

Request example

GET {LOADBALANCER_API_URL}/loadbalancer/v2/changeLoadBalancedServerInstances?serverInstanceNoList.1=1083616&loadBalancerInstanceNo=1083198

Response example

<changeLoadBalancedServerInstancesResponse>
  <requestId>635e0665-d097-492c-904e-c7394d2913a1</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <loadBalancerInstanceList>
    <loadBalancerInstance>
      <loadBalancerInstanceNo>1083198</loadBalancerInstanceNo>
      <virtualIp>49.236.150.49,49.236.151.137</virtualIp>
      <loadBalancerName>loadb1674dfbe5f4</loadBalancerName>
      <loadBalancerAlgorithmType>
        <code>RR</code>
        <codeName>Round Robin</codeName>
      </loadBalancerAlgorithmType>
      <loadBalancerDescription></loadBalancerDescription>
      <createDate>2018-11-26T12:06:53+0900</createDate>
      <domainName>slb-1083198.ncloudslb.com</domainName>
      <loadBalancerInstanceStatusName>changing</loadBalancerInstanceStatusName>
      <loadBalancerInstanceStatus>
        <code>USED</code>
        <codeName>NET USED state</codeName>
      </loadBalancerInstanceStatus>
      <loadBalancerInstanceOperation>
        <code>CHANG</code>
        <codeName>NET CHANGE OP</codeName>
      </loadBalancerInstanceOperation>
      <networkUsageType>
        <code>PBLIP</code>
        <codeName>Public</codeName>
      </networkUsageType>
      <isHttpKeepAlive>false</isHttpKeepAlive>
      <connectionTimeout>60</connectionTimeout>
      <certificateName></certificateName>
      <loadBalancerRuleList>
        <loadBalancerRule>
          <protocolType>
            <code>HTTP</code>
            <codeName>http</codeName>
          </protocolType>
          <loadBalancerPort>80</loadBalancerPort>
          <serverPort>80</serverPort>
          <l7HealthCheckPath>/l7check.html</l7HealthCheckPath>
          <certificateName></certificateName>
          <proxyProtocolUseYn>N</proxyProtocolUseYn>
          <stickySessionUseYn>N</stickySessionUseYn>
          <http2UseYn>N</http2UseYn>
        </loadBalancerRule>
      </loadBalancerRuleList>
      <loadBalancedServerInstanceList>
        <loadBalancedServerInstance>
          <serverInstance>
            <serverInstanceNo>1083616</serverInstanceNo>
            <serverName>s1674e938b61</serverName>
            <serverDescription></serverDescription>
            <cpuCount>2</cpuCount>
            <memorySize>4294967296</memorySize>
            <baseBlockStorageSize>53687091200</baseBlockStorageSize>
            <platformType>
              <code>LNX64</code>
              <codeName>Linux 64 Bit</codeName>
            </platformType>
            <loginKeyName>penguinit</loginKeyName>
            <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
            <publicIp></publicIp>
            <privateIp>10.41.84.42</privateIp>
            <serverImageName>centos-7.3-64</serverImageName>
            <serverInstanceStatus>
              <code>RUN</code>
              <codeName>Server run state</codeName>
            </serverInstanceStatus>
            <serverInstanceOperation>
              <code>NULL</code>
              <codeName>Server NULL OP</codeName>
            </serverInstanceOperation>
            <serverInstanceStatusName>running</serverInstanceStatusName>
            <createDate>2018-11-26T14:52:32+0900</createDate>
            <uptime>2018-11-26T14:55:29+0900</uptime>
            <serverImageProductCode>SPSW0LINUX000046</serverImageProductCode>
            <serverProductCode>SPSVRSSD00000003</serverProductCode>
            <isProtectServerTermination>false</isProtectServerTermination>
            <portForwardingPublicIp>106.10.32.172</portForwardingPublicIp>
            <zone>
              <zoneNo>3</zoneNo>
              <zoneName>KR-2</zoneName>
              <zoneCode>KR-2</zoneCode>
              <zoneDescription>Pyeongchon zone</zoneDescription>
              <regionNo>1</regionNo>
            </zone>
            <region>
              <regionNo>1</regionNo>
              <regionCode>KR</regionCode>
              <regionName>Korea</regionName>
            </region>
            <baseBlockStorageDiskType>
              <code>NET</code>
              <codeName>Network Storage</codeName>
            </baseBlockStorageDiskType>
            <baseBlockStorageDiskDetailType>
              <code>SSD</code>
              <codeName>SSD</codeName>
            </baseBlockStorageDiskDetailType>
            <serverInstanceType>
              <code>STAND</code>
              <codeName>Standard</codeName>
            </serverInstanceType>
            <userData></userData>
            <accessControlGroupList>
              <accessControlGroup>
                <accessControlGroupConfigurationNo>8813</accessControlGroupConfigurationNo>
                <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                <isDefault>true</isDefault>
                <createDate>2017-04-29T21:34:31+0900</createDate>
              </accessControlGroup>
            </accessControlGroupList>
            <instanceTagList/>
          </serverInstance>
          <serverHealthCheckStatusList>
            <serverHealthCheckStatus>
              <protocolType>
                <code>HTTP</code>
                <codeName>http</codeName>
              </protocolType>
              <loadBalancerPort>80</loadBalancerPort>
              <serverPort>80</serverPort>
              <l7HealthCheckPath>/l7check.html</l7HealthCheckPath>
              <proxyProtocolUseYn>N</proxyProtocolUseYn>
              <serverStatus>false</serverStatus>
            </serverHealthCheckStatus>
          </serverHealthCheckStatusList>
        </loadBalancedServerInstance>
      </loadBalancedServerInstanceList>
    </loadBalancerInstance>
  </loadBalancerInstanceList>
</changeLoadBalancedServerInstancesResponse>

Error codes

Errors that may occur while using this action are listed below. For information on common errors, refer to NAVER Cloud Platform.

HTTP response code	Return code	Return message
400	24091	No IP address is assigned to the server instance (no. {0}).
400	24109	The input parameter instance number is invalid
400	24120	The input parameter server instance number is invalid.
400	24123	The input parameter load balancer instance number is invalid.
400	25027	You may not change since (other) user is operating the target load balancer.
400	25050	(Other)Unable to operate load balancer since use is manipulating the applying

Was this article helpful?

What's Next

deleteLoadBalancerInstances

Table of contents

Overview
Request
Response
Examples
Error codes