1 - AsyncResponse

NameDescriptionSchemaDefault
account_id
required
Account ID
Example : 617b3d0e90c24a5fa1f65a3824861354
string
request_id
required
Request ID
Example : 80a599e031e749b7b260868f441e862b
string
resource_id
required
Resource ID
Example : 70a599e031e749b7b260868f441e862b
string

2 - Cluster

NameDescriptionSchemaDefault
account_id
required
Account ID
Example : 617b3d0e90c24a5fa1f65a3824861354
string
cloud_logging_enabled
required
Cloud Logging Enabled
Example : true
boolean
cluster_namespace
required
Cluster Namespace
Example : sample-cluster-12345
string
created_at
required
Created At
Example : 2024-05-17T00:23:17Z
string (date-time)
created_by
required
Created By
Example : 90dddfc2b1e04edba54ba2b41539a9ac
string
id
required
ID
Example : 0fdd87aab8cb46f59b7c1f81ed03fb3e
string
kubernetes_version
required
Cluster Version
Example : v1.29.8
string
managed_security_group
required
Managed Security Group
any of [ExternalResource, null]
max_node_count
required
Cluster Max Node Count
Example : 5
any of [integer, null]
modified_at
required
Modified At
Example : 2024-05-17T00:23:17Z
string (date-time)
modified_by
required
Modified By
Example : 90dddfc2b1e04edba54ba2b41539a9ac
string
name
required
Cluster Name
Example : sample-cluster
string
node_count
required
Cluster Node Count
Example : 5
any of [integer, null]
private_endpoint_access_control_resources
required
Private Endpoint Access Control Resources
any of [array[PrivateEndpointAccessControlResource], null]
private_endpoint_url
required
Private Kubeconfig Download Yn
Example : N
string
private_kubeconfig_download_yn
required
Private Endpoint URL
Example : https://sample-cluster.ske.private.kr-west1.samsungsdscloud.com:6443
string
public_endpoint_access_control_ip
required
Public Endpoint Access Control IP
Example : 192.168.0.0
any of [string, null]
public_endpoint_url
required
Public Endpoint URL
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
Connected Security Group List
array[ExternalResource]
status
required
Cluster Status
Example : RUNNING
string
subnet
required
Subnet of Cluster
any of [ExternalResource, null]
volume
required
Connected File Storage
any of [ExternalResource, null]
vpc
required
VPC of Cluster
any of [ExternalResource, null]

3 - ClusterCreateRequest

NameDescriptionSchemaDefault
cloud_logging_enabled
required
Cloud Logging Enabled
Example : true
boolean
kubernetes_version
required
Cluster Version
Example : v1.29.8
Pattern : ^v[0-9]{1}\.[0-9]{1,2}\.[0-9]{1,2}$
string
name
required
Cluster Name
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 Access Control Resources
any of [array[PrivateEndpointAccessControlResource], null]
public_endpoint_access_control_ip
optional
Public Endpoint Access Control IP
Example : 192.168.0.0
any of [string, null]
security_group_id_list
required
Security Group ID List
Example : ['bdfda539-bd2e-4a5c-9021-ec6d52d1ca79']
array[string]
subnet_id
required
Subnet ID
Example : 023c57b14f11483689338d085e061492
string
tags
optional
Tag list
any of [array[Tag], null]
volume_id
required
Volume ID
Example : ['bfdbabf2-04d9-4e8b-a205-020f8e6da438']
string
vpc_id
required
VPC ID
Example : 7df8abb4912e4709b1cb237daccca7a8
string

4 - ClusterCreateRequestV1Dot1

