createLoadBalancerInstance
    • PDF

    createLoadBalancerInstance

    • PDF

    기사 요약

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

    로드 밸런서 인스턴스를 생성합니다.

    요청

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

    메서드URI
    GET/createLoadBalancerInstance

    요청 헤더

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

    요청 쿼리 파라미터

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

    필드타입필수 여부설명
    loadBalancerNameStringOptional생성하려는 로드 밸런서의 이름
    • 네이버 클라우드 플랫폼이 자동으로 부여(기본값)
    • 3~30자
    loadBalancerAlgorithmTypeCodeStringOptional로드 밸런싱에 사용할 알고리즘 유형
    • RR (기본값) | SIPHS | LC
      • RR: Round Robin
      • SIPHS: Source IP Hash
      • LC: Least Connection
    loadBalancerDescriptionStringOptional로드 밸런서에 대한 설명(Byte)
    • 0~1,000
    networkUsageTypeCodeStringOptional로드 밸런서의 네크워크 유형
    • PBLIP (기본값) | PRVT
      • PBLIP (Public): 공인 IP
      • PRVT (Private): 사설 IP
    serverInstanceNoList.NStringOptional로드 밸런서에 바인드할 서버 인스턴스의 번호 목록
    loadBalancerRuleList.N.protocolTypeCodeStringRequired로드 밸런서 규칙의 프로토콜 유형
    • HTTP | HTTPS | TCP | SSL
    loadBalancerRuleList.N.loadBalancerPortIntegerRequired로드 밸런서 규칙의 포트
    • 1~65534
    • 동일한 로드 밸런서에서 포트 중복 불가
    • 22, 3389, 64000, 65130, 65131, 18080~18095 포트는 로드 밸런서 관리용으로 사용 불가
    loadBalancerRuleList.N.serverPortIntegerRequired로드 밸런서 규칙의 서버 포트
    • 1~65534
    • 동일한 로드 밸런서에서 포트 중복 가능
    loadBalancerRuleList.N.l7HealthCheckPathStringConditional로드 밸런서 규칙의 헬스 체크 경로
    • / (기본값)
    • /로 시작하는 URL 경로
    • loadBalancerRuleList.N.protocolTypeCodeHTTP 또는 HTTPS이면 입력 필수
    loadBalancerRuleList.N.certificateNameStringConditional로드 밸런서의 SSL 공인 인증서 이름
    loadBalancerRuleList.N.protocloTypeCodeSSL 또는 HTTPS이면 입력 필수
    loadBalancerRuleList.N.proxyProtocolUseYnStringOptional프록시 프로토콜 사용 여부
    • Y | N
      • Y: 설정
      • N: 해제
    • loadBalancerRuleList.N.protocloTypeCodeTCP 또는 SSL이면 설정 가능
    loadBalancerRuleList.N.stickySessionUseYnStringOptional세션별 접근 사용 여부
    • Y | N
      • Y: 설정
      • N: 해제
    • loadBalancerRuleList.N.protocloTypeCodeHTTP 또는 HTTPS이면 설정 가능
    loadBalancerRuleList.N.http2UseYnStringOptionalHTTP/2 프로토콜 사용 여부
    • Y | N
      • Y: 설정
      • N: 해제
    • loadBalancerRuleList.N.protocloTypeCodeHTTPS이면 설정 가능
    loadBalancerRuleList.N.serverProtocolTypeCodeStringOptional서버의 프로토콜 유형
    • HTTP (기본값) | HTTPS
    • loadBalancerRuleList.N.protocloTypeCode HTTPS이면 설정 가능
    regionNoStringOptional로드 밸런스를 생성하려는 리전의 번호
  • getRegionList를 통해 확인
  • 리전과 존을 모두 입력하지 않으면 한국 리전의 존에 임의로 배정
  • zoneNoListList<String>Optional로드 밸런스를 생성하려는 존 번호 목록
    • zoneNogetRegionList를 통해 확인
    • 사설 IP 로드 밸런서는 1개의 존만 선택 가능하며 멀티존 지원 예정

    요청 예시

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

    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 상태 코드코드메시지설명
    40010300Instance name is already in use. please use other name.인스턴스 이름 중복 불가
    40010105Unable to create load balancer anymore since contract limitation setting has been exceeded. Number of contract limitation: {0} Number of current contracts : {1}서비스 이용 한도 초과
    40023011We are sorry that {0} cannot be used for load balancer ports since the ports are in use for load balancer management.로드 밸런서 관리용으로 이미 사용 중인 포트
    40023017This version of the load balancer can not create with private IP.사설 IP 주소로는 생성할 수 없는 로드 밸런서
    40023018Can not create the load balancer.로드 밸런서 생성 오류
    40023019There is no resource for the load balancer.로드 밸런서에 리소스가 없음
    40024063The number of load balancer settings has been exceeded.로드 밸런서 설정 한도 초과
    40024064The range of usable {0} port is from 1 to 66534.포트 번호는 1~66534 사이어야 함
    40024065{0} Duplicated port number. Port number : {1}포트 번호 중복 불가
    40024066When setting load balancer, Health Check route must be configured to HTTP protocol.로드 밸런서 규칙의 프로토콜 유형이 HTTP이면 헬스 체크 경로 입력 필수
    40024091No IP address is assigned to the server instance (no. {0}).서버 인스턴스에 할당된 IP 주소가 없음
    40024099When setting load balancer, Health Check route must be configured to HTTP or HTTPS protocol.로드 밸런서 규칙의 프로토콜 유형이 HTTP 또는 HTTPS이면 헬스 체크 경로 입력 필수
    40024109The input parameter instance number is invalid.인스턴스 번호가 유효하지 않음
    40024111The input parameter zone number is invalid.존 번호가 유효하지 않음
    40024120The input parameter server instance number is invalid.서버 인스턴스 번호가 유효하지 않음
    40024130The input parameter load balancing algorithm is invalid.로드 밸런싱 알고리즘이 유효하지 않음
    40024131The field {0} in the load balancer rule parameter is invalid.로드 밸런서 규칙의 {0} 필드가 유효하지 않음
    40024132The 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 경로는 '/'로 시작해야 하며 공백이 없어야 함
    40024133The field healthCheckPath in the load balancer rule parameter is invalid. If the protocol is NOT HTTP, it must not be specified.로드 밸런서 규칙의 프로토콜 유형이 HTTP가 아니면 헬스 체크 경로 지정 불가
    40024134The number of input parameter load balancer rules is the minimum of 1, maximum of 5.글자 길이 제한: 1~5
    40024173Only one zone can be selected for private IP load balancer.사설 IP 주소를 사용하는 로드 밸런서는 존을 1개만 입력 가능
    40024300The length constraints of the parameter description (memo) were violated. The minimum length is 0 byte, the maximum, 1,000 bytes.설명은 1~1,000 바이트 사이어야 함
    40025050(Other)Unable to operate load balancer since use is manipulating the applying server.로드 밸런서에 서버를 적용 중이라 사용 불가
    40025051Server is already being applied to load balancer.로드 밸런서에서 이미 적용 중인 서버
    40025052Server {0} is unable to apply to load balancer since it is either in operation or not being suspended.서버가 운영 중이거나 중지되지 않아 로드 밸런서에 적용 불가
    40026034An error occurred during certificate verification.인증서 인증 오류
    40026035Not found memberNo OR certificateName. Please check your input parameter.회원 번호 또는 인증서 이름을 찾을 수 없음
    40026036Not found memberNo OR certificateName OR privateKey OR publicKeyCertificate. Please check your input parameter.회원 번호, 인증서 이름, 비밀키, 또는 공개키를 찾을 수 없음
    40026037Certificate is being used in another loadBalancer.다른 로드 밸런서에서 이미 사용 중인 인증서
    40026002The issuer certificate of a looked up certificate could not be found. This normally means the list of trusted certificates is not complete.인증서 발행자를 찾을 수 없음
    40026003The CRL of a certificate could not be found.CRL을 찾을 수 없음
    40026004The 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.인증서 서명 복호화 실패
    40026005The 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 서명 복호화 실패
    40026006The public key in the certificate SubjectPublicKeyInfo could not be read.인증서 공개키를 읽을 수 없음
    40026007The signature of the certificate is invalid.인증서 서명이 유효하지 않음
    40026008The signature of the certificate is invalid.인증서 서명이 유효하지 않음
    40026009The certificate is not yet valid: the notBefore date is after the current time.인증서 유효 시작일이 현재 날짜 이후로 설정되어 있음
    40026010The certificate has expired: that is the notAfter date is before the current time.인증서 유효 만료일이 현재 날짜 이전으로 설정되어 있음
    40026011The CRL is not yet valid.CRL이 유효하지 않음
    40026012The CRL has expired.CRL이 만료됨
    40026013The certificate notBefore field contains an invalid time.인증서 유효 시작 일시가 유효하지 않음
    40026014The certificate notAfter field contains an invalid time.인증서 유효 만료 일시가 유효하지 않음
    40026015The CRL lastUpdate field contains an invalid time.CRL의 최종 업데이트 일시가 유효하지 않음
    40026016The CRL nextUpdate field contains an invalid time.CRL의 다음 업데이트 일시가 유효하지 않음
    40026017An error occurred trying to allocate memory. This should never happen.메모리 할당 오류
    40026018The passed certificate is self signed and the same certificate cannot be found in the list of trusted certificates.자체 서명된 인증서로 신뢰할 수 있는 인증서 목록에서 찾을 수 없음
    40026019The certificate chain could be built up using the untrusted certificates but the root could not be found locally.로컬 컴퓨터에서 루트 인증서를 찾을 수 없음
    40026020The issuer certificate could not be found: this occurs if the issuer certificate of an untrusted certificate cannot be found.인증서 발행자를 찾을 수 없음
    40026021No signatures could be verified because the chain contains only one certificate and it is not self signed.서명 인증 실패
    40026022The certificate chain length is greater than the supplied maximum depth. Unused.인증서 체인 길이 제한 초과
    40026023The certificate has been revoked.인증서가 해지됨
    40026024A CA certificate is invalid. Either it is not a CA or its extensions are not consistent with the supplied purpose.CA 인증서가 유효하지 않음
    40026025The basicConstraints path length parameter has been exceeded.인증 경로 길이 제한 초과
    40026026The supplied certificate cannot be used for the specified purpose.인증서를 해당 용도로 사용할 수 없음
    40026027The root CA is not marked as trusted for the specified purpose.루트 CA 인증서를 신뢰할 수 없음
    40026028The root CA is marked to reject the specified purpose.루트 CA 인증서 요청이 거부됨
    40026029The 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.주체자가 발행자와 일치하지 않아 인증서 요청이 거부됨
    40026030The 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.주체 키 식별자가 권한 키 식별자와 일치하지 않아 인증서 요청이 거부됨
    40026031The 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.인증서 발행자와 시리얼 번호가 권한 키 식별자와 일치하지 않아 인증서 요청이 거부됨
    40026032The current candidate issuer certificate was rejected because its keyUsage extension does not permit certificate signing.키 용도 확장이 서명을 허용하지 않아 인증서 요청이 거부됨
    40026033An application specific error. Unused.애플리케이션 오류
    40026034An error occurred during certificate verification.인증서 인증 오류
    40026035Not found memberNo OR certificateName. Please check your input parameter.회원 번호 또는 인증서 이름을 찾을 수 없음
    40026036Not found memberNo OR certificateName OR privateKey OR publicKeyCertificate. Please check your input parameter.회원 번호, 인증서 이름, 비밀키, 또는 공개키를 찾을 수 없음
    40026037Certificate is being used in another loadBalancer.다른 로드 밸런서에서 이미 사용 중인 인증서
    40026038The certificate name required for SSL/HTTPS. Please check your input parameter.로드 밸런서 규칙의 프로토콜 유형이 SSL 또는 HTTPS이면 인증서 이름 입력 필수
    40026042Proxy protocol can be set only with TCP, SSL protocols.로드 밸런서 규칙의 프로토콜 유형이 TCP 또는 SSL이어야만 프록시 프로토콜 설정 가능

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.