changeLoadBalancerInstanceConfiguration

Prev Next

Classic 환경에서 이용 가능합니다.

로드 밸런서 인스턴스 규칙의 설정 값을 변경합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
GET /changeLoadBalancerInstanceConfiguration

요청 헤더

Load Balancer API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 Load Balancer 공통 헤더를 참조해 주십시오.

요청 쿼리 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
loadBalancerInstanceNo String Required 설정을 변경하려는 로드 밸런서 인스턴스의 번호
loadBalancerAlgorithmTypeCode String Required 로드 밸런싱에 사용할 알고리즘 유형
  • RR | LC
    • RR: Round Robin
    • LC: Least Connection
loadBalancerDescription String Optional 로드 밸런서에 대한 설명(Byte)
  • 0~1,000
loadBalancerRuleList.N.protocolTypeCode String Required 로드 밸런서 규칙의 프로토콜 유형
  • HTTP | HTTPS | TCP
loadBalancerRuleList.N.loadBalancerPort Integer Required 로드 밸런서 규칙의 포트
  • 1~65534
  • 동일한 로드 밸런서에서 포트 중복 불가
  • 22, 3389, 64000, 65130, 65131, 18080~18095 포트는 로드 밸런서 관리용으로 사용 불가
loadBalancerRuleList.N.serverPort Integer Required 로드 밸런서 규칙의 서버 포트
  • 1~65534
  • 동일한 로드 밸런서에서 포트 중복 가능
loadBalancerRuleList.N.l7HealthCheckPath String Conditional 로드 밸런서 규칙의 헬스 체크 경로
  • / (기본값)
  • /로 시작하는 URL 경로
  • loadBalancerRuleList.N.protocolTypeCodeHTTP 또는 HTTPS이면 입력 필수
loadBalancerRuleList.N.certificateName String Conditional 로드 밸런서의 SSL 공인 인증서 이름
  • loadBalancerRuleList.N.protocloTypeCodeSSL 또는 HTTPS이면 입력 필수
loadBalancerRuleList.N.proxyProtocolUseYn String Optional 프록시 프로토콜 사용 여부
  • Y | N
    • Y: 설정
    • N: 해제
  • loadBalancerRuleList.N.protocloTypeCodeTCP 또는 SSL이면 설정 가능
loadBalancerRuleList.N.stickySessionUseYn String Optional 세션별 접근 사용 여부
  • Y | N
    • Y: 설정
    • N: 해제
  • loadBalancerRuleList.N.protocloTypeCodeHTTP 또는 HTTPS이면 설정 가능
loadBalancerRuleList.N.http2UseYn String Optional HTTP/2 프로토콜 사용 여부
  • Y | N
    • Y: 설정
    • N: 해제
  • loadBalancerRuleList.N.protocloTypeCodeHTTPS이면 설정 가능
loadBalancerRuleList.N.serverProtocolTypeCode String Optional 서버의 프로토콜 유형
  • HTTP (기본값) | HTTPS
  • loadBalancerRuleList.N.protocloTypeCode HTTPS이면 설정 가능
zoneNoList List<String> Optional 로드 밸런스의 존을 변경하려는 존 번호 목록
  • zoneNogetRegionList를 통해 확인
  • 존을 변경하면 로드 밸런서 IP가 변경됨
  • 사설 IP 로드 밸런서는 존을 변경할 수 없으며 멀티존 지원 예정

요청 예시

요청 예시는 다음과 같습니다.

curl --location 'https://ncloud.apigw.gov-ntruss.com/loadbalancer/v2/changeLoadBalancerInstanceConfiguration
?loadBalancerInstanceNo=*******
&loadBalancerAlgorithmTypeCode=RR
&loadBalancerRuleList.1.l7HealthCheckPath=/
&loadBalancerRuleList.1.loadBalancerPort=88
&loadBalancerRuleList.1.serverPort=88
&loadBalancerRuleList.1.protocolTypeCode=HTTP'
--header 'x-ncp-apigw-timestamp: {Timestamp}'
--header 'x-ncp-iam-access-key: {Access Key}'
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디는 LoadBalancerInstance를 참조해 주십시오.

응답 상태 코드

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Ncloud API 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