NameDescriptionSchemaDefault
cloud_logging_enabled
required
Cloud Logging Enabled
Example : true
boolean
kubernetes_version
required
Cluster Version
Example : v1.29.8
Pattern : ^v[0-9]{1}\.[0-9]{1,2}\.[0-9]{1,2}$
string
name
required
Cluster Name
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 Access Control Resources
any of [array[PrivateEndpointAccessControlResource], null]
public_endpoint_access_control_ip
optional
Public Endpoint Access Control IP
Example : 192.168.0.0
any of [string, null]
security_group_id_list
required
Security Group ID List
Example : ['bdfda539-bd2e-4a5c-9021-ec6d52d1ca79']
array[string]
service_watch_logging_enabled
required
Service Watch Enabled
Example : true
boolean
subnet_id
required
Subnet ID
Example : 023c57b14f11483689338d085e061492
string
tags
optional
Tag list
any of [array[Tag], null]
volume_id
required
Volume ID
Example : ['bfdbabf2-04d9-4e8b-a205-020f8e6da438']
string
vpc_id
required
VPC ID
Example : 7df8abb4912e4709b1cb237daccca7a8
string

5 - ClusterListResponse

NameDescriptionSchemaDefault
clusters
required

array[ClusterSummary]
count
optional
total count
Example : 20
any of [integer, null]
links
optional
links
Example : [{'href': 'http://scp.samsungsdscloud.com/v1/notices', 'rel': 'self'}]
any of [array[object], null]

6 - ClusterLoggingSetRequest

NameDescriptionSchemaDefault
cloud_logging_enabled
required
Cloud Logging Enabled
Example : true
boolean

7 - ClusterOfNodepool

NameDescriptionSchemaDefault
id
required
Cluster ID
Example : 70a599e031e749b7b260868f441e862b
string

8 - ClusterPrivateAccessControlSetRequest

NameDescriptionSchemaDefault
private_endpoint_access_control_resources
required

array[PrivateEndpointAccessControlResource]

9 - ClusterPublicAccessControlSetRequest

NameDescriptionSchemaDefault
public_endpoint_access_control_ip
required
Public Endpoint Access Control IP
Example : 192.168.0.0
string

10 - ClusterSecurityGroupsSetRequest

NameDescriptionSchemaDefault
security_group_id_list
required
Security Group ID List
Example : bdfda539-bd2e-4a5c-9021-ec6d52d1ca79
array[string]

11 - ClusterServiceWatchLoggingSetRequest

NameDescriptionSchemaDefault
service_watch_logging_enabled
required
Service Watch Enabled
Example : true
boolean

12 - ClusterSetResponse

NameDescriptionSchemaDefault
account_id
required
Account ID
Example : 617b3d0e90c24a5fa1f65a3824861354
string
request_id
required
Request ID
Example : 80a599e031e749b7b260868f441e862b
string
resource_id
required
Resource ID
Example : 70a599e031e749b7b260868f441e862b
string

13 - ClusterShowResponse

NameDescriptionSchemaDefault
cluster
required

Cluster

14 - ClusterShowResponseV1Dot1

NameDescriptionSchemaDefault
cluster
required

ClusterV1Dot1

15 - ClusterSummary

NameDescriptionSchemaDefault
account_id
required
Account ID
Example : 617b3d0e90c24a5fa1f65a3824861354
string
created_at
required
Created At
Example : 2025-03-31T00:23:17Z
string (date-time)
id
required
Cluster ID
Example : 70a599e031e749b7b260868f441e862b
string
kubernetes_version
required
Cluster Version
Example : v1.29.8
string
modified_at
required
Modified At
Example : 2025-03-31T00:23:17Z
string (date-time)
name
required
Cluster Name
Example : sample-cluster
string
node_count
required
Cluster Node Count
Example : 5
any of [integer, null]
status
required
Cluster Status
Example : RUNNING
string
subnet_id
required
Cluster Subnet ID
Example : 023c57b14f11483689338d085e061492
any of [string, null]

16 - ClusterUpgradeSetRequest

NameDescriptionSchemaDefault
kubernetes_version
required
Kubernetes Version
Example : v1.29.8
string

17 - ClusterV1Dot1

