Classic 환경에서 이용 가능합니다.
개요
로드밸런서 인스턴스 설정 변경
설명
로드밸런서 인스턴스의 설정값을 변경합니다.
요청 파라미터
| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
|---|---|---|---|---|
| loadBalancerInstanceNo | Yes | String | - 설정을 변경할 로드밸런서 인스턴스 번호 getLoadBalacerInstanceList 액션을 통해 인스턴스번호를 알 수 있음 |
|
| loadBalancerAlgorithmTypeCode | Yes | String | Min : 1,Max : 5 | - 로드밸런서 알고리즘 구분 코드 입력 가능한 알고리즘: ROUND ROBIN (RR), LEAST_CONNECTION (LC) |
| loadBalancerDescription | No | String | Min : 1,Max : 1000 | 수정할 로드밸런서 설명 |
| loadBalancerRuleList.protocolTypeCode | Yes | String | Min : 1,Max : 5 | - 로드밸런서 RULE의 프로토콜 구분 코드 아래의 코드 입력 가능: HTTP | TCP |
| loadBalancerRuleList.loadBalancerPort | Yes | Integer | Min : 1,Max : 65534 | 로드밸런서 RULE의 로드밸런서 포트 |
| loadBalancerRuleList.serverPort | Yes | Integer | Min : 1,Max : 65534 | 로드밸런서 RULE의 서버 포트 |
| loadBalancerRuleList.l7HealthCheckPath | Conditional | String | Min : 1,Max : 600 | - 로드밸런서 RULE의 헬스 체크 경로 loadBalancerRuleList.N.protocolTypeCode 값이 HTTP인 경우에는 필수 항목 |
| loadBalancerRuleList.certificateName | Conditional | String | Min : 1,Max : 300 | 로드밸런서 생성시 로드밸런서 RULE을 입력해야 함 로드밸런서 SSL 공인인증서 loadBalancerRuleList.protocloTypeCode 값이 SSL/HTTPS인 경우에는 필수 항목 |
| loadBalancerRuleList.proxyProtocolUseYn | Conditional | String | Min : 1,Max : 300 | 로드밸런서 RULE 리스트.프록시 프로토콜 사용 여부 |
| loadBalancerRuleList.N.stickySessionUseYn | No | String | - 세션별 접근 사용 여부 loadBalancerRuleList.N.protocloTypeCode 값이 HTTP HTTPS 인 경우에만 설정 가능Options : Y(설정) | N(해제) |
|
| loadBalancerRuleList.N.http2UseYn | No | String | - HTTP/2 프로토콜 사용 여부 loadBalancerRuleList.N.protocloTypeCode 값이 HTTPS 인 경우에만 설정 가능Options : Y(설정) | N(해제) |
|
| loadBalancerRuleList.N.serverProtocolTypeCode | No | String | - 서버 프로토콜 구분 코드 loadBalancerRuleList.N.protocloTypeCode 값이 HTTPS 인 경우에만 설정 가능Options : HTTP HTTPSDefault : HTTP |
응답 데이터 타입
- LoadBalancerInstanceList 타입
| LoadBalancerInstanceList extends CommonResponse |
|---|
| private Integer totalRows; |
| private List<LoadBalancerInstance> loadBalancerInstanceList = new ArrayList<LoadBalancerInstance>(); |
| LoadBalancerInstance |
|---|
| private String loadBalancerInstanceNo; |
| private String virtualIp; |
| private String loadBalancerName; |
| private CommonCode loadBalancerAlgorithmType; |
| private String loadBalancerDescription; |
| private Date createDate; |
| private String domainName; |
| private String loadBalancerInstanceStatusName; |
| private CommonCode loadBalancerInstanceStatus; |
| private CommonCode loadBalancerInstanceOperation; |
| private CommonCode networkUsageType; |
| private Boolean isHttpKeepAlive; |
| private Integer connectionTimeout; |
| private String certificateName; |
| private List |
| private List |
예시
호출
ncloud loadbalancer changeLoadBalancerInstanceConfiguration --loadBalancerInstanceNo 465475 --loadBalancerAlgorithmTypeCode RR --loadBalancerRuleList protocolTypeCode=HTTP,loadBalancerPort=80,serverPort=1024,l7HealthCheckPath=/l7check.html,proxyProtocolUseYn=N
응답
{
"changeLoadBalancerInstanceConfigurationResponse": {
"requestId": "962fa0f6-b7b3-4d33-8567-862f33c87771",
"returnCode": 0,
"returnMessage": "success",
"totalRows": 1,
"loadBalancerInstanceList": [
{
"loadBalancerInstanceNo": 465475,
"virtualIp": "49.236.164.49,49.236.164.68",
"loadBalancerName": "penguinlb",
"loadBalancerAlgorithmType": {
"code": "RR",
"codeName": "Round Robin"
},
"loadBalancerDescription": "",
"createDate": "0518-12-03T12:25:18+0900",
"domainName": "slb-465475.ncloudslb.com",
"loadBalancerInstanceStatusName": "changing",
"loadBalancerInstanceStatus": {
"code": "USED",
"codeName": "NET USED state"
},
"loadBalancerInstanceOperation": {
"code": "CHANG",
"codeName": "NET CHANGE OP"
},
"networkUsageType": {
"code": "PBLIP",
"codeName": "Public"
},
"isHttpKeepAlive": false,
"connectionTimeout": 60,
"certificateName": "",
"loadBalancerRuleList": [
{
"protocolType": {
"code": "HTTP",
"codeName": "http"
},
"loadBalancerPort": 80,
"serverPort": 1024,
"l7HealthCheckPath": "/l7check.html",
"certificateName": "",
"proxyProtocolUseYn": "N",
"stickySessionUseYn": "N",
"http2UseYn": "N"
}
],
"loadBalancedServerInstanceList": [
""
]
}
]
}
}
<?xml version="1.0" encoding="UTF-8" ?>
<changeLoadBalancerInstanceConfigurationResponse>
<requestId>962fa0f6-b7b3-4d33-8567-862f33c87771</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<loadBalancerInstanceList>
<loadBalancerInstanceNo>465475</loadBalancerInstanceNo>
<virtualIp>49.236.164.49,49.236.164.68</virtualIp>
<loadBalancerName>penguinlb</loadBalancerName>
<loadBalancerAlgorithmType>
<code>RR</code>
<codeName>Round Robin</codeName>
</loadBalancerAlgorithmType>
<loadBalancerDescription></loadBalancerDescription>
<createDate>0518-12-03T12:25:18+0900</createDate>
<domainName>slb-465475.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>
<protocolType>
<code>HTTP</code>
<codeName>http</codeName>
</protocolType>
<loadBalancerPort>80</loadBalancerPort>
<serverPort>1024</serverPort>
<l7HealthCheckPath>/l7check.html</l7HealthCheckPath>
<certificateName></certificateName>
<proxyProtocolUseYn>N</proxyProtocolUseYn>
<stickySessionUseYn>N</stickySessionUseYn>
<http2UseYn>N</http2UseYn>
</loadBalancerRuleList>
<loadBalancedServerInstanceList></loadBalancedServerInstanceList>
</loadBalancerInstanceList>
</changeLoadBalancerInstanceConfigurationResponse>