이 섹션의 다중 페이지 출력 화면임. 여기를 클릭하여 프린트.

Kubernetes

1: APIs

1.1: Create Cluster

1.1.1: 1.1
1.1.2: 1.0

1.2: Create Cluster Kubeconfig

1.2.1: 1.1
1.2.2: 1.0

1.3: Create Nodepool

1.3.1: 1.1
1.3.2: 1.0

1.4: Delete Cluster

1.4.1: 1.1
1.4.2: 1.0

1.5: Delete Nodepool

1.5.1: 1.1
1.5.2: 1.0

1.6: List Clusters

1.6.1: 1.1
1.6.2: 1.0

1.7: List Kubernetes Versions

1.7.1: 1.1
1.7.2: 1.0

1.8: List Nodepool Nodes

1.8.1: 1.1
1.8.2: 1.0

1.9: List Nodepools

1.9.1: 1.1
1.9.2: 1.0

1.10: Set Cluster Logging

1.10.1: 1.1
1.10.2: 1.0

1.11: Set Cluster Private Access Control

1.11.1: 1.1
1.11.2: 1.0

1.12: Set Cluster Public Access Control

1.12.1: 1.1
1.12.2: 1.0

1.13: Set Cluster Security Groups

1.13.1: 1.1
1.13.2: 1.0

1.14: Set Cluster Service Watch Logging

1.14.1: 1.1

1.15: Set Cluster Upgrade

1.15.1: 1.1
1.15.2: 1.0

1.16: Set Nodepool

1.16.1: 1.1
1.16.2: 1.0

1.17: Set Nodepool Labels

1.17.1: 1.1
1.17.2: 1.0

1.18: Set Nodepool Taints

1.18.1: 1.1
1.18.2: 1.0

1.19: Set Nodepool Upgrade

1.19.1: 1.1
1.19.2: 1.0

1.20: Show Cluster

1.20.1: 1.1
1.20.2: 1.0

1.21: Show Cluster User Kubeconfig

1.21.1: 1.1
1.21.2: 1.0

1.22: Show Nodepool

1.22.1: 1.1
1.22.2: 1.0

2: Models

2.1: AsyncResponse
2.2: Cluster
2.3: ClusterCreateRequest
2.4: ClusterCreateRequestV1Dot1
2.5: ClusterListResponse
2.6: ClusterLoggingSetRequest
2.7: ClusterOfNodepool
2.8: ClusterPrivateAccessControlSetRequest
2.9: ClusterPublicAccessControlSetRequest
2.10: ClusterSecurityGroupsSetRequest
2.11: ClusterServiceWatchLoggingSetRequest
2.12: ClusterSetResponse
2.13: ClusterShowResponse
2.14: ClusterShowResponseV1Dot1
2.15: ClusterSummary
2.16: ClusterUpgradeSetRequest
2.17: ClusterV1Dot1
2.18: ExternalResource
2.19: Image
2.20: Keypair
2.21: KubernetesVersionListResponse
2.22: KubernetesVersionSummary
2.23: NodeInNodepool
2.24: NodeListInNodepoolResponse
2.25: Nodepool
2.26: NodepoolAdvancedSettings
2.27: NodepoolCreateRequest
2.28: NodepoolCreateRequestV1Dot1
2.29: NodepoolLabel
2.30: NodepoolLabelsSetRequest
2.31: NodepoolListResponse
2.32: NodepoolShowResponse
2.33: NodepoolShowResponseV1Dot1
2.34: NodepoolSummary
2.35: NodepoolTaint
2.36: NodepoolTaintsSetRequest
2.37: NodepoolUpdateRequest
2.38: NodepoolUpgradeSetRequest
2.39: NodepoolV1Dot1
2.40: PrivateEndpointAccessControlResource
2.41: ServerType
2.42: Tag
2.43: VolumeType
2.44: VolumeTypeSummary

Overview

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

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

Version

Version	Status	Supported Until
1.0	DEPRECATED	20251231
1.1	CURRENT	-

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

1 - APIs

1.1 - Create Cluster

1.1.1 - 1.1

post /v1/clusters

Description

create a cluster V1.1

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		ClusterCreateRequestV1Dot1

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Request body

{
    "cloud_logging_enabled": "true",
    "kubernetes_version": "v1.29.8",
    "name": "sample-cluster",
    "private_endpoint_access_control_resources": [],
    "public_endpoint_access_control_ip": "192.168.0.0",
    "security_group_id_list": [
        "bdfda539-bd2e-4a5c-9021-ec6d52d1ca79"
    ],
    "service_watch_logging_enabled": "true",
    "subnet_id": "023c57b14f11483689338d085e061492",
    "tags": [],
    "volume_id": [
        "bfdbabf2-04d9-4e8b-a205-020f8e6da438"
    ],
    "vpc_id": "7df8abb4912e4709b1cb237daccca7a8"
}

Example HTTP response

Response 202

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.1.2 - 1.0

post /v1/clusters

Description

create a cluster

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		ClusterCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Request body

{
    "cloud_logging_enabled": "true",
    "kubernetes_version": "v1.29.8",
    "name": "sample-cluster",
    "private_endpoint_access_control_resources": [],
    "public_endpoint_access_control_ip": "192.168.0.0",
    "security_group_id_list": [
        "bdfda539-bd2e-4a5c-9021-ec6d52d1ca79"
    ],
    "subnet_id": "023c57b14f11483689338d085e061492",
    "tags": [],
    "volume_id": [
        "bfdbabf2-04d9-4e8b-a205-020f8e6da438"
    ],
    "vpc_id": "7df8abb4912e4709b1cb237daccca7a8"
}

Example HTTP response

Response 202

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.2 - Create Cluster Kubeconfig

1.2.1 - 1.1

get /v1/clusters/{cluster_id}/kubeconfig

Description

Create kubeconfig file for the cluster

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
query	kubeconfig_type required	Kubeconfig 타입 (private/public) Example : `private`	enum (private, public)	None

Responses

HTTP Code	Description	Schema
200	OK	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/kubeconfig?kubeconfig_type={kubeconfig_type}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Example HTTP response

Response 200

1.2.2 - 1.0

get /v1/clusters/{cluster_id}/kubeconfig

Description

Create kubeconfig file for the cluster

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
query	kubeconfig_type required	Kubeconfig 타입 (private/public) Example : `private`	enum (private, public)	None

Responses

HTTP Code	Description	Schema
200	OK	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/kubeconfig?kubeconfig_type={kubeconfig_type}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Example HTTP response

Response 200

1.3 - Create Nodepool

1.3.1 - 1.1

post /v1/nodepools

Description

create a nodepool V1.1

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		NodepoolCreateRequestV1Dot1

Responses

HTTP Code	Description	Schema
200	OK	NodepoolShowResponseV1Dot1
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Request body

