changeLoadBalancedServerInstances

Prev Next

개요

로드밸런서에 바인드된 서버 인스턴스를 변경합니다. 기존에 바인드된 정보는 초기화되고 새로롭게 바인드됩니다.

요청

요청 헤더

헤더 명 설명
x-ncp-apigw-timestamp 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것
API Gateway 서버와 시간차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-apigw-api-key API Gateway에서 발급받은 키(v2버전에서는 필요 없음)
x-ncp-iam-access-key 네이버 클라우드 플랫폼[공공기관용]에서 발급받은 API Key 또는 IAM에서 발급받은 AccessKey
x-ncp-apigw-signature-v2 Body를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명
HMAC 암호화 알고리즘은 HmacSHA256 사용

요청 파라미터

파라미터 명 필수 여부 타입 제약사항 설명
loadBalancerInstanceNo Yes String - 바인드된 설정을 변경할 로드밸런서인스턴스 번호
특정 로드밸런서 인스턴스에 바인드 되어있는 서버 인스턴스 리스트 확인 가능
getLoadBalacerInstanceList 액션을 통해 인스턴스 번호 확인 가능
serverInstanceNoList.N Yes String 중복 불가 - 로드밸런서에 바인드할 서버인스턴스 번호리스트
<예시> serverInstanceNoList.1=123&serverInstanceNoList.2=124

응답

응답 바디

예시

요청 예시

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

응답 예시

<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>평촌 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>

에러 코드

아래 에러 코드는 이 액션(Action)에서 특징적으로 발생하는 에러입니다. 공통적으로 발생하는 에러에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해 주십시오.

HTTP Response Code 리턴 코드 리턴 메시지
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