---
title: "Ncloud Kubernetes Serviceの概要"
slug: "compute-vpckubernetesservice"
tags: ["Kubernetes Service", "overview"]
updated: 2026-09-17T09:57:45Z
published: 2026-09-17T09:57:45Z
canonical: "api.ncloud-docs.com/compute-vpckubernetesservice"
---

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

# Ncloud Kubernetes Serviceの概要

VPC環境で利用できます。

Ncloud Kubernetes Serviceは、アプリケーションのコンテナ化、デプロイ、スケーリング、そして管理を自動化するオープンソースプラットフォームです。Ncloud Kubernetes Serviceサービスは、Kubernetes環境制御および管理機能関連の APIを RESTfulの形式で提供します。

## Ncloud Kubernetes Serviceの共通設定

Ncloud Kubernetes Service APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

### リクエスト

共通リクエスト形式を説明します。

#### API URL

リクエスト API URLは次の通りです。

```
https://nks.apigw.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 | NAVERクラウドプラットフォームから発行された Access Key - Access Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)を参照 - サブアカウントの Access Key発行と確認: [サブアカウントの作成](https://guide.ncloud-docs.com/docs/ja/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 | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64でエンコードした署名 - Secret Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)を参照 - 署名の作成: [シグネチャーの作成](/docs/ja/common-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1)を参照 |
| `Content-Type` | Required | リクエストデータの形式 - `application/json` |

### レスポンス

共通レスポンス形式を説明します。

#### レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

| HTTPステータスコード | コード | メッセージ | 説明 |
| --- | --- | --- | --- |
| 403 | - | ForbiddenException | Sub Accountで APIを呼び出す時、権限不十分により発生 |
| 409 | - | ConflictException | クラスタやノードプールを処理中に変更リクエストした時に発生 |

              参考

              

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%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/ja/nks-getclusterlist) | クラスタリストを照会 |
| [Clusterの照会](/docs/ja/nks-getcluster) | クラスタ情報を照会 |
| [Clusterの作成](/docs/ja/nks-createcluster) | クラスタを新規作成 |
| [Clusterのバージョンアップグレード](/docs/ja/nks-upgrade) | クラスタの Kubernetesを新規のバージョンにアップグレード |
| [Cluster Audit Logの設定](/docs/ja/nks-clusterauditlog) | Cloud Log Analyticsサービスを利用してログを収集するかどうかを設定 |
| [Cluster Subnetの追加](/docs/ja/nks-addsubnet) | クラスタにサブネットを追加 |
| [Cluster OIDCの設定](/docs/ja/nks-patchoidc) | クラスタに OIDC認証機能を追加 |
| [Cluster OIDCの照会](/docs/ja/nks-getoidc) | クラスタの OIDC設定情報を照会 |
| [Cluster IPアドレス ACLの設定](/docs/ja/nks-patchipacl) | クラスタの IPアドレス ACLを設定 |
| [Cluster IPアドレス ACLの照会](/docs/ja/nks-getipacl) | クラスタに設定した IPアドレス ACL情報を照会 |
| [Cluster LB Subnetの変更](/docs/ja/nks-lbsubnet) | クラスタに設定したロードバランサのサブネットが削除された場合、新しいロードバランサのサブネットを設定 |
| [Cluster返却保護の設定](/docs/ja/nks-returnprotection) | クラスタの返却保護をするかどうかを設定 |
| [Clusterシークレット暗号化の設定](/docs/ja/nks-updatesecretencryption) | 作成されたクラスタのシークレット暗号化を設定 |
| [Cluster認証モードの設定](/docs/ja/nks-updateauthtype) | クラスタの認証モードを更新 |
| [Cluster IAMアクセスリストの照会](/docs/ja/nks-getaccessentrylist) | クラスタの IAMアクセスリスト情報を照会 |
| [Cluster IAMアクセスの照会](/docs/ja/nks-getaccessentry) | クラスタの IAMアクセス情報を照会 |
| [Cluster IAMアクセスの作成](/docs/ja/nks-createaccessentry) | クラスタの IAMアクセスを作成 |
| [Cluster IAMアクセスの更新](/docs/ja/nks-updateaccessentry) | クラスタの IAMアクセス情報を更新 |
| [Cluster IAMアクセスの削除](/docs/ja/nks-deleteaccessentry) | クラスタの IAMアクセスを削除 |
| [Clusterの削除](/docs/ja/nks-deletecluster) | クラスタを削除 |
| [WorkerNodeの照会](/docs/ja/nks-getworkernode) | クラスタ内に作成されたワーカーノードリストを照会 |
| [WorkerNodeの削除](/docs/ja/nks-deleteworkernode) | クラスタ内に作成されたワーカーノードを削除 |
| [NodePoolの照会](/docs/ja/nks-viewnodepool) | クラスタ内にワーカーノードを作成するために設定したノードプールのリストを照会 |
| [NodePoolの作成](/docs/ja/nks-createnodepool) | クラスタ内に、ワーカーノードの数、スペックなどを設定するノードプールを作成 |
| [NodePoolの変更](/docs/ja/nks-updatenodepool) | ノードプールで固定されたノード数を変更したり、オートスケールの使用有無を設定 |
| [NodePool Subnetの変更](/docs/ja/nks-updatenodepoolsubnet) | 別途 Subnetを割り当てたノードプールに限り、割り当てられた Subnet帯域を変更 |
| [NodePool Labelの変更](/docs/ja/nks-updatenodepoollabel) | ノードプールのラベルを変更 |
| [NodePool Taintの変更](/docs/ja/nks-updatenodepooltaint) | ノードプールの Taintを変更 |
| [NodePoolのアップグレード](/docs/ja/nks-upgradenodepool) | クラスタに登録されているノードプールのバージョンをアップグレード |
| [NodePoolの削除](/docs/ja/nks-deletenodepool) | ノードプールと、これに属するノードをクラスタから削除 |
| [Add-onリストの照会](/docs/ja/nks-getaddonconfiglist) | クラスタにインストール可能な Add-onリストを照会 |
| [Add-onの照会](/docs/ja/nks-getaddonconfig) | Add-onの詳細情報を照会 |
| [Add-onバージョンの照会](/docs/ja/nks-getaddonconfigversion) | Add-onバージョンの詳細情報を照会 |
| [Cluster Add-onリストの照会](/docs/ja/nks-getclusteraddonlist) | クラスタにインストールされている Add-onリストを照会 |
| [Cluster Add-onの照会](/docs/ja/nks-getclusteraddon) | クラスタにインストールされている Add-onを照会 |
| [Cluster Add-onのインストール](/docs/ja/nks-installaddon) | クラスタに1つ以上の Add-onをインストール |
| [Cluster Add-onの変更](/docs/ja/nks-updateaddon) | クラスタにインストールされている Add-onのバージョンまたは設定を変更 |
| [Cluster Add-onの削除](/docs/ja/nks-deleteaddon) | クラスタにインストールされている Add-onを削除 |
| [Kubeconfigの照会](/docs/ja/nks-viewkubeconfig) | クラスタの kubeconfig設定ファイルを照会 |
| [k8sサポートバージョンの照会](/docs/ja/nks-viewk8sversion) | クラスタを作成できる k8sバージョンを照会 |
| [サーバイメージの照会](/docs/ja/nks-viewserverimage) | クラスタを作成する際に利用できるサーバイメージタイプを照会 |
| [サーバスペックの照会](/docs/ja/nks-viewserverspec) | クラスタまたはノードプールを作成する際に利用できるサーバスペックを照会 |

## Ncloud Kubernetes Service関連リソース

Ncloud Kubernetes Service APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。

- Ncloud Kubernetes Service APIの使用方法
  - [署名(シグネチャー)の作成](/docs/ja/common-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1): リクエストヘッダに追加する署名の作成方法
  - [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): リクエストヘッダに追加する Access Keyの発行方法
  - [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C): Ncloud Kubernetes Serviceサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
- Ncloud Kubernetes Serviceサービスの使用方法
  - [Ncloud Kubernetes Serviceご利用ガイド](https://guide.ncloud-docs.com/docs/ja/k8s-k8soverview): NAVERクラウドプラットフォームコンソールで Ncloud Kubernetes Serviceを使用する方法
  - [Ncloud使用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境およびサポートに関する利用ガイド
  - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/containers/NcloudKubernetesService): Ncloud Kubernetes Serviceの料金体系、特徴、詳細機能のサマリー
  - [サービスの最新情報](https://www.ncloud.com/intro/news?categoryCode=CNTR&serviceCode=SV_0099): Ncloud Kubernetes Serviceに関する最新情報
  - [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=CNTR&categoryCode3=SV_0099&page=1): Ncloud Kubernetes Serviceユーザーからよく寄せられる質問とその回答
  - [お問い合わせ](https://www.ncloud.com/support/question/general): APIガイドだけでは不明な点が解消されない場合、直接問い合わせ