NameDescriptionSchemaDefault
account_id
required
Account ID
Example : 617b3d0e90c24a5fa1f65a3824861354
string
cloud_logging_enabled
required
Cloud Logging Enabled
Example : true
boolean
cluster_namespace
required
Cluster Namespace
Example : sample-cluster-12345
string
created_at
required
Created At
Example : 2024-05-17T00:23:17Z
string (date-time)
created_by
required
Created By
Example : 90dddfc2b1e04edba54ba2b41539a9ac
string
id
required
ID
Example : 0fdd87aab8cb46f59b7c1f81ed03fb3e
string
kubernetes_version
required
Cluster Version
Example : v1.29.8
string
managed_security_group
required
Managed Security Group
any of [ExternalResource, null]
max_node_count
required
Cluster Max Node Count
Example : 5
any of [integer, null]
modified_at
required
Modified At
Example : 2024-05-17T00:23:17Z
string (date-time)
modified_by
required
Modified By
Example : 90dddfc2b1e04edba54ba2b41539a9ac
string
name
required
Cluster Name
Example : sample-cluster
string
node_count
required
Cluster Node Count
Example : 5
any of [integer, null]
private_endpoint_access_control_resources
required
Private Endpoint Access Control Resources
any of [array[PrivateEndpointAccessControlResource], null]
private_endpoint_url
required
Private Kubeconfig Download Yn
Example : N
string
private_kubeconfig_download_yn
required
Private Endpoint URL
Example : https://sample-cluster.ske.private.kr-west1.samsungsdscloud.com:6443
string
public_endpoint_access_control_ip
required
Public Endpoint Access Control IP
Example : 192.168.0.0
any of [string, null]
public_endpoint_url
required
Public Endpoint URL
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
Connected Security Group List
array[ExternalResource]
service_watch_logging_enabled
required
Service Watch Enabled
Example : true
boolean
status
required
Cluster Status
Example : RUNNING
string
subnet
required
Subnet of Cluster
any of [ExternalResource, null]
volume
required
Connected File Storage
any of [ExternalResource, null]
vpc
required
VPC of Cluster
any of [ExternalResource, null]

18 - ExternalResource

NameDescriptionSchemaDefault
id
required
External Resource ID
Example : 2a9be312-5d4b-4bc8-b2ae-35100fa9241f
string
name
required
External Resource name
Example : sample-name
string

19 - Image

NameDescriptionSchemaDefault
custom_image_name
required
Custom Image Name
Example : custom-image
any of [string, null]
os
required
Image OS
Example : ubuntu
string
os_version
required
Image OS Version
Example : 22.04
string

20 - Keypair

NameDescriptionSchemaDefault
name
required
Keypair Name
Example : test_keypair
string

21 - KubernetesVersionListResponse

NameDescriptionSchemaDefault
kubernetes_versions
required

array[KubernetesVersionSummary]

22 - KubernetesVersionSummary

NameDescriptionSchemaDefault
description
required
Kubernetes Version
Example : v1.29.8
any of [string, null]
kubernetes_version
required
Kubernetes Version
Example : v1.29.8
string

23 - NodeInNodepool

NameDescriptionSchemaDefault
account_id
required
Account ID
Example : 617b3d0e90c24a5fa1f65a3824861354
string
kubernetes_version
required
Kubernetes Version
Example : v1.29.8
string
name
required
Node Name
Example : ske-aug-rhel-0805-1-84d799f767-8dr2p
string
status
required
Node Status
Example : RUNNING
string

24 - NodeListInNodepoolResponse

NameDescriptionSchemaDefault
count
optional
total count
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
Node List in Node Pool
any of [array[NodeInNodepool], null]

25 - Nodepool