<changeLoadBalancerInstanceConfigurationResponse>
    <requestId>cdb87e60-2bf1-4438-8d55-470c9f17521c</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <loadBalancerInstanceList>
        <loadBalancerInstance>
            <loadBalancerInstanceNo>********</loadBalancerInstanceNo>
            <virtualIp>***.**.***.**,**.**.***.***</virtualIp>
            <loadBalancerName>YOUR_LOAD_BALANCER</loadBalancerName>
            <loadBalancerAlgorithmType>
                <code>RR</code>
                <codeName>Round Robin</codeName>
            </loadBalancerAlgorithmType>
            <loadBalancerDescription></loadBalancerDescription>
            <createDate>2024-06-07T18:46:01+0900</createDate>
            <domainName>***.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>
            <region>
                <regionNo>1</regionNo>
                <regionCode>KR</regionCode>
                <regionName>Korea</regionName>
            </region>
            <zoneList>
                <zone>
                    <zoneNo>2</zoneNo>
                    <zoneName>KR-1</zoneName>
                    <zoneCode>KR-1</zoneCode>
                    <zoneDescription>가산 zone</zoneDescription>
                    <regionNo>1</regionNo>
                </zone>
                <zone>
                    <zoneNo>3</zoneNo>
                    <zoneName>KR-2</zoneName>
                    <zoneCode>KR-2</zoneCode>
                    <zoneDescription>평촌 zone</zoneDescription>
                    <regionNo>1</regionNo>
                </zone>
            </zoneList>
            <loadBalancerRuleList>
                <loadBalancerRule>
                    <protocolType>
                        <code>HTTP</code>
                        <codeName>http</codeName>
                    </protocolType>
                    <loadBalancerPort>88</loadBalancerPort>
                    <serverPort>88</serverPort>
                    <l7HealthCheckPath>/</l7HealthCheckPath>
                    <certificateName></certificateName>
                    <proxyProtocolUseYn>N</proxyProtocolUseYn>
                    <stickySessionUseYn>N</stickySessionUseYn>
                    <http2UseYn>N</http2UseYn>
                </loadBalancerRule>
            </loadBalancerRuleList>
            <loadBalancedServerInstanceList>
                <loadBalancedServerInstance>
                    <serverInstance>
                        <serverInstanceNo>********</serverInstanceNo>
                        <serverName>YOUR_SERVER</serverName>
                        <serverDescription></serverDescription>
                        <cpuCount>2</cpuCount>
                        <memorySize>4294967296</memorySize>
                        <baseBlockStorageSize>53687091200</baseBlockStorageSize>
                        <platformType>
                            <code>UBS64</code>
                            <codeName>Ubuntu Server 64 Bit</codeName>
                        </platformType>
                        <loginKeyName>YOUR_LOGIN_KEY</loginKeyName>
                        <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
                        <publicIp></publicIp>
                        <privateIp>**.**.***.***</privateIp>
                        <serverImageName>ubuntu-18.04</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>2024-06-07T18:28:41+0900</createDate>
                        <uptime>2024-06-07T18:35:09+0900</uptime>
                        <serverImageProductCode>SPSW0LINUX000130</serverImageProductCode>
                        <serverProductCode>SPSVRSSD00000003</serverProductCode>
                        <isProtectServerTermination>false</isProtectServerTermination>
                        <portForwardingPublicIp>***.***.***.***</portForwardingPublicIp>
                        <zone>
                            <zoneNo>2</zoneNo>
                            <zoneName>KR-1</zoneName>
                            <zoneCode>KR-1</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>
                        <initScriptNo></initScriptNo>
                        <accessControlGroupList>
                            <accessControlGroup>
                                <accessControlGroupConfigurationNo>******</accessControlGroupConfigurationNo>
                                <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                                <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                                <isDefault>true</isDefault>
                                <createDate>2021-06-22T18:09:57+0900</createDate>
                            </accessControlGroup>
                        </accessControlGroupList>
                        <instanceTagList/>
                    </serverInstance>
                    <serverHealthCheckStatusList>
                        <serverHealthCheckStatus>
                            <protocolType>
                                <code>HTTP</code>
                                <codeName>http</codeName>
                            </protocolType>
                            <loadBalancerPort>88</loadBalancerPort>
                            <serverPort>88</serverPort>
                            <l7HealthCheckPath>/</l7HealthCheckPath>
                            <proxyProtocolUseYn>N</proxyProtocolUseYn>
                            <serverStatus>false</serverStatus>
                        </serverHealthCheckStatus>
                    </serverHealthCheckStatusList>
                </loadBalancedServerInstance>
            </loadBalancedServerInstanceList>
        </loadBalancerInstance>
    </loadBalancerInstanceList>
