createLoadBalancerInstance
- 인쇄
- PDF
createLoadBalancerInstance
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Classic 환경에서 이용 가능합니다.
로드 밸런서 인스턴스를 생성합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
메서드 | URI |
---|---|
GET | /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.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를 참조해 주십시오.
응답 상태 코드
네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Ncloud API 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
<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>
응답 상태 코드
응답 상태 코드에 대한 설명은 다음과 같습니다.
HTTP 상태 코드 | 코드 | 메시지 | 설명 |
---|---|---|---|
400 | 10300 | Instance name is already in use. please use other name. | 인스턴스 이름 중복 불가 |
400 | 10105 | Unable to create load balancer anymore since contract limitation setting has been exceeded. Number of contract limitation: {0} Number of current contracts : {1} | 서비스 이용 한도 초과 |
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 | 23017 | This version of the load balancer can not create with private IP. | 사설 IP 주소로는 생성할 수 없는 로드 밸런서 |
400 | 23018 | Can not create the load balancer. | 로드 밸런서 생성 오류 |
400 | 23019 | There is no resource for the load balancer. | 로드 밸런서에 리소스가 없음 |
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 | 24091 | No IP address is assigned to the server instance (no. {0}). | 서버 인스턴스에 할당된 IP 주소가 없음 |
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 | 24120 | The input parameter server 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 | 24173 | Only one zone can be selected for private IP load balancer. | 사설 IP 주소를 사용하는 로드 밸런서는 존을 1개만 입력 가능 |
400 | 24300 | The length constraints of the parameter description (memo) were violated. The minimum length is 0 byte, the maximum, 1,000 bytes. | 설명은 1~1,000 바이트 사이어야 함 |
400 | 25050 | (Other)Unable to operate load balancer since use is manipulating the applying server. | 로드 밸런서에 서버를 적용 중이라 사용 불가 |
400 | 25051 | Server is already being applied to load balancer. | 로드 밸런서에서 이미 적용 중인 서버 |
400 | 25052 | Server {0} is unable to apply to load balancer since it is either in operation or not being suspended. | 서버가 운영 중이거나 중지되지 않아 로드 밸런서에 적용 불가 |
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 | 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이어야만 프록시 프로토콜 설정 가능 |
이 문서가 도움이 되었습니까?