createLoadBalancerInstance

Prev Next

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

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

요청

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

메서드 URI
GET /loadbalancer/v2/createLoadBalancerInstance

요청 헤더

Load Balancer API에서 공통으로 사용하는 헤더에 대한 정보는 Load Balancer 요청 헤더를 참조해 주십시오.

요청 쿼리 파라미터

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

필드 타입 필수 여부 설명
loadBalancerName String Optional 생성하려는 로드 밸런서의 이름
  • 네이버 클라우드 플랫폼이 자동으로 부여(기본값)
  • 3~30자
loadBalancerAlgorithmTypeCode String Optional 로드 밸런싱에 사용할 알고리즘 유형
  • RR (기본값) | SIPHS | LC
    • RR: Round Robin
    • SIPHS: Source IP Hash
    • LC: Least Connection
loadBalancerDescription String Optional 로드 밸런서에 대한 설명(Byte)
  • 0~1,000
networkUsageTypeCode String Optional 로드 밸런서의 네크워크 유형
  • PBLIP (기본값) | PRVT
    • PBLIP (Public): 공인 IP
    • PRVT (Private): 사설 IP
serverInstanceNoList.N String Optional 로드 밸런서에 바인드할 서버 인스턴스의 번호 목록
loadBalancerRuleList.N.protocolTypeCode String Required 로드 밸런서 규칙의 프로토콜 유형
  • HTTP | HTTPS | TCP | SSL
loadBalancerRuleList.N.loadBalancerPort Integer Required 로드 밸런서 규칙의 포트
  • 1~65534
  • 동일한 로드 밸런서에서 포트 중복 불가
  • 22, 3389, 64000, 65130, 65131, 18080~18095 포트는 로드 밸런서 관리용으로 사용 불가
loadBalancerRuleList.N.serverPort Integer Required 로드 밸런서 규칙의 서버 포트
  • 1~65534
  • 동일한 로드 밸런서에서 포트 중복 가능
loadBalancerRuleList.N.l7HealthCheckPath String Conditional 로드 밸런서 규칙의 헬스 체크 경로
  • / (기본값)
  • /로 시작하는 URL 경로
  • loadBalancerRuleList.N.protocolTypeCodeHTTP 또는 HTTPS이면 입력 필수
loadBalancerRuleList.N.certificateName String Conditional 로드 밸런서의 SSL 공인 인증서 이름
loadBalancerRuleList.N.protocloTypeCodeSSL 또는 HTTPS이면 입력 필수
loadBalancerRuleList.N.proxyProtocolUseYn String Optional 프록시 프로토콜 사용 여부
  • Y | N
    • Y: 설정
    • N: 해제
  • loadBalancerRuleList.N.protocloTypeCodeTCP 또는 SSL이면 설정 가능
loadBalancerRuleList.N.stickySessionUseYn String Optional 세션별 접근 사용 여부
  • Y | N
    • Y: 설정
    • N: 해제
  • loadBalancerRuleList.N.protocloTypeCodeHTTP 또는 HTTPS이면 설정 가능
loadBalancerRuleList.N.http2UseYn String Optional HTTP/2 프로토콜 사용 여부
  • Y | N
    • Y: 설정
    • N: 해제
  • loadBalancerRuleList.N.protocloTypeCodeHTTPS이면 설정 가능
loadBalancerRuleList.N.serverProtocolTypeCode String Optional 서버의 프로토콜 유형
  • HTTP (기본값) | HTTPS
  • loadBalancerRuleList.N.protocloTypeCode HTTPS이면 설정 가능
regionNo String Optional 로드 밸런스를 생성하려는 리전의 번호
  • getRegionList 참조
  • 리전과 존을 모두 입력하지 않으면 한국 리전의 존에 임의로 배정
  • zoneNoList List[String] Optional 로드 밸런스를 생성하려는 존 번호 목록
    • zoneNogetRegionList 참조
    • 사설 IP 로드 밸런서는 1개의 존만 선택 가능하며 멀티존 지원 예정

    요청 예시

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

    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>