본문으로 건너뛰기

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 agentKubernetes Engine 서비스 에이전트가 프로젝트에 생성되었는지 여부를 조회합니다.

Versions​

사용 가능한 Kubernetes 버전을 조회합니다.

API설명
List available Kubernetes versions클러스터 생성 시 사용 가능한 Kubernetes 버전 목록을 조회합니다.