</changeLoadBalancerInstanceConfigurationResponse>

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
400 23011 We are sorry that {0} cannot be used for load balancer ports since the ports are in use for load balancer management. 로드 밸런서 관리용으로 이미 사용 중인 포트
400 24063 The number of load balancer settings has been exceeded. 로드 밸런서 설정 한도 초과
400 24064 The range of usable {0} port is from 1 to 66534. 포트 번호는 1~66534 사이어야 함
400 24065 {0} Duplicated port number. Port number : {1} 포트 번호 중복 불가
400 24066 When setting load balancer, Health Check route must be configured to HTTP protocol. 로드 밸런서 규칙의 프로토콜 유형이 HTTP이면 헬스 체크 경로 입력 필수
400 24099 When setting load balancer, Health Check route must be configured to HTTP or HTTPS protocol. 로드 밸런서 규칙의 프로토콜 유형이 HTTP 또는 HTTPS이면 헬스 체크 경로 입력 필수
400 24109 The input parameter instance number is invalid. 인스턴스 번호가 유효하지 않음
400 24111 The input parameter zone number is invalid. 존 번호가 유효하지 않음
400 24123 The input parameter load balancer instance number is invalid. 로드 밸런서 인스턴스 번호가 유효하지 않음
400 24130 The input parameter load balancing algorithm is invalid. 로드 밸런싱 알고리즘이 유효하지 않음
400 24131 The field {0} in the load balancer rule parameter is invalid. 로드 밸런서 규칙의 {0} 필드가 유효하지 않음
400 24132 The field healthCheckPath in the load balancer rule parameter is invalid. If the protocol is HTTP, it is required. it must start with slash('/') and contain no blank. 로드 밸런서 규칙의 프로토콜 유형이 HTTP이면 헬스 체크 경로 입력 필수. URL 경로는 '/'로 시작해야 하며 공백이 없어야 함
400 24133 The field healthCheckPath in the load balancer rule parameter is invalid. If the protocol is NOT HTTP, it must not be specified. 로드 밸런서 규칙의 프로토콜 유형이 HTTP가 아니면 헬스 체크 경로 지정 불가
400 24134 The number of input parameter load balancer rules is the minimum of 1, maximum of 5. 글자 길이 제한: 1~5
400 24174 Can not change zone for private IP load balancer. 사설 IP 주소를 사용하는 로드 밸런서는 존 변경 불가
400 25027 You may not change since (other) user is operating the target load balance. 다른 사용자가 대상 로드 밸런서를 운영 중이라 변경 불가
400 25050 (Other)Unable to operate load balancer since use is manipulating the applying server. 로드 밸런서에 서버를 적용 중이라 사용 불가
400 26002 The issuer certificate of a looked up certificate could not be found. This normally means the list of trusted certificates is not complete. 인증서 발행자를 찾을 수 없음
400 26003 The CRL of a certificate could not be found. CRL을 찾을 수 없음
400 26004 The certificate signature could not be decrypted. This means that the actual signature value could not be determined rather than it not matching the expected value, this is only meaningful for RSA keys. 인증서 서명 복호화 실패
400 26005 The CRL signature could not be decrypted: this means that the actual signature value could not be determined rather than it not matching the expected value. Unused. CRL 서명 복호화 실패
400 26006 The public key in the certificate SubjectPublicKeyInfo could not be read. 인증서 공개키를 읽을 수 없음
400 26007 The signature of the certificate is invalid. 인증서 서명이 유효하지 않음
400 26008 The signature of the certificate is invalid. 인증서 서명이 유효하지 않음
400 26009 The certificate is not yet valid: the notBefore date is after the current time. 인증서 유효 시작일이 현재 날짜 이후로 설정되어 있음
400 26010 The certificate has expired: that is the notAfter date is before the current time. 인증서 유효 만료일이 현재 날짜 이전으로 설정되어 있음
400 26011 The CRL is not yet valid. CRL이 유효하지 않음
400 26012 The CRL has expired. CRL이 만료됨
400 26013 The certificate notBefore field contains an invalid time. 인증서 유효 시작 일시가 유효하지 않음
400 26014 The certificate notAfter field contains an invalid time. 인증서 유효 만료 일시가 유효하지 않음
400 26015 The CRL lastUpdate field contains an invalid time. CRL의 최종 업데이트 일시가 유효하지 않음
400 26016 The CRL nextUpdate field contains an invalid time. CRL의 다음 업데이트 일시가 유효하지 않음
400 26017 An error occurred trying to allocate memory. This should never happen. 메모리 할당 오류
400 26018 The passed certificate is self signed and the same certificate cannot be found in the list of trusted certificates. 자체 서명된 인증서로 신뢰할 수 있는 인증서 목록에서 찾을 수 없음
400 26019 The certificate chain could be built up using the untrusted certificates but the root could not be found locally. 로컬 컴퓨터에서 루트 인증서를 찾을 수 없음
400 26020 The issuer certificate could not be found: this occurs if the issuer certificate of an untrusted certificate cannot be found. 인증서 발행자를 찾을 수 없음
400 26021 No signatures could be verified because the chain contains only one certificate and it is not self signed. 서명 인증 실패
400 26022 The certificate chain length is greater than the supplied maximum depth. Unused. 인증서 체인 길이 제한 초과
400 26023 The certificate has been revoked. 인증서가 해지됨
400 26024 A CA certificate is invalid. Either it is not a CA or its extensions are not consistent with the supplied purpose. CA 인증서가 유효하지 않음
400 26025 The basicConstraints path length parameter has been exceeded. 인증 경로 길이 제한 초과
400 26026 The supplied certificate cannot be used for the specified purpose. 인증서를 해당 용도로 사용할 수 없음
400 26027 The root CA is not marked as trusted for the specified purpose. 루트 CA 인증서를 신뢰할 수 없음
400 26028 The root CA is marked to reject the specified purpose. 루트 CA 인증서 요청이 거부됨
400 26029 The current candidate issuer certificate was rejected because its subject name did not match the issuer name of the current certificate. Only displayed when the -issuer_checks option is set. 주체자가 발행자와 일치하지 않아 인증서 요청이 거부됨
400 26030 The current candidate issuer certificate was rejected because its subject key identifier was present and did not match the authority key identifier current certificate. Only displayed when the -issuer_checks option is set. 주체 키 식별자가 권한 키 식별자와 일치하지 않아 인증서 요청이 거부됨
400 26031 The current candidate issuer certificate was rejected because its issuer name and serial number was present and did not match the authority key identifier of the current certificate. Only displayed when the -issuer_checks option is set. 인증서 발행자와 시리얼 번호가 권한 키 식별자와 일치하지 않아 인증서 요청이 거부됨
400 26032 The current candidate issuer certificate was rejected because its keyUsage extension does not permit certificate signing. 키 용도 확장이 서명을 허용하지 않아 인증서 요청이 거부됨
400 26033 An application specific error. Unused. 애플리케이션 오류
400 26034 An error occurred during certificate verification. 인증서 인증 오류
400 26035 Not found memberNo OR certificateName. Please check your input parameter. 회원 번호 또는 인증서 이름을 찾을 수 없음
400 26036 Not found memberNo OR certificateName OR privateKey OR publicKeyCertificate. Please check your input parameter. 회원 번호, 인증서 이름, 비밀키, 또는 공개키를 찾을 수 없음
400 26037 Certificate is being used in another loadBalancer. 다른 로드 밸런서에서 이미 사용 중인 인증서
400 26038 The certificate name required for SSL/HTTPS. Please check your input parameter. 로드 밸런서 규칙의 프로토콜 유형이 SSL 또는 HTTPS이면 인증서 이름 입력 필수
400 26042 Proxy protocol can be set only with TCP, SSL protocols. 로드 밸런서 규칙의 프로토콜 유형이 TCP 또는 SSL이어야만 프록시 프로토콜 설정 가능