Classic 환경에서 이용 가능합니다.
로드 밸런서 인스턴스를 생성합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| GET | /loadbalancer/v2/createLoadBalancerInstance |
요청 헤더
Load Balancer API에서 공통으로 사용하는 헤더에 대한 정보는 Load Balancer 요청 헤더를 참조해 주십시오.
요청 쿼리 파라미터
요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
loadBalancerName |
String | Optional | 생성하려는 로드 밸런서의 이름
|
loadBalancerAlgorithmTypeCode |
String | Optional | 로드 밸런싱에 사용할 알고리즘 유형
|
loadBalancerDescription |
String | Optional | 로드 밸런서에 대한 설명(Byte)
|
networkUsageTypeCode |
String | Optional | 로드 밸런서의 네크워크 유형
|
serverInstanceNoList.N |
String | Optional | 로드 밸런서에 바인드할 서버 인스턴스의 번호 목록 |
loadBalancerRuleList.N.protocolTypeCode |
String | Required | 로드 밸런서 규칙의 프로토콜 유형
|
loadBalancerRuleList.N.loadBalancerPort |
Integer | Required | 로드 밸런서 규칙의 포트
|
loadBalancerRuleList.N.serverPort |
Integer | Required | 로드 밸런서 규칙의 서버 포트
|
loadBalancerRuleList.N.l7HealthCheckPath |
String | Conditional | 로드 밸런서 규칙의 헬스 체크 경로
|
loadBalancerRuleList.N.certificateName |
String | Conditional | 로드 밸런서의 SSL 공인 인증서 이름loadBalancerRuleList.N.protocloTypeCode가 SSL 또는 HTTPS이면 입력 필수 |
loadBalancerRuleList.N.proxyProtocolUseYn |
String | Optional | 프록시 프로토콜 사용 여부
|
loadBalancerRuleList.N.stickySessionUseYn |
String | Optional | 세션별 접근 사용 여부
|
loadBalancerRuleList.N.http2UseYn |
String | Optional | HTTP/2 프로토콜 사용 여부
|
loadBalancerRuleList.N.serverProtocolTypeCode |
String | Optional | 서버의 프로토콜 유형
|
regionNo |
String | Optional | 로드 밸런스를 생성하려는 리전의 번호 |
zoneNoList |
List[String] | Optional | 로드 밸런스를 생성하려는 존 번호 목록
|
요청 예시
요청 예시는 다음과 같습니다.
curl --location 'https://ncloud.apigw.gov-ntruss.com/loadbalancer/v2/createLoadBalancerInstance?loadBalancerRuleList.1.l7HealthCheckPath=/&loadBalancerRuleList.1.loadBalancerPort=80&loadBalancerRuleList.1.protocolTypeCode=HTTP&loadBalancerRuleList.1.serverPort=80' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
응답
응답 형식을 설명합니다.
응답 바디
응답 바디는 LoadBalancerInstance를 참조해 주십시오.
응답 상태 코드
Load Balancer API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Load Balancer 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
<createLoadBalancerInstanceResponse>
<requestId>1e3eac26-c57e-4c8b-b6b0-ba3fe2330a61</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-07T19:28:24+0900</createDate>
<domainName>slb-24784632.ncloudslb.com</domainName>
<loadBalancerInstanceStatusName>creating</loadBalancerInstanceStatusName>
<loadBalancerInstanceStatus>
<code>INIT</code>
<codeName>NET INIT state</codeName>
</loadBalancerInstanceStatus>
<loadBalancerInstanceOperation>
<code>USE</code>
<codeName>NET USE 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>
</zoneList>
<loadBalancerRuleList>
<loadBalancerRule>
<protocolType>
<code>HTTP</code>
<codeName>http</codeName>
</protocolType>
<loadBalancerPort>80</loadBalancerPort>
<serverPort>80</serverPort>
<l7HealthCheckPath>/</l7HealthCheckPath>
<certificateName></certificateName>
<proxyProtocolUseYn>N</proxyProtocolUseYn>
<stickySessionUseYn>N</stickySessionUseYn>
<http2UseYn>N</http2UseYn>
</loadBalancerRule>
</loadBalancerRuleList>
<loadBalancedServerInstanceList/>
</loadBalancerInstance>
</loadBalancerInstanceList>
</createLoadBalancerInstanceResponse>