{
    "advanced_settings": {
        "allowed_unsafe_sysctls": "kernel.msg*,net.ipv4.route.min_pmtu",
        "container_log_max_files": "5",
        "container_log_max_size": "10",
        "image_gc_high_threshold": "85",
        "image_gc_low_threshold": "80",
        "max_pods": "110",
        "pod_max_pids": "4096"
    },
    "cluster_id": "70a599e031e749b7b260868f441e862b",
    "custom_image_id": "10a599e031e749b7b260868f441e862b",
    "desired_node_count": "2",
    "image_os": "ubuntu",
    "image_os_version": "22.04",
    "is_auto_recovery": "true",
    "is_auto_scale": "true",
    "keypair_name": "test_keypair",
    "kubernetes_version": "v1.29.8",
    "labels": [
        {
            "key": "example.com/my-app",
            "value": "bar"
        }
    ],
    "max_node_count": "5",
    "min_node_count": "1",
    "name": "sample-nodepool",
    "server_group_id": "2b8d33d5-4de5-40a5-a34c-7e30204133xc",
    "server_type_id": "10a599e031e749b7b260868f441e862b",
    "taints": [
        {
            "effect": "NoSchedule",
            "key": "example.com/my-app",
            "value": "bar"
        }
    ],
    "volume_size": "104",
    "volume_type_name": "SSD"
}

Example HTTP response

Response 200

{
    "nodepool": {
        "account_id": "617b3d0e90c24a5fa1f65a3824861354",
        "advanced_settings": {
            "allowed_unsafe_sysctls": "kernel.msg*,net.ipv4.route.min_pmtu",
            "container_log_max_files": "5",
            "container_log_max_size": "10",
            "image_gc_high_threshold": "85",
            "image_gc_low_threshold": "80",
            "max_pods": "110",
            "pod_max_pids": "4096"
        },
        "auto_recovery_enabled": "true",
        "auto_scale_enabled": "true",
        "cluster": {
            "id": "70a599e031e749b7b260868f441e862b"
        },
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "current_node_count": "1",
        "desired_node_count": "2",
        "id": "bdfda539-bd2e-4a5c-9021-ec6d52d1ca79",
        "image": {
            "custom_image_name": "custom-image",
            "os": "ubuntu",
            "os_version": "22.04"
        },
        "keypair": {
            "name": "test_keypair"
        },
        "kubernetes_version": "v1.29.8",
        "labels": [
            {
                "key": "example.com/my-app",
                "value": "bar"
            }
        ],
        "max_node_count": "5",
        "min_node_count": "1",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "name": "sample-nodepool",
        "server_group_id": "2b8d33d5-4de5-40a5-a34c-7e30204133xc",
        "server_type": {
            "description": "Standard",
            "id": "10a599e031e749b7b260868f441e862b"
        },
        "status": "Running",
        "taints": [
            {
                "effect": "NoSchedule",
                "key": "example.com/my-app",
                "value": "bar"
            }
        ],
        "volume_size": "104",
        "volume_type": {
            "encrypt": "true",
            "id": "10a599e031e749b7b260868f441e862b",
            "name": "SSD"
        }
    }
}

1.3.2 - 1.0

post /v1/nodepools

Description

create a nodepool

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		NodepoolCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	NodepoolShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Request body

{
    "cluster_id": "70a599e031e749b7b260868f441e862b",
    "custom_image_id": "10a599e031e749b7b260868f441e862b",
    "desired_node_count": "2",
    "image_os": "ubuntu",
    "image_os_version": "22.04",
    "is_auto_recovery": "true",
    "is_auto_scale": "true",
    "keypair_name": "test_keypair",
    "kubernetes_version": "v1.29.8",
    "labels": [
        {
            "key": "example.com/my-app",
            "value": "bar"
        }
    ],
    "max_node_count": "5",
    "min_node_count": "1",
    "name": "sample-nodepool",
    "server_type_id": "10a599e031e749b7b260868f441e862b",
    "taints": [
        {
            "effect": "NoSchedule",
            "key": "example.com/my-app",
            "value": "bar"
        }
    ],
    "volume_size": "104",
    "volume_type_name": "SSD"
}

Example HTTP response

Response 200

{
    "nodepool": {
        "account_id": "617b3d0e90c24a5fa1f65a3824861354",
        "auto_recovery_enabled": "true",
        "auto_scale_enabled": "true",
        "cluster": {
            "id": "70a599e031e749b7b260868f441e862b"
        },
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "current_node_count": "1",
        "desired_node_count": "2",
        "id": "bdfda539-bd2e-4a5c-9021-ec6d52d1ca79",
        "image": {
            "custom_image_name": "custom-image",
            "os": "ubuntu",
            "os_version": "22.04"
        },
        "keypair": {
            "name": "test_keypair"
        },
        "kubernetes_version": "v1.29.8",
        "labels": [
            {
                "key": "example.com/my-app",
                "value": "bar"
            }
        ],
        "max_node_count": "5",
        "min_node_count": "1",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "name": "sample-nodepool",
        "server_type": {
            "description": "Standard",
            "id": "10a599e031e749b7b260868f441e862b"
        },
        "status": "Running",
        "taints": [
            {
                "effect": "NoSchedule",
                "key": "example.com/my-app",
                "value": "bar"
            }
        ],
        "volume_size": "104",
        "volume_type": {
            "encrypt": "true",
            "id": "10a599e031e749b7b260868f441e862b",
            "name": "SSD"
        }
    }
}

1.4 - Delete Cluster

1.4.1 - 1.1

delete /v1/clusters/{cluster_id}

Description

delete a specific cluster

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Example HTTP response

Response 202

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.4.2 - 1.0

delete /v1/clusters/{cluster_id}

Description

delete a specific cluster

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Example HTTP response

Response 202

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.5 - Delete Nodepool

1.5.1 - 1.1

delete /v1/nodepools/{nodepool_id}

Description

delete a nodepool

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Example HTTP response

Response 202

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.5.2 - 1.0

delete /v1/nodepools/{nodepool_id}

Description

delete a nodepool

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None

Responses

HTTP Code	Description	Schema
202	Accepted	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Example HTTP response

Response 202

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.6 - List Clusters

1.6.1 - 1.1

get /v1/clusters

Description

get clusters list

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	클러스터 이름 Example : `sample-cluster`	any of [string, null]	None
query	status optional	클러스터 상태 Example : `RUNNING`	any of [array[string], string, null]	None
query	kubernetes_version optional	클러스터 버전 Example : `v1.29.8`	any of [array[string], string, null]	None
query	subnet_id optional	클러스터 Subnet ID Example : `023c57b14f11483689338d085e061492`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ClusterListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Example HTTP response

Response 200

{
    "clusters": [
        {
            "account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "created_at": "2025-03-31T00:23:17Z",
            "id": "70a599e031e749b7b260868f441e862b",
            "kubernetes_version": "v1.29.8",
            "modified_at": "2025-03-31T00:23:17Z",
            "name": "sample-cluster",
            "node_count": "5",
            "status": "RUNNING",
            "subnet_id": "023c57b14f11483689338d085e061492"
        }
    ],
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/notices",
            "rel": "self"
        }
    ]
}

1.6.2 - 1.0

get /v1/clusters

Description

get clusters list

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	클러스터 이름 Example : `sample-cluster`	any of [string, null]	None
query	status optional	클러스터 상태 Example : `RUNNING`	any of [array[string], string, null]	None
query	kubernetes_version optional	클러스터 버전 Example : `v1.29.8`	any of [array[string], string, null]	None
query	subnet_id optional	클러스터 Subnet ID Example : `023c57b14f11483689338d085e061492`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ClusterListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Example HTTP response

Response 200

{
    "clusters": [
        {
            "account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "created_at": "2025-03-31T00:23:17Z",
            "id": "70a599e031e749b7b260868f441e862b",
            "kubernetes_version": "v1.29.8",
            "modified_at": "2025-03-31T00:23:17Z",
            "name": "sample-cluster",
            "node_count": "5",
            "status": "RUNNING",
            "subnet_id": "023c57b14f11483689338d085e061492"
        }
    ],
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/notices",
            "rel": "self"
        }
    ]
}

