Load Balancer

Load Balancer API의 호출 주소와 리소스별 작업을 안내합니다. 각 API 링크에서 요청 파라미터, 본문 스키마와 응답을 확인할 수 있습니다.

기본 URL

https://load-balancer.kr-central-2.kakaocloud.com

로드 밸런서, 리스너, 대상 그룹 등 주요 리소스의 API를 선택하면 요청 정보와 응답 형식을 확인할 수 있습니다.

대상 그룹의 상태 확인 설정과 헬스 체크 서브넷을 조회·관리합니다.

API	설명
Create health monitor	지정한 대상 그룹에 헬스 모니터를 생성합니다.
Delete health monitor	지정한 헬스 모니터(Health Monitor)를 삭제합니다.
Get target group health check subnets	대상 그룹의 헬스 체크에 사용되는 IP 목록을 조회합니다.
Get target group health monitor	지정한 헬스 모니터 ID에 해당하는 대상 그룹 헬스 모니터의 상세 정보를 조회합니다.
Update health monitor	지정한 헬스 모니터의 설정을 수정합니다.

고가용성 그룹과 그룹에 참여하는 로드 밸런서를 관리합니다.

API	설명
Create HA group	고가용성 그룹(High Availability Group)을 생성합니다.
Delete HA group	특정 고가용성 그룹(High Availability Group)을 삭제합니다.
Detach HA group load balancer	지정한 고가용성 그룹(High Availability Group)에서 로드 밸런서를 연결 해제합니다.
Get HA group	지정한 고가용성 그룹(High Availability Group)의 상세 정보를 조회합니다.
List HA groups	고가용성 그룹(High Availability Group)의 전체 목록을 조회합니다.
Update HA group	특정 고가용성 그룹의 설명을 수정합니다.
Update HA group load balancer	고가용성 로드 밸런서에 새로운 가용 영역의 로드 밸런서를 추가합니다.

리스너의 애플리케이션 계층 트래픽 처리 정책을 관리합니다.

API	설명
Create L7 policy	지정한 리스너에 L7 정책을 생성합니다. 정책은 하나 이상의 L7 규칙과 함께 구성되어야 하며, 리디렉션 동작(action)에 따라 대상 그룹, 경로(prefix), URL 등을 지정할 수 있습니다.
Delete L7 policy	로드 밸런서에 설정된 특정 L7 정책(Policy)을 삭제합니다. 삭제 시, 해당 정책에 포함된 모든 L7 규칙도 함께 제거됩니다.
Get L7 policy	지정한 L7 정책 ID에 해당하는 L7 정책의 상세 정보를 조회합니다.
List L7 policies	지정한 로드 밸런서와 리스너에 연결된 L7 정책 목록을 조회합니다.
Update L7 policy	지정한 L7 정책을 수정합니다.

L7 정책에 적용할 요청 일치 조건을 관리합니다.

API	설명
Add L7 policy rule	로드 밸런서의 지정한 L7 정책에 규칙을 추가합니다.
Delete L7 policy rule	로드 밸런서의 특정 L7 정책에 설정된 L7 규칙을 삭제합니다.
Get L7 policy rule	로드 밸런서의 특정 L7 정책(Policy)에 속한 단일 L7 규칙의 상세 정보를 조회합니다.
List L7 policy rules	지정한 L7 정책에 정의된 규칙 목록을 조회합니다.
Update L7 policy rule	L7 정책에 속한 특정 L7 규칙의 조건 및 속성을 수정합니다.

트래픽을 수신할 리스너의 프로토콜과 연결 설정을 관리합니다.

로드 밸런서, 퍼블릭 IP 연결 및 액세스 로그 설정을 관리합니다. 생성에 필요한 가용 영역·유형·인증서 조회도 포함합니다.

API	설명
Associate new public IP	지정한 로드 밸런서에 신규 퍼블릭 IP를 생성하고 자동으로 연결합니다.
Associate public IP	기존에 생성된 퍼블릭 IP를 지정한 로드 밸런서에 연결합니다.
Create load balancer	새로운 로드 밸런서를 생성합니다. 리스너와 대상 그룹을 포함한 초기 설정을 함께 지정할 수 있습니다.
Delete load balancer	지정한 로드 밸런서를 삭제합니다.
Get load balancer	특정 로드 밸런서의 상세 정보를 조회합니다.
List availability zones	로드 밸런서를 배치할 수 있는 가용 영역 목록을 조회합니다.
List load balancer types	사용 가능한 로드 밸런서 유형의 전체 목록을 조회합니다.
List load balancers	로드 밸런서 전체 목록을 조회합니다.
List TLS certificates	로드 밸런서에서 사용할 수 있는 TLS 인증서(Secret) 목록을 조회합니다. 인증서는 Certificate Manager를 통해 등록된 리소스이며, HTTPS 리스너 생성 시 `default_tls_container_ref` 파라미터에서 참조할 수 있습니다.
Remove public IP	지정한 로드 밸런서에서 퍼블릭 IP의 연결을 해제하고, 요청에 따라 퍼블릭 IP를 함께 삭제합니다.
Update access log	지정한 로드 밸런서의 액세스 로그를 버킷에 저장하도록 설정합니다.
Update load balancer	특정 로드 밸런서의 이름과 설명을 수정합니다.

대상 그룹과 트래픽을 전달할 대상을 관리합니다.

API	설명
Add target	로드 밸런서 대상 그룹에 새로운 대상 인스턴스를 추가합니다. 지정한 인스턴스는 지정한 프로토콜 포트로 트래픽을 수신하며, 헬스 체크는 별도의 모니터링 포트로 수행됩니다.
Create target group	새로운 로드 밸런서 대상 그룹을 생성합니다.
Delete target group	지정한 로드 밸런서의 대상 그룹을 삭제합니다.
Get target	특정 로드 밸런서 대상 그룹에 포함된 대상(Target) 인스턴스를 조회합니다.
Get target group	지정한 대상 그룹 ID에 해당하는 로드 밸런서 대상 그룹의 상세 정보를 조회합니다.
List target groups	로드 밸런서의 트래픽 분산 대상으로 등록된 대상 그룹 목록을 조회합니다.
List targets in target group	특정 로드 밸런서 대상 그룹에 포함된 대상(Target) 인스턴스의 목록을 조회합니다.
Remove target	로드 밸런서 대상 그룹에서 지정한 대상 인스턴스를 삭제합니다.
Update target	로드 밸런서 대상 그룹의 특정 대상 인스턴스 정보를 수정합니다.
Update target group	로드 밸런서에 연결된 대상 그룹의 정보를 수정합니다.
Update targets	로드 밸런서 대상 그룹의 여러 대상 인스턴스 정보를 일괄 수정합니다. 기존 대상 인스턴스를 수정/삭제하거나, 새로운 대상 인스턴스를 추가할 수 있습니다.