NameDescriptionSchemaDefault
account_id
required
Account ID
Example : 617b3d0e90c24a5fa1f65a3824861354
string
auto_recovery_enabled
required
Is Auto Recovery
Example : true
boolean
auto_scale_enabled
required
Is Auto Scale
Example : true
boolean
cluster
required
Cluster
ClusterOfNodepool
created_at
required
Created At
Example : 2024-05-17T00:23:17Z
string (date-time)
created_by
required
Created By
Example : 90dddfc2b1e04edba54ba2b41539a9ac
string
current_node_count
required
Current Node Count
Example : 1
integer
desired_node_count
required
Desired Node Count
Example : 2
integer
id
required
Nodepool ID
Example : bdfda539-bd2e-4a5c-9021-ec6d52d1ca79
string
image
required
Image
Image
keypair
required
Keypair Name
Keypair
kubernetes_version
required
Kubernetes Version
Example : v1.29.8
string
labels
optional
Node Pool Labels
any of [array[NodepoolLabel], null]
max_node_count
required
Max Node Count
Example : 5
integer
min_node_count
required
Min Node Count
Example : 1
integer
modified_at
required
Modified At
Example : 2024-05-17T00:23:17Z
string (date-time)
modified_by
required
Modified By
Example : 90dddfc2b1e04edba54ba2b41539a9ac
string
name
required
Nodepool Name
Example : sample-nodepool
string
server_type
required
Server Type
ServerType
status
required
Node Pool Status
Example : Running
string
taints
optional
Node Pool Taints
any of [array[NodepoolTaint], null]
volume_size
required
Volume Size
Example : 104
integer
volume_type
required
Volume Type
VolumeType

26 - NodepoolAdvancedSettings

NameDescriptionSchemaDefault
allowed_unsafe_sysctls
optional
Node Pool Allowed unsafe sysctls
Example : kernel.msg*,net.ipv4.route.min_pmtu
string
container_log_max_files
required
Node Pool container log max files
Example : 5
Minimum : 2
Maximum : 10
integer
container_log_max_size
required
Node Pool container log max size
Example : 10
Minimum : 10
Maximum : 100
integer
image_gc_high_threshold
required
Node Pool image GC high threshold percent
Example : 85
Minimum : 10
Maximum : 85
integer
image_gc_low_threshold
required
Node Pool image GC low threshold percent
Example : 80
Minimum : 10
Maximum : 85
integer
max_pods
required
Node Pool max pod number
Example : 110
Minimum : 10
Maximum : 250
integer
pod_max_pids
required
Node Pool Pod Max pids constraint
Example : 4096
Minimum : 1024
Maximum : 4194304
integer

27 - NodepoolCreateRequest

NameDescriptionSchemaDefault
cluster_id
required
Cluster ID
Example : 70a599e031e749b7b260868f441e862b
string
custom_image_id
optional
Custom Image ID
Example : 10a599e031e749b7b260868f441e862b
any of [string, null]
desired_node_count
optional
Desired node count (is_auto_scale = false)
Example : 2
any of [integer, null]
image_os
required
Image OS
Example : ubuntu
string
image_os_version
required
Image OS Version
Example : 22.04
string
is_auto_recovery
required
Is Auto Recovery
Example : true
boolean
is_auto_scale
required
Is Auto Scale
Example : true
boolean
keypair_name
required
Keypair Name
Example : test_keypair
string
kubernetes_version
required
Kubernetes Version
Example : v1.29.8
string
labels
optional
Node Pool Labels
any of [array[NodepoolLabel], null]
max_node_count
optional
Maximum node count (is_auto_scale = true)
Example : 5
any of [integer, null]
min_node_count
optional
Minimum node count (is_auto_scale = true)
Example : 1
any of [integer, null]
name
required
Nodepool Name
Example : sample-nodepool
Pattern : ^[a-z][a-z0-9\-]*[a-z0-9]$
Minimum length : 3
Maximum length : 20
string
server_type_id
required
Server Type ID
Example : 10a599e031e749b7b260868f441e862b
string
taints
optional
Node Pool Taints
any of [array[NodepoolTaint], null]
volume_size
required
Volume Size
Example : 104
integer
volume_type_name
required
Volume Type Name
Example : SSD
string