1.7 - List Kubernetes Versions

1.7.1 - 1.1

get /v1/kubernetes-versions

Description

get kubernetes versions list

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Responses

HTTP Code	Description	Schema
200	OK	KubernetesVersionListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/kubernetes-versions

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Example HTTP response

Response 200

{
    "kubernetes_versions": [
        {
            "description": "v1.29.8",
            "kubernetes_version": "v1.29.8"
        }
    ]
}

1.7.2 - 1.0

get /v1/kubernetes-versions

Description

get kubernetes versions list

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Responses

HTTP Code	Description	Schema
200	OK	KubernetesVersionListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/kubernetes-versions

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Example HTTP response

Response 200

{
    "kubernetes_versions": [
        {
            "description": "v1.29.8",
            "kubernetes_version": "v1.29.8"
        }
    ]
}

1.8 - List Nodepool Nodes

1.8.1 - 1.1

get /v1/nodepools/{nodepool_id}/nodes

Description

Get nodepool node list

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	node_name optional	노드 이름 Example : `ske-aug-rhel-0805-1-84d799f767-8dr2p`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	NodeListInNodepoolResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}/nodes

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/notices",
            "rel": "self"
        }
    ],
    "nodes": [
        {
            "account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "kubernetes_version": "v1.29.8",
            "name": "ske-aug-rhel-0805-1-84d799f767-8dr2p",
            "status": "RUNNING"
        }
    ]
}

1.8.2 - 1.0

get /v1/nodepools/{nodepool_id}/nodes

Description

Get nodepool node list

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	node_name optional	노드 이름 Example : `ske-aug-rhel-0805-1-84d799f767-8dr2p`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	NodeListInNodepoolResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}/nodes

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/notices",
            "rel": "self"
        }
    ],
    "nodes": [
        {
            "account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "kubernetes_version": "v1.29.8",
            "name": "ske-aug-rhel-0805-1-84d799f767-8dr2p",
            "status": "RUNNING"
        }
    ]
}

1.9 - List Nodepools

1.9.1 - 1.1

get /v1/clusters/{cluster_id}/nodepools

Description

get nodepools list

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	nodepool_name optional	노드풀 이름 Example : `sample-nodepool`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	NodepoolListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/nodepools

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/notices",
            "rel": "self"
        }
    ],
    "nodepools": [
        {
            "account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "auto_recovery_enabled": "",
            "auto_scale_enabled": "",
            "current_node_count": "1",
            "desired_node_count": "2",
            "id": "bdfda539-bd2e-4a5c-9021-ec6d52d1ca79",
            "image": {
                "custom_image_name": "custom-image",
                "os": "ubuntu",
                "os_version": "22.04"
            },
            "kubernetes_version": "v1.29.8",
            "name": "sample-nodepool",
            "server_type": {
                "description": "Standard",
                "id": "10a599e031e749b7b260868f441e862b"
            },
            "status": "Running",
            "volume_type": {
                "id": "10a599e031e749b7b260868f441e862b",
                "name": "SSD"
            }
        }
    ]
}

1.9.2 - 1.0

get /v1/clusters/{cluster_id}/nodepools

Description

get nodepools list

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	nodepool_name optional	노드풀 이름 Example : `sample-nodepool`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	NodepoolListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/nodepools

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/notices",
            "rel": "self"
        }
    ],
    "nodepools": [
        {
            "account_id": "617b3d0e90c24a5fa1f65a3824861354",
            "auto_recovery_enabled": "",
            "auto_scale_enabled": "",
            "current_node_count": "1",
            "desired_node_count": "2",
            "id": "bdfda539-bd2e-4a5c-9021-ec6d52d1ca79",
            "image": {
                "custom_image_name": "custom-image",
                "os": "ubuntu",
                "os_version": "22.04"
            },
            "kubernetes_version": "v1.29.8",
            "name": "sample-nodepool",
            "server_type": {
                "description": "Standard",
                "id": "10a599e031e749b7b260868f441e862b"
            },
            "status": "Running",
            "volume_type": {
                "id": "10a599e031e749b7b260868f441e862b",
                "name": "SSD"
            }
        }
    ]
}

1.10 - Set Cluster Logging

1.10.1 - 1.1

put /v1/clusters/{cluster_id}/logging

Description

Set logging on the cluster

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
body	body required		ClusterLoggingSetRequest

Responses

HTTP Code	Description	Schema
200	OK	ClusterSetResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/logging

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Request body

{
    "cloud_logging_enabled": "true"
}

Example HTTP response

Response 200

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.10.2 - 1.0

put /v1/clusters/{cluster_id}/logging

Description

Set logging on the cluster

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
body	body required		ClusterLoggingSetRequest

Responses

HTTP Code	Description	Schema
200	OK	ClusterSetResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/logging

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Request body

{
    "cloud_logging_enabled": "true"
}

Example HTTP response

Response 200

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.11 - Set Cluster Private Access Control

1.11.1 - 1.1

put /v1/clusters/{cluster_id}/private-access-control

Description

set a private access control specific cluster

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
body	body required		ClusterPrivateAccessControlSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	ClusterSetResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/private-access-control

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Request body

{
    "private_endpoint_access_control_resources": [
        {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name",
            "type": "vm"
        }
    ]
}

Example HTTP response

Response 202

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.11.2 - 1.0

put /v1/clusters/{cluster_id}/private-access-control

Description

set a private access control specific cluster

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
body	body required		ClusterPrivateAccessControlSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	ClusterSetResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/private-access-control

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Request body

{
    "private_endpoint_access_control_resources": [
        {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name",
            "type": "vm"
        }
    ]
}

Example HTTP response

Response 202

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.12 - Set Cluster Public Access Control

1.12.1 - 1.1

put /v1/clusters/{cluster_id}/public-access-control

Description

set a public access control specific cluster

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
body	body required		ClusterPublicAccessControlSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	ClusterSetResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/public-access-control

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Request body

{
    "public_endpoint_access_control_ip": "192.168.0.0"
}

Example HTTP response

Response 202

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.12.2 - 1.0

put /v1/clusters/{cluster_id}/public-access-control

Description

set a public access control specific cluster

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
body	body required		ClusterPublicAccessControlSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	ClusterSetResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/public-access-control

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Request body

{
    "public_endpoint_access_control_ip": "192.168.0.0"
}

Example HTTP response

Response 202

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.13 - Set Cluster Security Groups

1.13.1 - 1.1

put /v1/clusters/{cluster_id}/security-groups

Description

Set Cluster Security Groups

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
body	body required		ClusterSecurityGroupsSetRequest

Responses

HTTP Code	Description	Schema
200	OK	ClusterShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/security-groups

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Request body

{
    "security_group_id_list": "bdfda539-bd2e-4a5c-9021-ec6d52d1ca79"
}

Example HTTP response

Response 200

