Kubernetes Engine
Kubernetes Engine API의 호출 주소와 리소스별 작업을 안내합니다. 각 API 링크에서 요청 파라미터, 본문 스키마와 응답을 확인할 수 있습니다.
기본 URL
https://kubernetes-engine.kr-central-2.kakaocloud.com
리소스별 API
클러스터, 노드 풀, 노드 등 주요 리소스의 API를 선택하면 요청 정보와 응답 형식을 확인할 수 있습니다.
Clusters
클러스터 구성, kubeconfig, 업그레이드와 클러스터 단위 노드 작업을 제공합니다.
| API | 설명 |
|---|---|
| Create cluster | 새로운 Kubernetes 클러스터를 생성합니다. |
| Delete cluster | 기존 클러스터를 삭제합니다. |
| Delete cluster nodes | 클러스터 내 특정 노드를 삭제 혹은 재생성합니다. |
| Get cluster | 특정 클러스터의 상세 정보를 조회합니다. |
| Get cluster kubeconfig | 클러스터 접속을 위한 kubeconfig 설정을 조회합니다. |
| Get cluster quotas | 특정 Kubernetes 클러스터의 노드 및 노드 풀 할당량과 사용량을 조회합니다. |
| List cluster nodes | 클러스터 내 모든 노드의 목록을 조회합니다. |
| List cluster upgradable versions | 클러스터에서 선택 가능한 Kubernetes 업그레이드 버전을 조회합니다. |
| List clusters | 클러스터 목록을 조회합니다. |
| Set cluster nodes cordon | 클러스터 내 특정 노드를 cordon(스케줄링 불가 상태)로 변경합니다. cordon 상태로 설정된 노드에는 새로운 파드(Pod)가 스케줄링되지 않으며, 이미 실행 중인 파드는 그대로 유지됩니다. |
| Update cluster | 특정 클러스터의 정보를 수정합니다. |
| Upgrade cluster | 클러스터를 업그레이드 가능한 Kubernetes 버전으로 업그레이드합니다. |
Node pool images
노드 풀 생성에 사용할 수 있는 이미지를 조회합니다.
| API | 설명 |
|---|---|
| List node pool images | 클러스터에서 노드 풀 생성 시 사용할 수 있는 노드 이미지 목록을 조회합니다. |
Node pools
노드 풀 구성, 오토스케일링, 노드 설정 및 업그레이드를 관리합니다.
| API | 설명 |
|---|---|
| Create node pool | 클러스터 내에 새로운 노드 풀을 생성합니다. |
| Create node pool scheduled scaling | 노드 풀에 적용할 예약 기반 오토스케일링 규칙을 생성합니다. |
| Delete node pool | 클러스터에서 특정 노드 풀을 제거합니다. |
| Delete node pool scheduled scaling | 노드 풀에 설정된 예약 기반 오토스케일링 규칙을 삭제합니다. |
| Get node pool | 특정 노드 풀의 상세 정보를 조회합니다. |
| List node pool nodes | 노드 풀에 속한 모든 노드의 목록을 조회합니다. |
| List node pool scheduled scalings | 노드 풀에 설정된 예약 기반 오토스케일링 규칙을 모두 조회합니다. |
| List node pools | 클러스터 내 모든 노드 풀 목록을 조회합니다. |
| Set node pool node label | 노드 풀 내 모든 노드에 사용자 정의 레이블을 일괄 추가·수정·삭제합니다. |
| Set node pool resource-based auto scaling | 노드 풀의 리소스 기반 오토스케일링 규칙을 설정합니다. |
| Set node pool security groups | 특정 클러스터 노드 풀에 연결된 보안 그룹을 변경합니다. |
| Set node pool user script | 노드 풀의 노드가 생성되거나 초기화될 때 실행할 사용자 스크립트(user data)를 설정합니다. |
| Update node pool | 노드 풀의 기본 설정(노드 수, 보안 그룹, 설명 등)을 수정합니다. |
| Upgrade node pool | 노드 풀 내 노드의 Kubernetes 버전을 업그레이드합니다. |
Nodes
개별 노드의 상태와 상세 정보를 조회합니다.
| API | 설명 |
|---|---|
| Get cluster node | 클러스터 내 특정 노드의 상세 정보를 조회합니다. |
| Get cluster node details | 클러스터 내 특정 노드의 상세 정보를 조회합니다. |
Quotas
프로젝트의 Kubernetes Engine 할당량과 사용량을 조회합니다.
| API | 설명 |
|---|---|
| Get Kubernetes Engine quotas | 프로젝트 전체 Kubernetes Engine 할당량과 사용량을 조회합니다. |
Service agents
프로젝트의 서비스 에이전트를 생성하고 생성 여부를 확인합니다.
| API | 설명 |
|---|---|
| Create service agent | 클러스터 관리 및 모니터링을 위한 서비스 에이전트를 생성합니다. |
| Get service agent | Kubernetes Engine 서비스 에이전트가 프로젝트에 생성되었는지 여부를 조회합니다. |
Versions
사용 가능한 Kubernetes 버전을 조회합니다.
| API | 설명 |
|---|---|
| List available Kubernetes versions | 클러스터 생성 시 사용 가능한 Kubernetes 버전 목록을 조회합니다. |