28 - NodepoolCreateRequestV1Dot1

NameDescriptionSchemaDefault
advanced_settings
optional
Node Pool Advanced Settings
any of [NodepoolAdvancedSettings, null]
cluster_id
required
Cluster ID
Example : 70a599e031e749b7b260868f441e862b
string
custom_image_id
optional
Custom Image ID
Example : 10a599e031e749b7b260868f441e862b
any of [string, null]
desired_node_count
optional
Desired node count (is_auto_scale = false)
Example : 2
any of [integer, null]
image_os
required
Image OS
Example : ubuntu
string
image_os_version
required
Image OS Version
Example : 22.04
string
is_auto_recovery
required
Is Auto Recovery
Example : true
boolean
is_auto_scale
required
Is Auto Scale
Example : true
boolean
keypair_name
required
Keypair Name
Example : test_keypair
string
kubernetes_version
required
Kubernetes Version
Example : v1.29.8
string
labels
optional
Node Pool Labels
any of [array[NodepoolLabel], null]
max_node_count
optional
Maximum node count (is_auto_scale = true)
Example : 5
any of [integer, null]
min_node_count
optional
Minimum node count (is_auto_scale = true)
Example : 1
any of [integer, null]
name
required
Nodepool Name
Example : sample-nodepool
Pattern : ^[a-z][a-z0-9\-]*[a-z0-9]$
Minimum length : 3
Maximum length : 20
string
server_group_id
optional
Server Group ID
Example : 2b8d33d5-4de5-40a5-a34c-7e30204133xc
any of [string, null]
server_type_id
required
Server Type ID
Example : 10a599e031e749b7b260868f441e862b
string
taints
optional
Node Pool Taints
any of [array[NodepoolTaint], null]
volume_size
required
Volume Size
Example : 104
integer
volume_type_name
required
Volume Type Name
Example : SSD
string

29 - NodepoolLabel

NameDescriptionSchemaDefault
key
required
Node Pool Label Key
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
Node Pool Label Value
Example : bar
Pattern : ^(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])?$
Maximum length : 63
string

30 - NodepoolLabelsSetRequest

NameDescriptionSchemaDefault
labels
required

array[NodepoolLabel]

31 - NodepoolListResponse

NameDescriptionSchemaDefault
count
optional
total count
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
Node Pool List
array[NodepoolSummary]

32 - NodepoolShowResponse

NameDescriptionSchemaDefault
nodepool
required

Nodepool

33 - NodepoolShowResponseV1Dot1

NameDescriptionSchemaDefault
nodepool
required

NodepoolV1Dot1

34 - NodepoolSummary

NameDescriptionSchemaDefault
account_id
required
Account ID
Example : 617b3d0e90c24a5fa1f65a3824861354
string
auto_recovery_enabled
required
Is Auto Recovery
Example :
boolean
auto_scale_enabled
required
Is Auto Scale
Example :
boolean
current_node_count
required
Current Node Count
Example : 1
integer
desired_node_count
required
Desired Node Count
Example : 2
integer
id
required
Nodepool ID
Example : bdfda539-bd2e-4a5c-9021-ec6d52d1ca79
string
image
required
Image
Image
kubernetes_version
required
Kubernetes Version
Example : v1.29.8
string
name
required
Nodepool Name
Example : sample-nodepool
string
server_type
required
Server Type
ServerType
status
required
Node Pool Status
Example : Running
string
volume_type
required
Volume Type
VolumeTypeSummary

35 - NodepoolTaint

NameDescriptionSchemaDefault
effect
required
Node Pool Taint Effect
Example : NoSchedule
enum (NoSchedule, NoExecute, PreferNoSchedule)
key
required
Node Pool Taint Key
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
Node Pool Taint Value
Example : bar
Pattern : ^(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])?$
Maximum length : 63
string

36 - NodepoolTaintsSetRequest

