---
title: "Ncloud Kubernetes Service 개요"
slug: "compute-kubernetesservice"
tags: ["Ncloud Kubernetes Service"]
updated: 2026-09-17T09:10:13Z
published: 2026-09-17T09:10:13Z
canonical: "api-fin.ncloud-docs.com/compute-kubernetesservice"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ncloud Kubernetes Service 개요

Ncloud Kubernetes Service는 애플리케이션 컨테이너화, 배포, 스케일링, 그리고 관리를 자동화하는 오픈 소스 플랫폼입니다. Ncloud Kubernetes Service 서비스에서는 Kubernetes 환경 제어 및 관리 기능에 대한 API를 RESTful 형태로 제공합니다.

## Ncloud Kubernetes Service 공통 설정

Ncloud Kubernetes Service API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

### 요청

공통 요청 형식을 설명합니다.

#### API URL

요청 API URL은 다음과 같습니다.

```
https://nks.apigw.fin-ntruss.com
```

#### 요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

| 필드 | 필수 여부 | 설명 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초) - API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주 - Unix Timestamp 형식 |
| `x-ncp-iam-access-key` | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key - Access Key 발급 및 확인: [인증키 생성](/docs/common-ncpapi#API%EC%9D%B8%EC%A6%9D%ED%82%A4) 참조 - 서브 계정의 Access Key 발급 및 확인: [서브 계정 생성](https://guide-fin.ncloud-docs.com/docs/subaccount-use#%EC%84%9C%EB%B8%8C%EA%B3%84%EC%A0%95%EC%83%9D%EC%84%B1) 참조 |
| `x-ncp-apigw-signature-v2` | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명 - Secret Key 발급 및 확인: [인증키 생성](/docs/common-ncpapi#API%EC%9D%B8%EC%A6%9D%ED%82%A4) 참조 - 서명 생성: [시그니처 생성](/docs/common-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1) 참조 |
| `Content-Type` | Optional | 요청 데이터의 형식 - `application/json` |

### 응답

공통 응답 형식을 설명합니다.

#### 응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
| --- | --- | --- | --- |
| 403 | - | ForbiddenException | Sub Account로 API 호출 시 권한 부족으로 인해 발생 |
| 409 | - | ConflictException | 클러스터나 노드 풀을 작업 중인 상태에서 수정 요청을 할 때 발생 |

참고

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Ncloud API 응답 상태 코드](/docs/common-ncpapi#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

## Ncloud Kubernetes Service API

Ncloud Kubernetes Service 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [Cluster 목록 조회](/docs/nks-getclusterlist) | 클러스터 목록 조회 |
| [Cluster 조회](/docs/nks-getcluster) | 클러스터 정보 조회 |
| [Cluster 생성](/docs/nks-createcluster) | 신규 클러스터 생성 |
| [Cluster 버전 업그레이드](/docs/nks-upgrade) | 클러스터의 쿠버네티스를 신규 버전으로 업그레이드 |
| [Cluster Audit Log 설정](/docs/nks-clusterauditlog) | Cloud Log Analytics 서비스를 통한 로그 수집 여부 설정 |
| [Cluster Subnet 추가](/docs/nks-addsubnet) | 클러스터에 서브넷 추가 |
| [Cluster OIDC 설정](/docs/nks-patchoidc) | 클러스터에 OIDC 인증 기능 추가 |
| [Cluster OIDC 조회](/docs/nks-getoidc) | 클러스터의 OIDC 설정 정보 조회 |
| [Cluster IP ACL 설정](/docs/nks-patchipacl) | 클러스터의 IP ACL 설정 |
| [Cluster IP ACL 조회](/docs/nks-getipacl) | 클러스터에 설정한 IP ACL 정보 조회 |
| [Cluster LB Subnet 수정](/docs/nks-lbsubnet) | 클러스터에 설정한 로드밸런서 서브넷이 삭제된 경우, 새로운 로드밸런서 서브넷 설정 |
| [Cluster 반납 보호 설정](/docs/nks-returnprotection) | 클러스터의 반납 보호 여부 설정 |
| [Cluster 시크릿 암호화 설정](/docs/nks-updatesecretencryption) | 생성된 클러스터의 시크릿 암호화 설정 |
| [Cluster 인증 모드 설정](/docs/nks-updateauthtype) | 클러스터의 인증 모드 수정 |
| [Cluster IAM 액세스 목록 조회](/docs/nks-getaccessentrylist) | 클러스터의 IAM 액세스 목록 정보 조회 |
| [Cluster IAM 액세스 조회](/docs/nks-getaccessentry) | 클러스터의 IAM 액세스 정보 조회 |
| [Cluster IAM 액세스 생성](/docs/nks-createaccessentry) | 클러스터의 IAM 액세스 생성 |
| [Cluster IAM 액세스 수정](/docs/nks-updateaccessentry) | 클러스터의 IAM 액세스 정보 수정 |
| [Cluster IAM 액세스 삭제](/docs/nks-deleteaccessentry) | 클러스터 IAM 액세스 삭제 |
| [Cluster 삭제](/docs/nks-deletecluster) | 클러스터 삭제 |
| [WorkerNode 조회](/docs/nks-getworkernode) | 클러스터 안에 생성된 워커 노드 목록 조회 |
| [WorkerNode 삭제](/docs/nks-deleteworkernode) | 클러스터 안에 생성된 워커 노드 삭제 |
| [NodePool 조회](/docs/nks-viewnodepool) | 클러스터 안에 워커 노드를 생성하기 위해 설정한 노드풀의 목록 조회 |
| [NodePool 생성](/docs/nks-createnodepool) | 클러스터 안에 워커 노드의 개수, 사양 등을 설정하는 노드풀 생성 |
| [NodePool 수정](/docs/nks-updatenodepool) | 노드풀에서 고정된 노드의 개수를 변경하거나 오토스케일 사용 여부 설정 |
| [NodePool Subnet 수정](/docs/nks-updatenodepoolsubnet) | 별도의 Subnet을 할당한 노드풀에 한하여 할당된 Subnet 대역 수정 |
| [NodePool Label 수정](/docs/nks-updatenodepoollabel) | 노드풀의 레이블 수정 |
| [NodePool Taint 수정](/docs/nks-updatenodepooltaint) | 노드풀의 Taint 수정 |
| [NodePool 업그레이드](/docs/nks-upgradenodepool) | 클러스터에 등록된 노드풀의 버전 업그레이드 |
| [NodePool 삭제](/docs/nks-deletenodepool) | 노드풀과 이에 소속된 노드를 클러스터에서 삭제 |
| [Kubeconfig 조회](/docs/nks-viewkubeconfig) | 클러스터의 kubeconfig 설정 파일 조회 |
| [k8s 지원 버전 조회](/docs/nks-viewk8sversion) | 클러스터를 생성할 수 있는 k8s 버전 조회 |
| [서버 이미지 조회](/docs/nks-viewserverimage) | 클러스터를 생성할 때 이용할 수 있는 서버 이미지 유형 조회 |
| [서버 스펙 조회](/docs/nks-viewserverspec) | 클러스터 또는 노드풀을 생성할 때 이용할 수 있는 서버 스펙 조회 |

## Ncloud Kubernetes Service 연관 리소스

Ncloud Kubernetes Service API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.

- Ncloud Kubernetes Service API 사용 방법
  - [서명(시그니처) 생성](/docs/common-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1): 요청 헤더에 추가할 서명 생성 방법
  - [Sub Account 사용 가이드](	https://guide-fin.ncloud-docs.com/docs/subaccount-overview){target="_blank"}: 요청 헤더에 추가할 Access Key 발급 방법
  - [Ncloud 공통 응답 상태 코드](/docs/common-ncpapi#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C): Ncloud Kubernetes Service 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- Ncloud Kubernetes Service 서비스 사용 방법
  - [Ncloud Kubernetes Service 사용 가이드](https://guide-fin.ncloud-docs.com/docs/k8s-k8soverview): 네이버 클라우드 플랫폼 콘솔에서 Ncloud Kubernetes Service 사용하는 방법
  - [요금 소개, 특징, 상세 기능](https://www.fin-ncloud.com/product/containers/nks): Ncloud Kubernetes Service의 요금 체계, 특징, 상세 기능 요약
  - [서비스 최신 소식](https://www.fin-ncloud.com/intro/news?categoryCode=CNTR&serviceCode=SV_0120): Ncloud Kubernetes Service 서비스 관련 최신 소식
  - [자주 하는 질문](https://www.fin-ncloud.com/support/faq/prod?categoryCode2=CNTR&categoryCode3=SV_0120&page=1): Ncloud Kubernetes Service 서비스 사용자들이 자주 하는 질문
  - [문의하기](https://www.ncloud.com/support/question/general): API 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의