Ncloud Kubernetes Service 개요
- 인쇄
- PDF
Ncloud Kubernetes Service 개요
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Ncloud Kubernetes Service는 애플리케이션 컨테이너화, 배포, 스케일링, 그리고 관리를 자동화하는 오픈 소스 플랫폼입니다. Ncloud Kubernetes Service 서비스에서는 Kubernetes 환경 제어 및 관리 기능에 대한 API를 RESTful 형태로 제공합니다.
Ncloud Kubernetes Service 공통 설정
Ncloud Kubernetes Service API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.
요청
공통 요청 형식을 설명합니다.
API URL
요청 API URL은 다음과 같습니다.
수도권 리전: https://nks.apigw.gov-ntruss.com/vnks/v2
남부권 리전: https://nks.apigw.gov-ntruss.com/vnks/krs-v2
요청 헤더
요청 헤더에 대한 설명은 다음과 같습니다.
| 필드 | 필수 여부 | 설명 |
|---|---|---|
x-ncp-apigw-timestamp | Required | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
|
x-ncp-iam-access-key | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key |
x-ncp-apigw-signature-v2 | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명 |
Content-Type | Required | 요청 데이터의 형식
|
응답
공통 응답 형식을 설명합니다.
응답 상태 코드
응답 상태 코드에 대한 설명은 다음과 같습니다.
| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
|---|---|---|---|
| 403 | - | ForbiddenException | Sub Account로 API 호출 시 권한 부족으로 인해 발생 |
| 409 | - | ConflictException | 클러스터나 노드 풀을 작업 중인 상태에서 수정 요청을 할 때 발생 |
참고
네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.
Ncloud Kubernetes Service API
Ncloud Kubernetes Service 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.
| API | 설명 |
|---|---|
| Cluster 목록 조회 | 클러스터 목록 조회 |
| Cluster 조회 | 클러스터 정보 조회 |
| Cluster 생성 | 신규 클러스터 생성 |
| Cluster 버전 업그레이드 | 클러스터의 쿠버네티스를 신규 버전으로 업그레이드 |
| Cluster Audit Log 설정 | Cloud Log Analytics 서비스를 통한 로그 수집 여부 설정 |
| Cluster Subnet 추가 | 클러스터에 서브넷 추가 |
| Cluster OIDC 설정 | 클러스터에 OIDC 인증 기능 추가 |
| Cluster OIDC 조회 | 클러스터의 OIDC 설정 정보 조회 |
| Cluster IP ACL 설정 | 클러스터의 IP ACL 설정 |
| Cluster IP ACL 조회 | 클러스터에 설정한 IP ACL 정보 조회 |
| Cluster LB Subnet 수정 | 클러스터에 설정한 로드밸런서 서브넷이 삭제된 경우, 새로운 로드밸런서 서브넷 설정 |
| Cluster 반납 보호 설정 | 클러스터의 반납 보호 여부 설정 |
| Cluster 시크릿 암호화 설정 | 생성된 클러스터의 시크릿 암호화 설정 |
| Cluster 인증 모드 설정 | 클러스터의 인증 모드 수정 |
| Cluster IAM 액세스 목록 조회 | 클러스터의 IAM 액세스 목록 정보 조회 |
| Cluster IAM 액세스 조회 | 클러스터의 IAM 액세스 정보 조회 |
| Cluster IAM 액세스 생성 | 클러스터의 IAM 액세스 생성 |
| Cluster IAM 액세스 수정 | 클러스터의 IAM 액세스 정보 수정 |
| Cluster IAM 액세스 삭제 | 클러스터 IAM 액세스 삭제 |
| Cluster 삭제 | 클러스터 삭제 |
| WorkerNode 조회 | 클러스터 안에 생성된 워커 노드 목록 조회 |
| WorkerNode 삭제 | 클러스터 안에 생성된 워커 노드 삭제 |
| NodePool 조회 | 클러스터 안에 워커 노드를 생성하기 위해 설정한 노드풀의 목록 조회 |
| NodePool 생성 | 클러스터 안에 워커 노드의 개수, 사양 등을 설정하는 노드풀 생성 |
| NodePool 수정 | 노드풀에서 고정된 노드의 개수를 변경하거나 오토스케일 사용 여부 설정 |
| NodePool Subnet 수정 | 별도의 Subnet을 할당한 노드풀에 한하여 할당된 Subnet 대역 수정 |
| NodePool Label 수정 | 노드풀의 레이블 수정 |
| NodePool Taint 수정 | 노드풀의 Taint 수정 |
| NodePool 업그레이드 | 클러스터에 등록된 노드풀의 버전 업그레이드 |
| NodePool 삭제 | 노드풀과 이에 소속된 노드를 클러스터에서 삭제 |
| Kubeconfig 조회 | 클러스터의 kubeconfig 설정 파일 조회 |
| k8s 지원 버전 조회 | 클러스터를 생성할 수 있는 k8s 버전 조회 |
| 서버 이미지 조회 | 클러스터를 생성할 때 이용할 수 있는 서버 이미지 유형 조회 |
| 서버 스펙 조회 | 클러스터 또는 노드풀을 생성할 때 이용할 수 있는 서버 스펙 조회 |
Ncloud Kubernetes Service 연관 리소스
Ncloud Kubernetes Service API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.
- Ncloud Kubernetes Service API 사용 방법
- 서명(시그니처) 생성: 요청 헤더에 추가할 서명 생성 방법
- Sub Account 사용 가이드: 요청 헤더에 추가할 Access Key 발급 방법
- Ncloud 공통 응답 상태 코드: Ncloud Kubernetes Service 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- Ncloud Kubernetes Service 서비스 사용 방법
- Ncloud Kubernetes Service 사용 가이드: 네이버 클라우드 플랫폼 콘솔에서 Ncloud Kubernetes Service 사용하는 방법
- Ncloud 사용 환경 가이드: VPC, Classic 환경 및 지원 여부에 관한 사용 가이드
- 요금 소개, 특징, 상세 기능: Ncloud Kubernetes Service의 요금 체계, 특징, 상세 기능 요약
- 서비스 최신 소식: Ncloud Kubernetes Service 서비스 관련 최신 소식
- 자주 하는 질문: Ncloud Kubernetes Service 서비스 사용자들이 자주 하는 질문
- 문의하기: API 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의
이 문서가 도움이 되었습니까?