NameDescriptionSchemaDefault
taints
required

array[NodepoolTaint]

37 - NodepoolUpdateRequest

NameDescriptionSchemaDefault
desired_node_count
optional
Desired Node Count
Example : 2
any of [integer, null]
is_auto_recovery
optional
Is Auto Recovery
Example : true
any of [boolean, null]
is_auto_scale
optional
Is Auto Scale
Example : true
any of [boolean, null]
max_node_count
optional
Max Node Count
Example : 5
any of [integer, null]
min_node_count
optional
Min Node Count
Example : 1
any of [integer, null]

38 - NodepoolUpgradeSetRequest

NameDescriptionSchemaDefault
os_version
required
Image OS Version
Example : 22.04
string

39 - NodepoolV1Dot1

NameDescriptionSchemaDefault
account_id
required
Account ID
Example : 617b3d0e90c24a5fa1f65a3824861354
string
advanced_settings
optional
Node Pool Advanced Settings
any of [NodepoolAdvancedSettings, null]
auto_recovery_enabled
required
Is Auto Recovery
Example : true
boolean
auto_scale_enabled
required
Is Auto Scale
Example : true
boolean
cluster
required
Cluster
ClusterOfNodepool
created_at
required
Created At
Example : 2024-05-17T00:23:17Z
string (date-time)
created_by
required
Created By
Example : 90dddfc2b1e04edba54ba2b41539a9ac
string
current_node_count
required
Current Node Count
Example : 1
integer
desired_node_count
required
Desired Node Count
Example : 2
integer
id
required
Nodepool ID
Example : bdfda539-bd2e-4a5c-9021-ec6d52d1ca79
string
image
required
Image
Image
keypair
required
Keypair Name
Keypair
kubernetes_version
required
Kubernetes Version
Example : v1.29.8
string
labels
optional
Node Pool Labels
any of [array[NodepoolLabel], null]
max_node_count
required
Max Node Count
Example : 5
integer
min_node_count
required
Min Node Count
Example : 1
integer
modified_at
required
Modified At
Example : 2024-05-17T00:23:17Z
string (date-time)
modified_by
required
Modified By
Example : 90dddfc2b1e04edba54ba2b41539a9ac
string
name
required
Nodepool Name
Example : sample-nodepool
string
server_group_id
optional
Server Group ID
Example : 2b8d33d5-4de5-40a5-a34c-7e30204133xc
any of [string, null]
server_type
required
Server Type
ServerType
status
required
Node Pool Status
Example : Running
string
taints
optional
Node Pool Taints
any of [array[NodepoolTaint], null]
volume_size
required
Volume Size
Example : 104
integer
volume_type
required
Volume Type
VolumeType

40 - PrivateEndpointAccessControlResource

NameDescriptionSchemaDefault
id
required
Private Endpoint Access Control Resource ID
Example : 2a9be312-5d4b-4bc8-b2ae-35100fa9241f
string
name
required
Private Endpoint Access Control Resource Name
Example : sample-name
string
type
required
Private Endpoint Access Control Resource Type
Example : vm
string

41 - ServerType

NameDescriptionSchemaDefault
description
required
Server Type Description
Example : Standard
string
id
required
Server Type ID
Example : 10a599e031e749b7b260868f441e862b
string

42 - Tag

NameDescriptionSchemaDefault
key
required
Tag Key
Example : Key
string
value
required
Tag Value
Example : Value
string

43 - VolumeType

NameDescriptionSchemaDefault
encrypt
required
Volume Type Encrypt
Example : true
boolean
id
required
Volume Type ID
Example : 10a599e031e749b7b260868f441e862b
string
name
required
Volume Type Name
Example : SSD
string

44 - VolumeTypeSummary

NameDescriptionSchemaDefault
id
required
Volume Type ID
Example : 10a599e031e749b7b260868f441e862b
string
name
required
Volume Type Name
Example : SSD
string