{
    "cluster": {
        "account_id": "617b3d0e90c24a5fa1f65a3824861354",
        "cloud_logging_enabled": "true",
        "cluster_namespace": "sample-cluster-12345",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "kubernetes_version": "v1.29.8",
        "managed_security_group": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        },
        "max_node_count": "5",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "name": "sample-cluster",
        "node_count": "5",
        "private_endpoint_access_control_resources": [
            {
                "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
                "name": "sample-name",
                "type": "vm"
            }
        ],
        "private_endpoint_url": "N",
        "private_kubeconfig_download_yn": "https://sample-cluster.ske.private.kr-west1.samsungsdscloud.com:6443",
        "public_endpoint_access_control_ip": "192.168.0.0",
        "public_endpoint_url": "https://sample-cluster.ske.kr-west1.samsungsdscloud.com:6443",
        "public_kubeconfig_download_yn": "N",
        "security_group_list": [
            {
                "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
                "name": "sample-name"
            }
        ],
        "status": "RUNNING",
        "subnet": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        },
        "volume": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        },
        "vpc": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        }
    }
}

1.13.2 - 1.0

put /v1/clusters/{cluster_id}/security-groups

Description

Set Cluster Security Groups

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
body	body required		ClusterSecurityGroupsSetRequest

Responses

HTTP Code	Description	Schema
200	OK	ClusterShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/security-groups

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Request body

{
    "security_group_id_list": "bdfda539-bd2e-4a5c-9021-ec6d52d1ca79"
}

Example HTTP response

Response 200

{
    "cluster": {
        "account_id": "617b3d0e90c24a5fa1f65a3824861354",
        "cloud_logging_enabled": "true",
        "cluster_namespace": "sample-cluster-12345",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "kubernetes_version": "v1.29.8",
        "managed_security_group": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        },
        "max_node_count": "5",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "name": "sample-cluster",
        "node_count": "5",
        "private_endpoint_access_control_resources": [
            {
                "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
                "name": "sample-name",
                "type": "vm"
            }
        ],
        "private_endpoint_url": "N",
        "private_kubeconfig_download_yn": "https://sample-cluster.ske.private.kr-west1.samsungsdscloud.com:6443",
        "public_endpoint_access_control_ip": "192.168.0.0",
        "public_endpoint_url": "https://sample-cluster.ske.kr-west1.samsungsdscloud.com:6443",
        "public_kubeconfig_download_yn": "N",
        "security_group_list": [
            {
                "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
                "name": "sample-name"
            }
        ],
        "status": "RUNNING",
        "subnet": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        },
        "volume": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        },
        "vpc": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        }
    }
}

1.14 - Set Cluster Service Watch Logging

1.14.1 - 1.1

put /v1/clusters/{cluster_id}/service-watch-logging

Description

Set Service Watch logging on the cluster

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
body	body required		ClusterServiceWatchLoggingSetRequest

Responses

HTTP Code	Description	Schema
200	OK	ClusterSetResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/service-watch-logging

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Request body

{
    "service_watch_logging_enabled": "true"
}

Example HTTP response

Response 200

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.15 - Set Cluster Upgrade

1.15.1 - 1.1

put /v1/clusters/{cluster_id}/upgrade

Description

upgrade a specific cluster

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
body	body required		ClusterUpgradeSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	ClusterSetResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/upgrade

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Request body

{
    "kubernetes_version": "v1.29.8"
}

Example HTTP response

Response 202

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.15.2 - 1.0

put /v1/clusters/{cluster_id}/upgrade

Description

upgrade a specific cluster

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
body	body required		ClusterUpgradeSetRequest

Responses

HTTP Code	Description	Schema
202	Accepted	ClusterSetResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/upgrade

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Request body

{
    "kubernetes_version": "v1.29.8"
}

Example HTTP response

Response 202

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.16 - Set Nodepool

1.16.1 - 1.1

put /v1/nodepools/{nodepool_id}

Description

set a nodepool

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None
body	body required		NodepoolUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Request body

{
    "desired_node_count": "2",
    "is_auto_recovery": "true",
    "is_auto_scale": "true",
    "max_node_count": "5",
    "min_node_count": "1"
}

Example HTTP response

Response 200

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.16.2 - 1.0

put /v1/nodepools/{nodepool_id}

Description

set a nodepool

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None
body	body required		NodepoolUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Request body

{
    "desired_node_count": "2",
    "is_auto_recovery": "true",
    "is_auto_scale": "true",
    "max_node_count": "5",
    "min_node_count": "1"
}

Example HTTP response

Response 200

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.17 - Set Nodepool Labels

1.17.1 - 1.1

put /v1/nodepools/{nodepool_id}/labels

Description

set nodepool labels

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None
body	body required		NodepoolLabelsSetRequest

Responses

HTTP Code	Description	Schema
200	OK	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}/labels

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Request body

{
    "labels": [
        {
            "key": "example.com/my-app",
            "value": "bar"
        }
    ]
}

Example HTTP response

Response 200

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.17.2 - 1.0

put /v1/nodepools/{nodepool_id}/labels

Description

set nodepool labels

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None
body	body required		NodepoolLabelsSetRequest

Responses

HTTP Code	Description	Schema
200	OK	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}/labels

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Request body

{
    "labels": [
        {
            "key": "example.com/my-app",
            "value": "bar"
        }
    ]
}

Example HTTP response

Response 200

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.18 - Set Nodepool Taints

1.18.1 - 1.1

put /v1/nodepools/{nodepool_id}/taints

Description

set nodepool taints

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None
body	body required		NodepoolTaintsSetRequest

Responses

HTTP Code	Description	Schema
200	OK	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}/taints

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Request body

{
    "taints": [
        {
            "effect": "NoSchedule",
            "key": "example.com/my-app",
            "value": "bar"
        }
    ]
}

Example HTTP response

Response 200

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.18.2 - 1.0

put /v1/nodepools/{nodepool_id}/taints

Description

set nodepool taints

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None
body	body required		NodepoolTaintsSetRequest

Responses

HTTP Code	Description	Schema
200	OK	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}/taints

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Request body

{
    "taints": [
        {
            "effect": "NoSchedule",
            "key": "example.com/my-app",
            "value": "bar"
        }
    ]
}

Example HTTP response

Response 200

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.19 - Set Nodepool Upgrade

1.19.1 - 1.1

put /v1/nodepools/{nodepool_id}/upgrade

Description

upgrade a nodepool

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None
body	body required		NodepoolUpgradeSetRequest

Responses

HTTP Code	Description	Schema
200	OK	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}/upgrade

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Request body

{
    "os_version": "22.04"
}

Example HTTP response

Response 200

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.19.2 - 1.0

put /v1/nodepools/{nodepool_id}/upgrade

Description

upgrade a nodepool

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None

Responses

HTTP Code	Description	Schema
200	OK	AsyncResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}/upgrade

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Example HTTP response

Response 200

{
    "account_id": "617b3d0e90c24a5fa1f65a3824861354",
    "request_id": "80a599e031e749b7b260868f441e862b",
    "resource_id": "70a599e031e749b7b260868f441e862b"
}

1.20 - Show Cluster

1.20.1 - 1.1

get /v1/clusters/{cluster_id}

Description

show a cluster

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ClusterShowResponseV1Dot1
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Example HTTP response

Response 200

