Kubernetes

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 응용 프로그램 인터페이스(Application Programming Interface, API)를 제공합니다.

본 가이드는 KUBERNETES 서비스에 대한 간략한 설명 및 API를 호출하는 방법을 제공합니다. API는 RESTful API 방식으로 제공되며, JSON 형식으로 응답합니다.

Version

Not Before 기간이 도래하거나 만료된 Deprecated 버전은 더 이상 지원하지 않습니다. 최신 버전 사용을 권장합니다.

Version	Status	Not Before
1.6	CURRENT	-
1.5	SUPPORTED	20270315
1.4	SUPPORTED	20270116
1.3	DEPRECATED	20261121
1.2	DEPRECATED	20261021
1.1	DEPRECATED	20260919
1.0	DEPRECATED	20251231

OpenAPI URL

https://ske.{region}.{environment}.samsungsdscloud.com

Environment and Region List

environment	region
s	kr-west1
s	kr-east1
g	kr-south1
g	kr-south2
g	kr-south3
e	kr-west1
e	kr-east1

API Version History

1.6

Kubernetes Engine이 1.6 버전으로 업데이트되었습니다.

변경사항

[추가] PUT /ske/1.6/clusters/{cluster_id}/deletion-protection - 클러스터의 삭제 보호를 설정합니다.
- 요청: deletion_protection_enabled
[추가] PUT /ske/1.6/clusters/{cluster_id}/linked-resources - 클러스터의 링크된 리소스를 설정합니다.
- 요청: linked_resources
[추가] PUT /ske/1.6/clusters/{cluster_id}/nfs-volume - 클러스터의 NFS 볼륨을 설정합니다.
- 요청: nfs_volume_id
[추가] PUT /ske/1.6/clusters/{cluster_id}/subnets - 클러스터의 서브넷을 설정합니다.
- 요청: additional_subnet_id_list
[추가] GET /ske/1.6/clusters/{cluster_id}/namespaces/{namespace_name}/pods - 네임스페이스의 포드를 목록으로 조회합니다.
- 응답: PodListResponse
[변경] POST /ske/1.6/clusters - 요청 시, 아래와 같은 필드가 추가됩니다.
- additional_subnet_id_list
- default_subnet_id
- deletion_protection_enabled
- linked_resources
- nfs_volume_id
[변경] POST /ske/1.6/clusters - 요청 시, 아래와 같은 필드가 제거됩니다.
- cloud_logging_enabled
- subnet_id
- volume_id
[변경] GET /ske/1.6/clusters/{cluster_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
- additional_subnet_id_list
- default_subnet_id
- deletion_protection_enabled
- linked_resources
- managed_security_group_id
- nfs_volume_id
- security_group_id_list
- vpc_id
[변경] GET /ske/1.6/clusters/{cluster_id} - 응답 시, 아래와 같은 필드가 제거됩니다.
- cloud_logging_enabled
- managed_security_group
- security_group_list
- subnet
- volume
- vpc
[변경] GET /ske/1.6/clusters - 응답 시, 아래와 같은 필드가 추가됩니다.
- additional_subnet_id_list
- default_subnet_id
- deletion_protection_enabled
[변경] GET /ske/1.6/clusters - 응답 시, 아래와 같은 필드가 제거됩니다.
- subnet_id
[변경] GET /ske/1.6/images - 응답 시, 아래와 같은 필드가 추가됩니다.
- visibility
- zone
[변경] GET /ske/1.6/clusters/{cluster_id}/nodepools - 응답 시, 아래와 같은 필드가 추가됩니다.
- subnet_id
[제거] PUT /ske/1.5/clusters/{cluster_id}/logging - 클러스터 로깅 설정 API가 제거되었습니다.

1.5

Kubernetes Engine가 1.5 버전으로 업데이트되었습니다.

변경사항

[추가] PUT /ske/1.5/nodepools/{nodepool_id}/preferred-ips - 노드 풀의 선호 IP를 설정합니다.
- 요청: preferred_ips
[변경] GET /ske/1.5/clusters/{cluster_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
- security_group_list
[변경] POST /ske/1.5/clusters - 요청 시, 아래와 같은 필드가 추가됩니다.
- security_group_id_list
[변경] POST /ske/1.5/nodepools - 요청 시, 아래와 같은 필드가 추가됩니다.
- preferred_ips
- subnet_id
- zone
[변경] GET /ske/1.5/nodepools/{nodepool_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
- preferred_ips
- subnet_id
- zone

1.4

Kubernetes Engine이 1.4 버전으로 업데이트되었습니다.

변경사항

[변경] POST /ske/1.4/nodepools - 요청 시, 아래와 같은 필드가 추가됩니다.
- scp_gpu_driver
- volume_max_iops
- volume_max_throughput
[변경] GET /ske/1.4/nodepools/{nodepool_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
- scp_gpu_driver
- volume_max_iops
- volume_max_throughput
[변경] PUT /ske/1.4/nodepools/{nodepool_id}/upgrade - 요청 시, 아래와 같은 필드가 추가됩니다.
- scp_gpu_driver
[변경] GET /ske/1.4/images - 응답 시, 아래와 같은 필드가 추가됩니다.
- scp_gpu_driver
- scp_supported_class_types

1.3

Kubernetes Engine이 1.3 버전으로 업데이트되었습니다.

변경사항

[신규] PUT /ske/1.3/nodepools/{nodepool_id}/linked-resources - Set Nodepool Linked Resources API 가 추가되었습니다.
[변경] POST /ske/1.3/nodepools - 요청 시, 아래와 같은 필드가 추가됩니다.
- linked_resources
[변경] GET /ske/1.3/nodepools/{nodepool_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
- linked_resources

1.2

Kubernetes Engine이 1.2 버전으로 업데이트되었습니다.

변경사항

[신규] GET /ske/1.2/images - List Images API 가 추가되었습니다.

1.1

Kubernetes Engine이 1.1 버전으로 업데이트되었습니다.

변경사항

[신규] PUT /ske/1.1/clusters/{cluster_id}/service-watch-logging - Set Cluster Service Watch Logging API 가 추가되었습니다.
[변경] POST /ske/1.1/clusters - 요청 시, 아래와 같은 필드가 추가됩니다.
- service_watch_logging_enabled
[변경] GET /ske/1.1/clusters/{cluster_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
- service_watch_logging_enabled
[변경] POST /ske/1.1/nodepools - 요청 시, 아래와 같은 필드가 추가됩니다.
- advanced_settings
- server_group_id
[변경] GET /ske/1.1/nodepools/{nodepool_id} - 응답 시, 아래와 같은 필드가 추가됩니다.
- advanced_settings
- server_group_id
[변경] PUT /ske/1.1/nodepools/{nodepool_id}/upgrade - 요청 시, 아래와 같은 필드가 추가됩니다.
- os_version

1.0

Kubernetes Engine이 출시되었습니다.

변경사항

[신규] GET /clusters – List Clusters API 가 추가되었습니다.
[신규] POST /clusters – Create Cluster API 가 추가되었습니다.
[신규] DELETE /clusters/{cluster_id} – Delete Cluster API 가 추가되었습니다.
[신규] GET /clusters/{cluster_id} – Show Cluster API 가 추가되었습니다.
[신규] GET /clusters/{cluster_id}/kubeconfig – Create Cluster Kubeconfig API 가 추가되었습니다.
[신규] PUT /clusters/{cluster_id}/logging – Set Cluster Logging API 가 추가되었습니다.
[신규] PUT /clusters/{cluster_id}/private-access-control – Set Cluster Private Access Control API 가 추가되었습니다.
[신규] PUT /clusters/{cluster_id}/public-access-control – Set Cluster Public Access Control API 가 추가되었습니다.
[신규] PUT /clusters/{cluster_id}/security-groups – Set Cluster Security Groups API 가 추가되었습니다.
[신규] PUT /clusters/{cluster_id}/upgrade – Set Cluster Upgrade API 가 추가되었습니다.
[신규] GET /clusters/{cluster_id}/user-kubeconfig – Show Cluster User Kubeconfig API 가 추가되었습니다.
[신규] GET /clusters/{cluster_id}/nodepools – List Nodepools API 가 추가되었습니다.
[신규] POST /nodepools – Create Nodepool API 가 추가되었습니다.
[신규] DELETE /nodepools/{nodepool_id} – Delete Nodepool API 가 추가되었습니다.
[신규] GET /nodepools/{nodepool_id} – Show Nodepool API 가 추가되었습니다.
[신규] PUT /nodepools/{nodepool_id} – Set Nodepool API 가 추가되었습니다.
[신규] PUT /nodepools/{nodepool_id}/labels – Set Nodepool Labels API 가 추가되었습니다.
[신규] GET /nodepools/{nodepool_id}/nodes – List Nodepool Nodes API 가 추가되었습니다.
[신규] PUT /nodepools/{nodepool_id}/taints – Set Nodepool Taints API 가 추가되었습니다.
[신규] PUT /nodepools/{nodepool_id}/upgrade – Set Nodepool Upgrade API 가 추가되었습니다.
[신규] GET /kubernetes-versions – List Kubernetes Versions API 가 추가되었습니다.