Classic 환경에서 이용 가능합니다.
개요
네이버 클라우드 플랫폼은 네이버의 최신 컴퓨팅 기술과 운영 노하우가 축적된 클라우드 서비스입니다.
네이버 클라우드 플랫폼에서 제공하는 서비스와 솔루션을 활용할 수 있도록 지원하는 응용 프로그램 인터페이스(API)를 네이버 클라우드 플랫폼 API라고 합니다.
Load Balancer 공통 설정
Load Balancer API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.
요청
공통 요청 형식을 설명합니다.
API URL
요청 API URL은 다음과 같습니다.
https://ncloud.apigw.gov-ntruss.com
요청 헤더
헤더에 대한 설명은 다음과 같습니다.
| 필드 | 필수 여부 | 설명 |
|---|---|---|
x-ncp-apigw-timestamp |
Required | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
|
x-ncp-iam-access-key |
Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key |
x-ncp-apigw-signature-v2 |
Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명 |
Content-type |
Optional | 요청 데이터의 형식
|
응답
공통 응답 형식을 설명합니다.
응답 상태 코드
응답 상태 코드에 대한 설명은 다음과 같습니다.
| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
|---|---|---|---|
| 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 | 10300 | Instance name is already in use. please use other name. | 인스턴스 이름 중복 불가 |
| 400 | 10713 | Not found contract information. Please check your input parameter. | 서비스 이용 정보를 찾을 수 없음 |
| 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 | 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 | 24173 | Only one zone can be selected for private IP load balancer. | 사설 IP 주소를 사용하는 로드 밸런서는 존을 1개만 입력 가능 |
| 400 | 24174 | Can not change zone for private IP load balancer. | 사설 IP 주소를 사용하는 로드 밸런서는 존 변경 불가 |
| 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 | 25026 | You may not delete since (other) user is operating the target load balance. | 다른 사용자가 대상 로드 밸런서를 운영 중이라 삭제 불가 |
| 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 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 | 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 | 26041 | The certificate name already existent. | 인증서 이름 중복 불가 |
| 400 | 26042 | Proxy protocol can be set only with TCP, SSL protocols. | 로드 밸런서 규칙의 프로토콜 유형이 TCP 또는 SSL이어야만 프록시 프로토콜 설정 가능 |
참고
네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.
오퍼레이션
| API명 | 설명 |
|---|---|
| createLoadBalancerInstance | 로드 밸런서 인스턴스 생성 |
| changeLoadBalancerInstanceConfiguration | 로드 밸런서 인스턴스 설정 변경 |
| changeLoadBalancedServerInstances | 로드 밸런서에 바인드된 서버 인스턴스 변경 |
| deleteLoadBalancerInstances | 로드 밸런서 인스턴스 삭제 |
| getLoadBalancerInstanceList | 로드 밸런서 인스턴스 목록 조회 |
| getLoadBalancedServerInstanceList | 로드 밸런서에 바인드된 서버 인스턴스 목록 조회 |
| getLoadBalancerTargetServerInstanceList | 로드 밸런서에 할당할 수 있는 서버 인스턴스 목록 조회 |
| addLoadBalancerSslCertificate | 로드 밸런서에서 사용하는 SSL 인증서 추가 |
| deleteLoadBalancerSslCertificate | 로드 밸런서에서 사용하는 SSL 인증서 삭제 |
| getLoadBalancerSslCertificateList | 로드 밸런서에서 사용하는 SSL 인증서 조회 |