{
    "cluster": {
        "account_id": "617b3d0e90c24a5fa1f65a3824861354",
        "cloud_logging_enabled": "true",
        "cluster_namespace": "sample-cluster-12345",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "kubernetes_version": "v1.29.8",
        "managed_security_group": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        },
        "max_node_count": "5",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "name": "sample-cluster",
        "node_count": "5",
        "private_endpoint_access_control_resources": [
            {
                "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
                "name": "sample-name",
                "type": "vm"
            }
        ],
        "private_endpoint_url": "N",
        "private_kubeconfig_download_yn": "https://sample-cluster.ske.private.kr-west1.samsungsdscloud.com:6443",
        "public_endpoint_access_control_ip": "192.168.0.0",
        "public_endpoint_url": "https://sample-cluster.ske.kr-west1.samsungsdscloud.com:6443",
        "public_kubeconfig_download_yn": "N",
        "security_group_list": [
            {
                "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
                "name": "sample-name"
            }
        ],
        "service_watch_logging_enabled": "true",
        "status": "RUNNING",
        "subnet": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        },
        "volume": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        },
        "vpc": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        }
    }
}

1.20.2 - 1.0

get /v1/clusters/{cluster_id}

Description

show a cluster

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None

Responses

HTTP Code	Description	Schema
200	OK	ClusterShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Example HTTP response

Response 200

{
    "cluster": {
        "account_id": "617b3d0e90c24a5fa1f65a3824861354",
        "cloud_logging_enabled": "true",
        "cluster_namespace": "sample-cluster-12345",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
        "kubernetes_version": "v1.29.8",
        "managed_security_group": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        },
        "max_node_count": "5",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "name": "sample-cluster",
        "node_count": "5",
        "private_endpoint_access_control_resources": [
            {
                "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
                "name": "sample-name",
                "type": "vm"
            }
        ],
        "private_endpoint_url": "N",
        "private_kubeconfig_download_yn": "https://sample-cluster.ske.private.kr-west1.samsungsdscloud.com:6443",
        "public_endpoint_access_control_ip": "192.168.0.0",
        "public_endpoint_url": "https://sample-cluster.ske.kr-west1.samsungsdscloud.com:6443",
        "public_kubeconfig_download_yn": "N",
        "security_group_list": [
            {
                "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
                "name": "sample-name"
            }
        ],
        "status": "RUNNING",
        "subnet": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        },
        "volume": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        },
        "vpc": {
            "id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f",
            "name": "sample-name"
        }
    }
}

1.21 - Show Cluster User Kubeconfig

1.21.1 - 1.1

get /v1/clusters/{cluster_id}/user-kubeconfig

Description

Show user kubeconfig for the cluster

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
query	kubeconfig_type required	Kubeconfig 타입 (private/public) Example : `private`	enum (private, public)	None

Responses

HTTP Code	Description	Schema
200	OK	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/user-kubeconfig?kubeconfig_type={kubeconfig_type}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Example HTTP response

Response 200

1.21.2 - 1.0

get /v1/clusters/{cluster_id}/user-kubeconfig

Description

Show user kubeconfig for the cluster

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string	None
query	kubeconfig_type required	Kubeconfig 타입 (private/public) Example : `private`	enum (private, public)	None

Responses

HTTP Code	Description	Schema
200	OK	None
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/clusters/{cluster_id}/user-kubeconfig?kubeconfig_type={kubeconfig_type}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Example HTTP response

Response 200

1.22 - Show Nodepool

1.22.1 - 1.1

get /v1/nodepools/{nodepool_id}

Description

show a nodepool

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None

Responses

HTTP Code	Description	Schema
200	OK	NodepoolShowResponseV1Dot1
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.1"

Example HTTP response

Response 200

{
    "nodepool": {
        "account_id": "617b3d0e90c24a5fa1f65a3824861354",
        "advanced_settings": {
            "allowed_unsafe_sysctls": "kernel.msg*,net.ipv4.route.min_pmtu",
            "container_log_max_files": "5",
            "container_log_max_size": "10",
            "image_gc_high_threshold": "85",
            "image_gc_low_threshold": "80",
            "max_pods": "110",
            "pod_max_pids": "4096"
        },
        "auto_recovery_enabled": "true",
        "auto_scale_enabled": "true",
        "cluster": {
            "id": "70a599e031e749b7b260868f441e862b"
        },
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "current_node_count": "1",
        "desired_node_count": "2",
        "id": "bdfda539-bd2e-4a5c-9021-ec6d52d1ca79",
        "image": {
            "custom_image_name": "custom-image",
            "os": "ubuntu",
            "os_version": "22.04"
        },
        "keypair": {
            "name": "test_keypair"
        },
        "kubernetes_version": "v1.29.8",
        "labels": [
            {
                "key": "example.com/my-app",
                "value": "bar"
            }
        ],
        "max_node_count": "5",
        "min_node_count": "1",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "name": "sample-nodepool",
        "server_group_id": "2b8d33d5-4de5-40a5-a34c-7e30204133xc",
        "server_type": {
            "description": "Standard",
            "id": "10a599e031e749b7b260868f441e862b"
        },
        "status": "Running",
        "taints": [
            {
                "effect": "NoSchedule",
                "key": "example.com/my-app",
                "value": "bar"
            }
        ],
        "volume_size": "104",
        "volume_type": {
            "encrypt": "true",
            "id": "10a599e031e749b7b260868f441e862b",
            "name": "SSD"
        }
    }
}

1.22.2 - 1.0

get /v1/nodepools/{nodepool_id}

Description

show a nodepool

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	nodepool_id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string	None

Responses

