Overview
SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 명령 줄 인터페이스(Command-line interface, CLI)를 제공합니다.
본 가이드는 Kubernetes 서비스에 대한 간략한 설명 및 CLI를 호출하는 방법을 제공합니다.
Version
| Version | Status | Supported Until |
|---|---|---|
| 1.0 | DEPRECATED | 20251231 |
| 1.1 | CURRENT | - |
이 섹션의 다중 페이지 출력 화면임. 여기를 클릭하여 프린트.
Kubernetes
- 1: CLIs
- 1.1: Create Cluster
- 1.2: Create Cluster Kubeconfig
- 1.3: Create Nodepool
- 1.4: Delete Cluster
- 1.5: Delete Nodepool
- 1.6: List Clusters
- 1.7: List Nodepool Nodes
- 1.8: List Nodepools
- 1.9: Set Cluster Logging
- 1.10: Set Cluster Private Access Control
- 1.11: Set Cluster Public Access Control
- 1.12: Set Cluster Security Groups
- 1.13: Set Cluster Service Watch Logging
- 1.13.1: 1.1
- 1.14: Set Cluster Upgrade
- 1.15: Set Nodepool
- 1.16: Set Nodepool Labels
- 1.17: Set Nodepool Taints
- 1.18: Set Nodepool Upgrade
- 1.19: Show Cluster
- 1.20: Show Cluster User Kubeconfig
- 1.21: Show Nodepool
1 - CLIs
1.1 - Create Cluster
1.1.1 - 1.1
scpcli ske cluster create
--vpc_id <value>
--volume_id <value>
--subnet_id <value>
--service_watch_logging_enabled <value>
--security_group_id_list <value>
--name <value>
--kubernetes_version <value>
--cloud_logging_enabled <value>
[--private_endpoint_access_control_resources <value>]
[--public_endpoint_access_control_ip <value>]
[--tags <value>]
Description
create a cluster V1.1
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| vpc_id required | string | VPC ID | 7df8abb4912e4709b1cb237daccca7a8 |
| volume_id required | string | 볼륨 ID | ['bfdbabf2-04d9-4e8b-a205-020f8e6da438'] |
| subnet_id required | string | Subnet ID | 023c57b14f11483689338d085e061492 |
| service_watch_logging_enabled required | boolean | Service Watch 사용 여부 | true |
| security_group_id_list required | array | Security group ID 목록 | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| name required | string | 클러스터 이름 | sample-cluster |
| kubernetes_version required | string | 클러스터 버전 | v1.29.8 |
| cloud_logging_enabled required | boolean | 클라우드 로깅 사용 여부 | true |
| private_endpoint_access_control_resources optional | array | Private Endpoint 접근 제어 리소스 목록 | '{"id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f", "name": "sample-name", "type": "vm"}' |
| public_endpoint_access_control_ip optional | string | Public Endpoint 접근 제어 IP | 192.168.0.0 |
| tags optional | array | 태그 목록 | '{"key": "Key", "value": "Value"}' |
Responses
| Name | Description | Example |
|---|---|---|
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| request_id | 요청 ID | 80a599e031e749b7b260868f441e862b |
| resource_id | 자원 ID | 70a599e031e749b7b260868f441e862b |
1.1.2 - 1.0
scpcli ske cluster create
--vpc_id <value>
--volume_id <value>
--subnet_id <value>
--security_group_id_list <value>
--name <value>
--kubernetes_version <value>
--cloud_logging_enabled <value>
[--private_endpoint_access_control_resources <value>]
[--public_endpoint_access_control_ip <value>]
[--tags <value>]
Description
create a cluster
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| vpc_id required | string | VPC ID | 7df8abb4912e4709b1cb237daccca7a8 |
| volume_id required | string | 볼륨 ID | ['bfdbabf2-04d9-4e8b-a205-020f8e6da438'] |
| subnet_id required | string | Subnet ID | 023c57b14f11483689338d085e061492 |
| security_group_id_list required | array | Security group ID 목록 | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| name required | string | 클러스터 이름 | sample-cluster |
| kubernetes_version required | string | 클러스터 버전 | v1.29.8 |
| cloud_logging_enabled required | boolean | 클라우드 로깅 사용 여부 | true |
| private_endpoint_access_control_resources optional | array | Private Endpoint 접근 제어 리소스 목록 | '{"id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f", "name": "sample-name", "type": "vm"}' |
| public_endpoint_access_control_ip optional | string | Public Endpoint 접근 제어 IP | 192.168.0.0 |
| tags optional | array | 태그 목록 | '{"key": "Key", "value": "Value"}' |
Responses
| Name | Description | Example |
|---|---|---|
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| request_id | 요청 ID | 80a599e031e749b7b260868f441e862b |
| resource_id | 자원 ID | 70a599e031e749b7b260868f441e862b |
1.2 - Create Cluster Kubeconfig
1.2.1 - 1.1
scpcli ske cluster kubeconfig create
--cluster_id <value>
--kubeconfig_type <value>
Description
Create kubeconfig file for the cluster
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| kubeconfig_type required | **** | Kubeconfig 타입 (private/public) | private |
Responses
| Name | Description | Example |
|---|
1.2.2 - 1.0
scpcli ske cluster kubeconfig create
--cluster_id <value>
--kubeconfig_type <value>
Description
Create kubeconfig file for the cluster
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| kubeconfig_type required | **** | Kubeconfig 타입 (private/public) | private |
Responses
| Name | Description | Example |
|---|
1.3 - Create Nodepool
1.3.1 - 1.1
scpcli ske nodepool create
--pod_max_pids <value>
--max_pods <value>
--image_gc_low_threshold <value>
--image_gc_high_threshold <value>
--container_log_max_size <value>
--container_log_max_files <value>
--volume_type_name <value>
--volume_size <value>
--server_type_id <value>
--name <value>
--kubernetes_version <value>
--keypair_name <value>
--is_auto_scale <value>
--is_auto_recovery <value>
--image_os_version <value>
--image_os <value>
--cluster_id <value>
[--custom_image_id <value>]
[--desired_node_count <value>]
[--labels <value>]
[--max_node_count <value>]
[--min_node_count <value>]
[--server_group_id <value>]
[--taints <value>]
[--allowed_unsafe_sysctls <value>]
Description
create a nodepool V1.1
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| pod_max_pids required | integer | 파드 최대 PID 수 | 4096 |
| max_pods required | integer | 노드당 최대 파드 수 | 110 |
| image_gc_low_threshold required | integer | 이미지 GC 하한 퍼센트 | 80 |
| image_gc_high_threshold required | integer | 이미지 GC 상한 퍼센트 | 85 |
| container_log_max_size required | integer | 컨테이너 로그 최대 사이즈 MB | 10 |
| container_log_max_files required | integer | 컨테이너 로그 최대 파일 수 | 5 |
| volume_type_name required | string | 볼륨 타입 이름 | SSD |
| volume_size required | integer | 볼륨 크기 | 104 |
| server_type_id required | string | 서버 타입 ID | 10a599e031e749b7b260868f441e862b |
| name required | string | 노드풀 이름 | sample-nodepool |
| kubernetes_version required | string | 쿠버네티스 버전 | v1.29.8 |
| keypair_name required | string | 키페어 이름 | test_keypair |
| is_auto_scale required | boolean | 자동 확장 사용 여부 | true |
| is_auto_recovery required | boolean | 자동 복구 사용 여부 | true |
| image_os_version required | string | 이미지 OS 버전 | 22.04 |
| image_os required | string | 이미지 OS | ubuntu |
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| custom_image_id optional | string | 커스텀 이미지 ID | 10a599e031e749b7b260868f441e862b |
| desired_node_count optional | integer | Desired node count (is_auto_scale = false) | 2 |
| labels optional | array | 노드풀 레이블 목록 | '{"key": "example.com/my-app", "value": "bar"}' |
| max_node_count optional | integer | Maximum node count (is_auto_scale = true) | 5 |
| min_node_count optional | integer | Minimum node count (is_auto_scale = true) | 1 |
| server_group_id optional | string | 서버 그룹 ID | 2b8d33d5-4de5-40a5-a34c-7e30204133xc |
| taints optional | array | 노드풀 테인트 목록 | '{"effect": "NoSchedule", "key": "example.com/my-app", "value": "bar"}' |
| allowed_unsafe_sysctls optional | string | unsafe sysctl 허용 | kernel.msg*,net.ipv4.route.min_pmtu |
Responses
| Name | Description | Example |
|---|---|---|
| id | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| advanced_settings | 노드풀 고급 설정 | |
| auto_recovery_enabled | 자동 복구 사용 여부 | true |
| auto_scale_enabled | 자동 확장 사용 여부 | true |
| cluster | 클러스터 | |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| current_node_count | 현재 노드 수 | 1 |
| desired_node_count | 요청 노드 수 | 2 |
| image | 이미지 | |
| keypair | 키페어 이름 | |
| kubernetes_version | 쿠버네티스 버전 | v1.29.8 |
| labels | 노드풀 레이블 목록 | |
| max_node_count | 최대 노드 수 | 5 |
| min_node_count | 최소 노드 수 | 1 |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | 노드풀 이름 | sample-nodepool |
| server_group_id | 서버 그룹 ID | 2b8d33d5-4de5-40a5-a34c-7e30204133xc |
| server_type | 서버 타입 | |
| status | 노드풀 상태 | Running |
| taints | 노드풀 테인트 목록 | |
| volume_size | 볼륨 크기 | 104 |
| volume_type | 볼륨 타입 |
1.3.2 - 1.0
scpcli ske nodepool create
--volume_type_name <value>
--volume_size <value>
--server_type_id <value>
--name <value>
--kubernetes_version <value>
--keypair_name <value>
--is_auto_scale <value>
--is_auto_recovery <value>
--image_os_version <value>
--image_os <value>
--cluster_id <value>
[--custom_image_id <value>]
[--desired_node_count <value>]
[--labels <value>]
[--max_node_count <value>]
[--min_node_count <value>]
[--taints <value>]
Description
create a nodepool
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| volume_type_name required | string | 볼륨 타입 이름 | SSD |
| volume_size required | integer | 볼륨 크기 | 104 |
| server_type_id required | string | 서버 타입 ID | 10a599e031e749b7b260868f441e862b |
| name required | string | 노드풀 이름 | sample-nodepool |
| kubernetes_version required | string | 쿠버네티스 버전 | v1.29.8 |
| keypair_name required | string | 키페어 이름 | test_keypair |
| is_auto_scale required | boolean | 자동 확장 사용 여부 | true |
| is_auto_recovery required | boolean | 자동 복구 사용 여부 | true |
| image_os_version required | string | 이미지 OS 버전 | 22.04 |
| image_os required | string | 이미지 OS | ubuntu |
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| custom_image_id optional | string | 커스텀 이미지 ID | 10a599e031e749b7b260868f441e862b |
| desired_node_count optional | integer | Desired node count (is_auto_scale = false) | 2 |
| labels optional | array | 노드풀 레이블 목록 | '{"key": "example.com/my-app", "value": "bar"}' |
| max_node_count optional | integer | Maximum node count (is_auto_scale = true) | 5 |
| min_node_count optional | integer | Minimum node count (is_auto_scale = true) | 1 |
| taints optional | array | 노드풀 테인트 목록 | '{"effect": "NoSchedule", "key": "example.com/my-app", "value": "bar"}' |
Responses
| Name | Description | Example |
|---|---|---|
| id | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| auto_recovery_enabled | 자동 복구 사용 여부 | true |
| auto_scale_enabled | 자동 확장 사용 여부 | true |
| cluster | 클러스터 | |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| current_node_count | 현재 노드 수 | 1 |
| desired_node_count | 요청 노드 수 | 2 |
| image | 이미지 | |
| keypair | 키페어 이름 | |
| kubernetes_version | 쿠버네티스 버전 | v1.29.8 |
| labels | 노드풀 레이블 목록 | |
| max_node_count | 최대 노드 수 | 5 |
| min_node_count | 최소 노드 수 | 1 |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | 노드풀 이름 | sample-nodepool |
| server_type | 서버 타입 | |
| status | 노드풀 상태 | Running |
| taints | 노드풀 테인트 목록 | |
| volume_size | 볼륨 크기 | 104 |
| volume_type | 볼륨 타입 |
1.4 - Delete Cluster
1.4.1 - 1.1
scpcli ske cluster delete
--cluster_id <value>
Description
delete a specific cluster
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
1.4.2 - 1.0
scpcli ske cluster delete
--cluster_id <value>
Description
delete a specific cluster
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
1.5 - Delete Nodepool
1.5.1 - 1.1
scpcli ske nodepool delete
--nodepool_id <value>
Description
delete a nodepool
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
1.5.2 - 1.0
scpcli ske nodepool delete
--nodepool_id <value>
Description
delete a nodepool
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
1.6 - List Clusters
1.6.1 - 1.1
scpcli ske cluster list
[--size <value>]
[--page <value>]
[--sort <value>]
[--name <value>]
[--status <value>]
[--kubernetes_version <value>]
[--subnet_id <value>]
Description
get clusters list
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| size optional | integer | size | 20 |
| page optional | integer | page | 0 |
| sort optional | string | sort | created_at:desc |
| name optional | string | 클러스터 이름 | sample-cluster |
| status optional | array | 클러스터 상태 | R |
| kubernetes_version optional | array | 클러스터 버전 | v |
| subnet_id optional | string | 클러스터 Subnet ID | 023c57b14f11483689338d085e061492 |
Responses
| Name | Description | Example |
|---|---|---|
| id | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| created_at | 생성 시간 | 2025-03-31T00:23:17Z |
| kubernetes_version | 클러스터 버전 | v1.29.8 |
| modified_at | 수정 시간 | 2025-03-31T00:23:17Z |
| name | 클러스터 이름 | sample-cluster |
| node_count | 클러스터 노드 수 | 5 |
| status | 클러스터 상태 | RUNNING |
| subnet_id | 클러스터 Subnet ID | 023c57b14f11483689338d085e061492 |
1.6.2 - 1.0
scpcli ske cluster list
[--size <value>]
[--page <value>]
[--sort <value>]
[--name <value>]
[--status <value>]
[--kubernetes_version <value>]
[--subnet_id <value>]
Description
get clusters list
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| size optional | integer | size | 20 |
| page optional | integer | page | 0 |
| sort optional | string | sort | created_at:desc |
| name optional | string | 클러스터 이름 | sample-cluster |
| status optional | array | 클러스터 상태 | R |
| kubernetes_version optional | array | 클러스터 버전 | v |
| subnet_id optional | string | 클러스터 Subnet ID | 023c57b14f11483689338d085e061492 |
Responses
| Name | Description | Example |
|---|---|---|
| id | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| created_at | 생성 시간 | 2025-03-31T00:23:17Z |
| kubernetes_version | 클러스터 버전 | v1.29.8 |
| modified_at | 수정 시간 | 2025-03-31T00:23:17Z |
| name | 클러스터 이름 | sample-cluster |
| node_count | 클러스터 노드 수 | 5 |
| status | 클러스터 상태 | RUNNING |
| subnet_id | 클러스터 Subnet ID | 023c57b14f11483689338d085e061492 |
1.7 - List Nodepool Nodes
1.7.1 - 1.1
scpcli ske nodepool node list
--nodepool_id <value>
[--size <value>]
[--page <value>]
[--sort <value>]
[--node_name <value>]
Description
Get nodepool node list
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| size optional | integer | size | 20 |
| page optional | integer | page | 0 |
| sort optional | string | sort | created_at:desc |
| node_name optional | string | 노드 이름 | ske-aug-rhel-0805-1-84d799f767-8dr2p |
Responses
| Name | Description | Example |
|---|---|---|
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| kubernetes_version | 쿠버네티스 버전 | v1.29.8 |
| name | 노드 이름 | ske-aug-rhel-0805-1-84d799f767-8dr2p |
| status | 노드풀 상태 | RUNNING |
1.7.2 - 1.0
scpcli ske nodepool node list
--nodepool_id <value>
[--size <value>]
[--page <value>]
[--sort <value>]
[--node_name <value>]
Description
Get nodepool node list
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| size optional | integer | size | 20 |
| page optional | integer | page | 0 |
| sort optional | string | sort | created_at:desc |
| node_name optional | string | 노드 이름 | ske-aug-rhel-0805-1-84d799f767-8dr2p |
Responses
| Name | Description | Example |
|---|---|---|
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| kubernetes_version | 쿠버네티스 버전 | v1.29.8 |
| name | 노드 이름 | ske-aug-rhel-0805-1-84d799f767-8dr2p |
| status | 노드풀 상태 | RUNNING |
1.8 - List Nodepools
1.8.1 - 1.1
scpcli ske nodepool list
--cluster_id <value>
[--size <value>]
[--page <value>]
[--sort <value>]
[--nodepool_name <value>]
Description
get nodepools list
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| size optional | integer | size | 20 |
| page optional | integer | page | 0 |
| sort optional | string | sort | created_at:desc |
| nodepool_name optional | string | 노드풀 이름 | sample-nodepool |
Responses
| Name | Description | Example |
|---|---|---|
| id | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| auto_recovery_enabled | 자동 복구 사용 여부 | |
| auto_scale_enabled | 자동 확장 사용 여부 | |
| current_node_count | 현재 노드 수 | 1 |
| desired_node_count | 요청 노드 수 | 2 |
| image | 이미지 | |
| kubernetes_version | 쿠버네티스 버전 | v1.29.8 |
| name | 노드풀 이름 | sample-nodepool |
| server_type | 서버 타입 | |
| status | 노드풀 상태 | Running |
| volume_type | 볼륨 타입 |
1.8.2 - 1.0
scpcli ske nodepool list
--cluster_id <value>
[--size <value>]
[--page <value>]
[--sort <value>]
[--nodepool_name <value>]
Description
get nodepools list
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| size optional | integer | size | 20 |
| page optional | integer | page | 0 |
| sort optional | string | sort | created_at:desc |
| nodepool_name optional | string | 노드풀 이름 | sample-nodepool |
Responses
| Name | Description | Example |
|---|---|---|
| id | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| auto_recovery_enabled | 자동 복구 사용 여부 | |
| auto_scale_enabled | 자동 확장 사용 여부 | |
| current_node_count | 현재 노드 수 | 1 |
| desired_node_count | 요청 노드 수 | 2 |
| image | 이미지 | |
| kubernetes_version | 쿠버네티스 버전 | v1.29.8 |
| name | 노드풀 이름 | sample-nodepool |
| server_type | 서버 타입 | |
| status | 노드풀 상태 | Running |
| volume_type | 볼륨 타입 |
1.9 - Set Cluster Logging
1.9.1 - 1.1
scpcli ske cluster logging set
--cluster_id <value>
--cloud_logging_enabled <value>
Description
Set logging on the cluster
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| cloud_logging_enabled required | boolean | 클라우드 로깅 사용 여부 | true |
1.9.2 - 1.0
scpcli ske cluster logging set
--cluster_id <value>
--cloud_logging_enabled <value>
Description
Set logging on the cluster
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| cloud_logging_enabled required | boolean | 클라우드 로깅 사용 여부 | true |
1.10 - Set Cluster Private Access Control
1.10.1 - 1.1
scpcli ske cluster private access control set
--cluster_id <value>
--private_endpoint_access_control_resources <value>
Description
set a private access control specific cluster
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| private_endpoint_access_control_resources required | array | '{"id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f", "name": "sample-name", "type": "vm"}' |
1.10.2 - 1.0
scpcli ske cluster private access control set
--cluster_id <value>
--private_endpoint_access_control_resources <value>
Description
set a private access control specific cluster
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| private_endpoint_access_control_resources required | array | '{"id": "2a9be312-5d4b-4bc8-b2ae-35100fa9241f", "name": "sample-name", "type": "vm"}' |
1.11 - Set Cluster Public Access Control
1.11.1 - 1.1
scpcli ske cluster public access control set
--cluster_id <value>
--public_endpoint_access_control_ip <value>
Description
set a public access control specific cluster
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| public_endpoint_access_control_ip required | string | Public Endpoint 접근 제어 IP | 192.168.0.0 |
1.11.2 - 1.0
scpcli ske cluster public access control set
--cluster_id <value>
--public_endpoint_access_control_ip <value>
Description
set a public access control specific cluster
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| public_endpoint_access_control_ip required | string | Public Endpoint 접근 제어 IP | 192.168.0.0 |
1.12 - Set Cluster Security Groups
1.12.1 - 1.1
scpcli ske cluster security group set
--cluster_id <value>
--security_group_id_list <value>
Description
Set Cluster Security Groups
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| security_group_id_list required | array | Security group ID 목록 | b |
1.12.2 - 1.0
scpcli ske cluster security group set
--cluster_id <value>
--security_group_id_list <value>
Description
Set Cluster Security Groups
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| security_group_id_list required | array | Security group ID 목록 | b |
1.13 - Set Cluster Service Watch Logging
1.13.1 - 1.1
scpcli ske cluster service watch logging set
--cluster_id <value>
--service_watch_logging_enabled <value>
Description
Set Service Watch logging on the cluster
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| service_watch_logging_enabled required | boolean | Service Watch 사용 여부 | true |
1.14 - Set Cluster Upgrade
1.14.1 - 1.1
scpcli ske cluster upgrade set
--cluster_id <value>
--kubernetes_version <value>
Description
upgrade a specific cluster
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| kubernetes_version required | string | 쿠버네티스 버전 | v1.29.8 |
1.14.2 - 1.0
scpcli ske cluster upgrade set
--cluster_id <value>
--kubernetes_version <value>
Description
upgrade a specific cluster
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| kubernetes_version required | string | 쿠버네티스 버전 | v1.29.8 |
1.15 - Set Nodepool
1.15.1 - 1.1
scpcli ske nodepool set
--nodepool_id <value>
[--desired_node_count <value>]
[--is_auto_recovery <value>]
[--is_auto_scale <value>]
[--max_node_count <value>]
[--min_node_count <value>]
Description
set a nodepool
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| desired_node_count optional | integer | 요청 노드 수 | 2 |
| is_auto_recovery optional | boolean | 자동 복구 사용 여부 | true |
| is_auto_scale optional | boolean | 자동 확장 사용 여부 | true |
| max_node_count optional | integer | 최대 노드 수 | 5 |
| min_node_count optional | integer | 최소 노드 수 | 1 |
1.15.2 - 1.0
scpcli ske nodepool set
--nodepool_id <value>
[--desired_node_count <value>]
[--is_auto_recovery <value>]
[--is_auto_scale <value>]
[--max_node_count <value>]
[--min_node_count <value>]
Description
set a nodepool
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| desired_node_count optional | integer | 요청 노드 수 | 2 |
| is_auto_recovery optional | boolean | 자동 복구 사용 여부 | true |
| is_auto_scale optional | boolean | 자동 확장 사용 여부 | true |
| max_node_count optional | integer | 최대 노드 수 | 5 |
| min_node_count optional | integer | 최소 노드 수 | 1 |
1.16 - Set Nodepool Labels
1.16.1 - 1.1
scpcli ske nodepool labels set
--nodepool_id <value>
--labels <value>
Description
set nodepool labels
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| labels required | array | '{"key": "example.com/my-app", "value": "bar"}' |
1.16.2 - 1.0
scpcli ske nodepool labels set
--nodepool_id <value>
--labels <value>
Description
set nodepool labels
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| labels required | array | '{"key": "example.com/my-app", "value": "bar"}' |
1.17 - Set Nodepool Taints
1.17.1 - 1.1
scpcli ske nodepool taints set
--nodepool_id <value>
--taints <value>
Description
set nodepool taints
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| taints required | array | '{"effect": "NoSchedule", "key": "example.com/my-app", "value": "bar"}' |
1.17.2 - 1.0
scpcli ske nodepool taints set
--nodepool_id <value>
--taints <value>
Description
set nodepool taints
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| taints required | array | '{"effect": "NoSchedule", "key": "example.com/my-app", "value": "bar"}' |
1.18 - Set Nodepool Upgrade
1.18.1 - 1.1
scpcli ske nodepool upgrade set
--nodepool_id <value>
--os_version <value>
Description
upgrade a nodepool
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| os_version required | string | 이미지 OS 버전 | 22.04 |
1.18.2 - 1.0
scpcli ske nodepool upgrade set
--nodepool_id <value>
Description
upgrade a nodepool
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
1.19 - Show Cluster
1.19.1 - 1.1
scpcli ske cluster show
--cluster_id <value>
Description
show a cluster
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
Responses
| Name | Description | Example |
|---|---|---|
| id | ID | 0fdd87aab8cb46f59b7c1f81ed03fb3e |
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| cloud_logging_enabled | 클라우드 로깅 사용 여부 | true |
| cluster_namespace | 클러스터 네임스페이스 | sample-cluster-12345 |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| kubernetes_version | 클러스터 버전 | v1.29.8 |
| managed_security_group | Managed Security Group | |
| 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 | Private Endpoint 접근 제어 리소스 목록 | |
| private_endpoint_url | Private Kubeconfig Download Yn | N |
| private_kubeconfig_download_yn | Cluster의 Private Endpoint URL | https://sample-cluster.ske.private.kr-west1.samsungsdscloud.com:6443 |
| public_endpoint_access_control_ip | Public Endpoint 접근 제어 IP | 192.168.0.0 |
| public_endpoint_url | Public Endpoint 접근 제어 IP | https://sample-cluster.ske.kr-west1.samsungsdscloud.com:6443 |
| public_kubeconfig_download_yn | Public Kubeconfig Download Yn | N |
| security_group_list | 연결된 Security Group | |
| service_watch_logging_enabled | Service Watch 사용 여부 | true |
| status | 클러스터 상태 | RUNNING |
| subnet | Cluster가 사용하는 Subnet | |
| volume | 연결된 File Storage | |
| vpc | Cluster가 사용하는 VPC |
1.19.2 - 1.0
scpcli ske cluster show
--cluster_id <value>
Description
show a cluster
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
Responses
| Name | Description | Example |
|---|---|---|
| id | ID | 0fdd87aab8cb46f59b7c1f81ed03fb3e |
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| cloud_logging_enabled | 클라우드 로깅 사용 여부 | true |
| cluster_namespace | 클러스터 네임스페이스 | sample-cluster-12345 |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| kubernetes_version | 클러스터 버전 | v1.29.8 |
| managed_security_group | Managed Security Group | |
| 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 | Private Endpoint 접근 제어 리소스 목록 | |
| private_endpoint_url | Private Kubeconfig Download Yn | N |
| private_kubeconfig_download_yn | Cluster의 Private Endpoint URL | https://sample-cluster.ske.private.kr-west1.samsungsdscloud.com:6443 |
| public_endpoint_access_control_ip | Public Endpoint 접근 제어 IP | 192.168.0.0 |
| public_endpoint_url | Public Endpoint 접근 제어 IP | https://sample-cluster.ske.kr-west1.samsungsdscloud.com:6443 |
| public_kubeconfig_download_yn | Public Kubeconfig Download Yn | N |
| security_group_list | 연결된 Security Group | |
| status | 클러스터 상태 | RUNNING |
| subnet | Cluster가 사용하는 Subnet | |
| volume | 연결된 File Storage | |
| vpc | Cluster가 사용하는 VPC |
1.20 - Show Cluster User Kubeconfig
1.20.1 - 1.1
scpcli ske cluster user kubeconfig show
--cluster_id <value>
--kubeconfig_type <value>
Description
Show user kubeconfig for the cluster
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| kubeconfig_type required | **** | Kubeconfig 타입 (private/public) | private |
Responses
| Name | Description | Example |
|---|
1.20.2 - 1.0
scpcli ske cluster user kubeconfig show
--cluster_id <value>
--kubeconfig_type <value>
Description
Show user kubeconfig for the cluster
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| cluster_id required | string | 클러스터 ID | 70a599e031e749b7b260868f441e862b |
| kubeconfig_type required | **** | Kubeconfig 타입 (private/public) | private |
Responses
| Name | Description | Example |
|---|
1.21 - Show Nodepool
1.21.1 - 1.1
scpcli ske nodepool show
--nodepool_id <value>
Description
show a nodepool
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
Responses
| Name | Description | Example |
|---|---|---|
| id | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| advanced_settings | 노드풀 고급 설정 | |
| auto_recovery_enabled | 자동 복구 사용 여부 | true |
| auto_scale_enabled | 자동 확장 사용 여부 | true |
| cluster | 클러스터 | |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| current_node_count | 현재 노드 수 | 1 |
| desired_node_count | 요청 노드 수 | 2 |
| image | 이미지 | |
| keypair | 키페어 이름 | |
| kubernetes_version | 쿠버네티스 버전 | v1.29.8 |
| labels | 노드풀 레이블 목록 | |
| max_node_count | 최대 노드 수 | 5 |
| min_node_count | 최소 노드 수 | 1 |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | 노드풀 이름 | sample-nodepool |
| server_group_id | 서버 그룹 ID | 2b8d33d5-4de5-40a5-a34c-7e30204133xc |
| server_type | 서버 타입 | |
| status | 노드풀 상태 | Running |
| taints | 노드풀 테인트 목록 | |
| volume_size | 볼륨 크기 | 104 |
| volume_type | 볼륨 타입 |
1.21.2 - 1.0
scpcli ske nodepool show
--nodepool_id <value>
Description
show a nodepool
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| nodepool_id required | string | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
Responses
| Name | Description | Example |
|---|---|---|
| id | 노드풀 ID | bdfda539-bd2e-4a5c-9021-ec6d52d1ca79 |
| account_id | Account ID | 617b3d0e90c24a5fa1f65a3824861354 |
| auto_recovery_enabled | 자동 복구 사용 여부 | true |
| auto_scale_enabled | 자동 확장 사용 여부 | true |
| cluster | 클러스터 | |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| current_node_count | 현재 노드 수 | 1 |
| desired_node_count | 요청 노드 수 | 2 |
| image | 이미지 | |
| keypair | 키페어 이름 | |
| kubernetes_version | 쿠버네티스 버전 | v1.29.8 |
| labels | 노드풀 레이블 목록 | |
| max_node_count | 최대 노드 수 | 5 |
| min_node_count | 최소 노드 수 | 1 |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | 노드풀 이름 | sample-nodepool |
| server_type | 서버 타입 | |
| status | 노드풀 상태 | Running |
| taints | 노드풀 테인트 목록 | |
| volume_size | 볼륨 크기 | 104 |
| volume_type | 볼륨 타입 |