HTTP Code	Description	Schema
200	OK	NodepoolShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/nodepools/{nodepool_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = ske 1.0"

Example HTTP response

Response 200

{
    "nodepool": {
        "account_id": "617b3d0e90c24a5fa1f65a3824861354",
        "auto_recovery_enabled": "true",
        "auto_scale_enabled": "true",
        "cluster": {
            "id": "70a599e031e749b7b260868f441e862b"
        },
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "current_node_count": "1",
        "desired_node_count": "2",
        "id": "bdfda539-bd2e-4a5c-9021-ec6d52d1ca79",
        "image": {
            "custom_image_name": "custom-image",
            "os": "ubuntu",
            "os_version": "22.04"
        },
        "keypair": {
            "name": "test_keypair"
        },
        "kubernetes_version": "v1.29.8",
        "labels": [
            {
                "key": "example.com/my-app",
                "value": "bar"
            }
        ],
        "max_node_count": "5",
        "min_node_count": "1",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "name": "sample-nodepool",
        "server_type": {
            "description": "Standard",
            "id": "10a599e031e749b7b260868f441e862b"
        },
        "status": "Running",
        "taints": [
            {
                "effect": "NoSchedule",
                "key": "example.com/my-app",
                "value": "bar"
            }
        ],
        "volume_size": "104",
        "volume_type": {
            "encrypt": "true",
            "id": "10a599e031e749b7b260868f441e862b",
            "name": "SSD"
        }
    }
}

2 - Models

2.1 - AsyncResponse

Name	Description	Schema
account_id required	Account ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string
request_id required	요청 ID Example : `80a599e031e749b7b260868f441e862b`	string
resource_id required	자원 ID Example : `70a599e031e749b7b260868f441e862b`	string

2.2 - Cluster

Name	Description	Schema
account_id required	Account ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string
cloud_logging_enabled required	클라우드 로깅 사용 여부 Example : `true`	boolean
cluster_namespace required	클러스터 네임스페이스 Example : `sample-cluster-12345`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
kubernetes_version required	클러스터 버전 Example : `v1.29.8`	string
managed_security_group required	Managed Security Group	any of [ExternalResource, null]
max_node_count required	클러스터 최대 노드 수 Example : `5`	any of [integer, null]
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	클러스터 이름 Example : `sample-cluster`	string
node_count required	클러스터 노드 수 Example : `5`	any of [integer, null]
private_endpoint_access_control_resources required	Private Endpoint 접근 제어 리소스 목록	any of [array[PrivateEndpointAccessControlResource], null]
private_endpoint_url required	Private Kubeconfig Download Yn Example : `N`	string
private_kubeconfig_download_yn required	Cluster의 Private Endpoint URL Example : `https://sample-cluster.ske.private.kr-west1.samsungsdscloud.com:6443`	string
public_endpoint_access_control_ip required	Public Endpoint 접근 제어 IP Example : `192.168.0.0`	any of [string, null]
public_endpoint_url required	Public Endpoint 접근 제어 IP Example : `https://sample-cluster.ske.kr-west1.samsungsdscloud.com:6443`	any of [string, null]
public_kubeconfig_download_yn required	Public Kubeconfig Download Yn Example : `N`	string
security_group_list required	연결된 Security Group	array[ExternalResource]
status required	클러스터 상태 Example : `RUNNING`	string
subnet required	Cluster가 사용하는 Subnet	any of [ExternalResource, null]
volume required	연결된 File Storage	any of [ExternalResource, null]
vpc required	Cluster가 사용하는 VPC	any of [ExternalResource, null]

2.3 - ClusterCreateRequest

Name	Description	Schema
cloud_logging_enabled required	클라우드 로깅 사용 여부 Example : `true`	boolean
kubernetes_version required	클러스터 버전 Example : `v1.29.8` Pattern : `^v[0-9]{1}\.[0-9]{1,2}\.[0-9]{1,2}$`	string
name required	클러스터 이름 Example : `sample-cluster` Pattern : `^[a-z][a-z0-9\-][a-z0-9]$` Minimum length* : `3` Maximum length : `30`	string
private_endpoint_access_control_resources optional	Private Endpoint 접근 제어 리소스 목록	any of [array[PrivateEndpointAccessControlResource], null]
public_endpoint_access_control_ip optional	Public Endpoint 접근 제어 IP Example : `192.168.0.0`	any of [string, null]
security_group_id_list required	Security group ID 목록 Example : `['bdfda539-bd2e-4a5c-9021-ec6d52d1ca79']`	array[string]
subnet_id required	Subnet ID Example : `023c57b14f11483689338d085e061492`	string
tags optional	태그 목록	any of [array[Tag], null]
volume_id required	볼륨 ID Example : `['bfdbabf2-04d9-4e8b-a205-020f8e6da438']`	string
vpc_id required	VPC ID Example : `7df8abb4912e4709b1cb237daccca7a8`	string

2.4 - ClusterCreateRequestV1Dot1

Name	Description	Schema
cloud_logging_enabled required	클라우드 로깅 사용 여부 Example : `true`	boolean
kubernetes_version required	클러스터 버전 Example : `v1.29.8` Pattern : `^v[0-9]{1}\.[0-9]{1,2}\.[0-9]{1,2}$`	string
name required	클러스터 이름 Example : `sample-cluster` Pattern : `^[a-z][a-z0-9\-][a-z0-9]$` Minimum length* : `3` Maximum length : `30`	string
private_endpoint_access_control_resources optional	Private Endpoint 접근 제어 리소스 목록	any of [array[PrivateEndpointAccessControlResource], null]
public_endpoint_access_control_ip optional	Public Endpoint 접근 제어 IP Example : `192.168.0.0`	any of [string, null]
security_group_id_list required	Security group ID 목록 Example : `['bdfda539-bd2e-4a5c-9021-ec6d52d1ca79']`	array[string]
service_watch_logging_enabled required	Service Watch 사용 여부 Example : `true`	boolean
subnet_id required	Subnet ID Example : `023c57b14f11483689338d085e061492`	string
tags optional	태그 목록	any of [array[Tag], null]
volume_id required	볼륨 ID Example : `['bfdbabf2-04d9-4e8b-a205-020f8e6da438']`	string
vpc_id required	VPC ID Example : `7df8abb4912e4709b1cb237daccca7a8`	string

2.5 - ClusterListResponse

Name	Description	Schema
clusters required		array[ClusterSummary]
count optional	전체 개수 Example : `20`	any of [integer, null]
links optional	links Example : `[{'href': 'http://scp.samsungsdscloud.com/v1/notices', 'rel': 'self'}]`	any of [array[object], null]

2.6 - ClusterLoggingSetRequest

Name	Description	Schema	Default
cloud_logging_enabled required	클라우드 로깅 사용 여부 Example : `true`	boolean

2.7 - ClusterOfNodepool

Name	Description	Schema	Default
id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string

2.8 - ClusterPrivateAccessControlSetRequest

Name	Description	Schema	Default
private_endpoint_access_control_resources required		array[PrivateEndpointAccessControlResource]

2.9 - ClusterPublicAccessControlSetRequest

Name	Description	Schema	Default
public_endpoint_access_control_ip required	Public Endpoint 접근 제어 IP Example : `192.168.0.0`	string

2.10 - ClusterSecurityGroupsSetRequest

Name	Description	Schema	Default
security_group_id_list required	Security group ID 목록 Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	array[string]

2.11 - ClusterServiceWatchLoggingSetRequest

Name	Description	Schema	Default
service_watch_logging_enabled required	Service Watch 사용 여부 Example : `true`	boolean

2.12 - ClusterSetResponse

Name	Description	Schema
account_id required	Account ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string
request_id required	요청 ID Example : `80a599e031e749b7b260868f441e862b`	string
resource_id required	자원 ID Example : `70a599e031e749b7b260868f441e862b`	string

2.13 - ClusterShowResponse

Name	Description	Schema	Default
cluster required		Cluster

2.14 - ClusterShowResponseV1Dot1

Name	Description	Schema	Default
cluster required		ClusterV1Dot1

2.15 - ClusterSummary

Name	Description	Schema
account_id required	Account ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string
created_at required	생성 시간 Example : `2025-03-31T00:23:17Z`	string (date-time)
id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string
kubernetes_version required	클러스터 버전 Example : `v1.29.8`	string
modified_at required	수정 시간 Example : `2025-03-31T00:23:17Z`	string (date-time)
name required	클러스터 이름 Example : `sample-cluster`	string
node_count required	클러스터 노드 수 Example : `5`	any of [integer, null]
status required	클러스터 상태 Example : `RUNNING`	string
subnet_id required	클러스터 Subnet ID Example : `023c57b14f11483689338d085e061492`	any of [string, null]

2.16 - ClusterUpgradeSetRequest

Name	Description	Schema	Default
kubernetes_version required	쿠버네티스 버전 Example : `v1.29.8`	string

2.17 - ClusterV1Dot1

Name	Description	Schema
account_id required	Account ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string
cloud_logging_enabled required	클라우드 로깅 사용 여부 Example : `true`	boolean
cluster_namespace required	클러스터 네임스페이스 Example : `sample-cluster-12345`	string
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
kubernetes_version required	클러스터 버전 Example : `v1.29.8`	string
managed_security_group required	Managed Security Group	any of [ExternalResource, null]
max_node_count required	클러스터 최대 노드 수 Example : `5`	any of [integer, null]
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	클러스터 이름 Example : `sample-cluster`	string
node_count required	클러스터 노드 수 Example : `5`	any of [integer, null]
private_endpoint_access_control_resources required	Private Endpoint 접근 제어 리소스 목록	any of [array[PrivateEndpointAccessControlResource], null]
private_endpoint_url required	Private Kubeconfig Download Yn Example : `N`	string
private_kubeconfig_download_yn required	Cluster의 Private Endpoint URL Example : `https://sample-cluster.ske.private.kr-west1.samsungsdscloud.com:6443`	string
public_endpoint_access_control_ip required	Public Endpoint 접근 제어 IP Example : `192.168.0.0`	any of [string, null]
public_endpoint_url required	Public Endpoint 접근 제어 IP Example : `https://sample-cluster.ske.kr-west1.samsungsdscloud.com:6443`	any of [string, null]
public_kubeconfig_download_yn required	Public Kubeconfig Download Yn Example : `N`	string
security_group_list required	연결된 Security Group	array[ExternalResource]
service_watch_logging_enabled required	Service Watch 사용 여부 Example : `true`	boolean
status required	클러스터 상태 Example : `RUNNING`	string
subnet required	Cluster가 사용하는 Subnet	any of [ExternalResource, null]
volume required	연결된 File Storage	any of [ExternalResource, null]
vpc required	Cluster가 사용하는 VPC	any of [ExternalResource, null]

2.18 - ExternalResource

Name	Description	Schema	Default
id required	외부 자원 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string
name required	외부 자원 이름 Example : `sample-name`	string

2.19 - Image

Name	Description	Schema
custom_image_name required	커스텀 이미지 이름 Example : `custom-image`	any of [string, null]
os required	이미지 OS Example : `ubuntu`	string
os_version required	이미지 OS 버전 Example : `22.04`	string

2.20 - Keypair

Name	Description	Schema	Default
name required	키페어 이름 Example : `test_keypair`	string

2.21 - KubernetesVersionListResponse

Name	Description	Schema	Default
kubernetes_versions required		array[KubernetesVersionSummary]

2.22 - KubernetesVersionSummary

Name	Description	Schema	Default
description required	쿠버네티스 버전 Example : `v1.29.8`	any of [string, null]
kubernetes_version required	쿠버네티스 버전 Example : `v1.29.8`	string

2.23 - NodeInNodepool

Name	Description	Schema
account_id required	Account ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string
kubernetes_version required	쿠버네티스 버전 Example : `v1.29.8`	string
name required	노드 이름 Example : `ske-aug-rhel-0805-1-84d799f767-8dr2p`	string
status required	노드풀 상태 Example : `RUNNING`	string

2.24 - NodeListInNodepoolResponse

Name	Description	Schema
count optional	전체 개수 Example : `20`	any of [integer, null]
links optional	links Example : `[{'href': 'http://scp.samsungsdscloud.com/v1/notices', 'rel': 'self'}]`	any of [array[object], null]
nodes required	노드 풀의 노드 목록	any of [array[NodeInNodepool], null]

2.25 - Nodepool

Name	Description	Schema
account_id required	Account ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string
auto_recovery_enabled required	자동 복구 사용 여부 Example : `true`	boolean
auto_scale_enabled required	자동 확장 사용 여부 Example : `true`	boolean
cluster required	클러스터	ClusterOfNodepool
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
current_node_count required	현재 노드 수 Example : `1`	integer
desired_node_count required	요청 노드 수 Example : `2`	integer
id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string
image required	이미지	Image
keypair required	키페어 이름	Keypair
kubernetes_version required	쿠버네티스 버전 Example : `v1.29.8`	string
labels optional	노드풀 레이블 목록	any of [array[NodepoolLabel], null]
max_node_count required	최대 노드 수 Example : `5`	integer
min_node_count required	최소 노드 수 Example : `1`	integer
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	노드풀 이름 Example : `sample-nodepool`	string
server_type required	서버 타입	ServerType
status required	노드풀 상태 Example : `Running`	string
taints optional	노드풀 테인트 목록	any of [array[NodepoolTaint], null]
volume_size required	볼륨 크기 Example : `104`	integer
volume_type required	볼륨 타입	VolumeType

2.26 - NodepoolAdvancedSettings

Name	Description	Schema
allowed_unsafe_sysctls optional	unsafe sysctl 허용 Example : `kernel.msg*,net.ipv4.route.min_pmtu`	string
container_log_max_files required	컨테이너 로그 최대 파일 수 Example : `5` Minimum : `2` Maximum : `10`	integer
container_log_max_size required	컨테이너 로그 최대 사이즈 MB Example : `10` Minimum : `10` Maximum : `100`	integer
image_gc_high_threshold required	이미지 GC 상한 퍼센트 Example : `85` Minimum : `10` Maximum : `85`	integer
image_gc_low_threshold required	이미지 GC 하한 퍼센트 Example : `80` Minimum : `10` Maximum : `85`	integer
max_pods required	노드당 최대 파드 수 Example : `110` Minimum : `10` Maximum : `250`	integer
pod_max_pids required	파드 최대 PID 수 Example : `4096` Minimum : `1024` Maximum : `4194304`	integer

2.27 - NodepoolCreateRequest

Name	Description	Schema
cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string
custom_image_id optional	커스텀 이미지 ID Example : `10a599e031e749b7b260868f441e862b`	any of [string, null]
desired_node_count optional	요청 노드 수 (is_auto_scale = false 일 때 설정) Example : `2`	any of [integer, null]
image_os required	이미지 OS Example : `ubuntu`	string
image_os_version required	이미지 OS 버전 Example : `22.04`	string
is_auto_recovery required	자동 복구 사용 여부 Example : `true`	boolean
is_auto_scale required	자동 확장 사용 여부 Example : `true`	boolean
keypair_name required	키페어 이름 Example : `test_keypair`	string
kubernetes_version required	쿠버네티스 버전 Example : `v1.29.8`	string
labels optional	노드풀 레이블 목록	any of [array[NodepoolLabel], null]
max_node_count optional	최대 노드 수 (is_auto_scale = true 일 때 설정) Example : `5`	any of [integer, null]
min_node_count optional	최소 노드 수 (is_auto_scale = true 일 때 설정) Example : `1`	any of [integer, null]
name required	노드풀 이름 Example : `sample-nodepool` Pattern : `^[a-z][a-z0-9\-][a-z0-9]$` Minimum length* : `3` Maximum length : `20`	string
server_type_id required	서버 타입 ID Example : `10a599e031e749b7b260868f441e862b`	string
taints optional	노드풀 테인트 목록	any of [array[NodepoolTaint], null]
volume_size required	볼륨 크기 Example : `104`	integer
volume_type_name required	볼륨 타입 이름 Example : `SSD`	string

2.28 - NodepoolCreateRequestV1Dot1

Name	Description	Schema
advanced_settings optional	노드풀 고급 설정	any of [NodepoolAdvancedSettings, null]
cluster_id required	클러스터 ID Example : `70a599e031e749b7b260868f441e862b`	string
custom_image_id optional	커스텀 이미지 ID Example : `10a599e031e749b7b260868f441e862b`	any of [string, null]
desired_node_count optional	요청 노드 수 (is_auto_scale = false 일 때 설정) Example : `2`	any of [integer, null]
image_os required	이미지 OS Example : `ubuntu`	string
image_os_version required	이미지 OS 버전 Example : `22.04`	string
is_auto_recovery required	자동 복구 사용 여부 Example : `true`	boolean
is_auto_scale required	자동 확장 사용 여부 Example : `true`	boolean
keypair_name required	키페어 이름 Example : `test_keypair`	string
kubernetes_version required	쿠버네티스 버전 Example : `v1.29.8`	string
labels optional	노드풀 레이블 목록	any of [array[NodepoolLabel], null]
max_node_count optional	최대 노드 수 (is_auto_scale = true 일 때 설정) Example : `5`	any of [integer, null]
min_node_count optional	최소 노드 수 (is_auto_scale = true 일 때 설정) Example : `1`	any of [integer, null]
name required	노드풀 이름 Example : `sample-nodepool` Pattern : `^[a-z][a-z0-9\-][a-z0-9]$` Minimum length* : `3` Maximum length : `20`	string
server_group_id optional	서버 그룹 ID Example : `2b8d33d5-4de5-40a5-a34c-7e30204133xc`	any of [string, null]
server_type_id required	서버 타입 ID Example : `10a599e031e749b7b260868f441e862b`	string
taints optional	노드풀 테인트 목록	any of [array[NodepoolTaint], null]
volume_size required	볼륨 크기 Example : `104`	integer
volume_type_name required	볼륨 타입 이름 Example : `SSD`	string

2.29 - NodepoolLabel

Name	Description	Schema	Default
key required	노드풀 레이블 키 Example : `example.com/my-app` Pattern : `^([a-z0-9]([-a-z0-9][a-z0-9])?(\.[a-z0-9]([-a-z0-9][a-z0-9])?)/)?([A-Za-z0-9][-A-Za-z0-9_.])?[A-Za-z0-9]$`	string
value optional	노드풀 레이블 값 Example : `bar` Pattern : `^(([A-Za-z0-9][-A-Za-z0-9_.])?[A-Za-z0-9])?$` Maximum length* : `63`	string

2.30 - NodepoolLabelsSetRequest

Name	Description	Schema	Default
labels required		array[NodepoolLabel]

2.31 - NodepoolListResponse

Name	Description	Schema
count optional	전체 개수 Example : `20`	any of [integer, null]
links optional	links Example : `[{'href': 'http://scp.samsungsdscloud.com/v1/notices', 'rel': 'self'}]`	any of [array[object], null]
nodepools required	노드풀 목록	array[NodepoolSummary]

2.32 - NodepoolShowResponse

Name	Description	Schema	Default
nodepool required		Nodepool

2.33 - NodepoolShowResponseV1Dot1

Name	Description	Schema	Default
nodepool required		NodepoolV1Dot1

2.34 - NodepoolSummary

Name	Description	Schema
account_id required	Account ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string
auto_recovery_enabled required	자동 복구 사용 여부 Example :	boolean
auto_scale_enabled required	자동 확장 사용 여부 Example :	boolean
current_node_count required	현재 노드 수 Example : `1`	integer
desired_node_count required	요청 노드 수 Example : `2`	integer
id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string
image required	이미지	Image
kubernetes_version required	쿠버네티스 버전 Example : `v1.29.8`	string
name required	노드풀 이름 Example : `sample-nodepool`	string
server_type required	서버 타입	ServerType
status required	노드풀 상태 Example : `Running`	string
volume_type required	볼륨 타입	VolumeTypeSummary

2.35 - NodepoolTaint

Name	Description	Schema
effect required	노드풀 테인트 효과 Example : `NoSchedule`	enum (NoSchedule, NoExecute, PreferNoSchedule)
key required	노드풀 테인트 키 Example : `example.com/my-app` Pattern : `^([a-z0-9]([-a-z0-9][a-z0-9])?(\.[a-z0-9]([-a-z0-9][a-z0-9])?)/)?([A-Za-z0-9][-A-Za-z0-9_.])?[A-Za-z0-9]$`	string
value optional	노드풀 테인트 값 Example : `bar` Pattern : `^(([A-Za-z0-9][-A-Za-z0-9_.])?[A-Za-z0-9])?$` Maximum length* : `63`	string

2.36 - NodepoolTaintsSetRequest

Name	Description	Schema	Default
taints required		array[NodepoolTaint]

2.37 - NodepoolUpdateRequest

Name	Description	Schema
desired_node_count optional	요청 노드 수 Example : `2`	any of [integer, null]
is_auto_recovery optional	자동 복구 사용 여부 Example : `true`	any of [boolean, null]
is_auto_scale optional	자동 확장 사용 여부 Example : `true`	any of [boolean, null]
max_node_count optional	최대 노드 수 Example : `5`	any of [integer, null]
min_node_count optional	최소 노드 수 Example : `1`	any of [integer, null]

2.38 - NodepoolUpgradeSetRequest

Name	Description	Schema	Default
os_version required	이미지 OS 버전 Example : `22.04`	string

2.39 - NodepoolV1Dot1

Name	Description	Schema
account_id required	Account ID Example : `617b3d0e90c24a5fa1f65a3824861354`	string
advanced_settings optional	노드풀 고급 설정	any of [NodepoolAdvancedSettings, null]
auto_recovery_enabled required	자동 복구 사용 여부 Example : `true`	boolean
auto_scale_enabled required	자동 확장 사용 여부 Example : `true`	boolean
cluster required	클러스터	ClusterOfNodepool
created_at required	생성 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
current_node_count required	현재 노드 수 Example : `1`	integer
desired_node_count required	요청 노드 수 Example : `2`	integer
id required	노드풀 ID Example : `bdfda539-bd2e-4a5c-9021-ec6d52d1ca79`	string
image required	이미지	Image
keypair required	키페어 이름	Keypair
kubernetes_version required	쿠버네티스 버전 Example : `v1.29.8`	string
labels optional	노드풀 레이블 목록	any of [array[NodepoolLabel], null]
max_node_count required	최대 노드 수 Example : `5`	integer
min_node_count required	최소 노드 수 Example : `1`	integer
modified_at required	수정 시간 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name required	노드풀 이름 Example : `sample-nodepool`	string
server_group_id optional	서버 그룹 ID Example : `2b8d33d5-4de5-40a5-a34c-7e30204133xc`	any of [string, null]
server_type required	서버 타입	ServerType
status required	노드풀 상태 Example : `Running`	string
taints optional	노드풀 테인트 목록	any of [array[NodepoolTaint], null]
volume_size required	볼륨 크기 Example : `104`	integer
volume_type required	볼륨 타입	VolumeType

2.40 - PrivateEndpointAccessControlResource

Name	Description	Schema
id required	Private Endpoint 접근 제어 리소스 ID Example : `2a9be312-5d4b-4bc8-b2ae-35100fa9241f`	string
name required	Private Endpoint 접근 제어 리소스 이름 Example : `sample-name`	string
type required	Private Endpoint 접근 제어 리소스 타입 Example : `vm`	string

2.41 - ServerType

Name	Description	Schema	Default
description required	서버 타입 설명 Example : `Standard`	string
id required	서버 타입 ID Example : `10a599e031e749b7b260868f441e862b`	string

2.42 - Tag

Name	Description	Schema	Default
key required	태그 키 Example : `Key`	string
value required	태그 값 Example : `Value`	string

2.43 - VolumeType

Name	Description	Schema
encrypt required	볼륨 타입 암호화 Example : `true`	boolean
id required	볼륨 타입 ID Example : `10a599e031e749b7b260868f441e862b`	string
name required	볼륨 타입 이름 Example : `SSD`	string

2.44 - VolumeTypeSummary

Name	Description	Schema	Default
id required	볼륨 타입 ID Example : `10a599e031e749b7b260868f441e862b`	string
name required	볼륨 타입 이름 Example : `SSD`	string