---
title: "NodePoolの作成"
slug: "nks-createnodepool"
updated: 2026-09-17T09:57:45Z
published: 2026-09-17T09:57:45Z
canonical: "api.ncloud-docs.com/nks-createnodepool"
---

> ## 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.

# NodePoolの作成

VPC環境で利用できます。

クラスタ内に、ワーカーノードの数、スペックなどを設定するノードプールを作成します。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| POST | /vnks/v2/clusters/{uuid}/node-pool (韓国リージョン) |
| POST | /vnks/sgn-v2/clusters/{uuid}/node-pool (シンガポールリージョン) |
| POST | /vnks/jpn-v2/clusters/{uuid}/node-pool (日本リージョン) |

### リクエストヘッダ

Ncloud Kubernetes Service APIで共通して使用されるヘッダの詳細は、[Ncloud Kubernetes Serviceの共通ヘッダ](/docs/ja/compute-vpckubernetesservice#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `uuid` | String | Required | クラスタの UUID - [クラスタリストの照会](/docs/ja/nks-getclusterlist)を参照 |

### リクエストボディ

リクエストボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `name` | String | Required | ノードプール名 |
| `nodeCount` | Integer | Conditional | 登録されるノード数 - オートスケール未設定時、必須 |
| `softwareCode` | String | Optional | サーバイメージコード |
| `serverSpecCode` | String | Optional | サーバスペックコード |
| `storageSize` | Integer | Optional | ストレージ容量 |
| `autoscale` | Array | Optional | オートスケールオプション |
| `autoscale.enabled` | Boolean | Optional | オートスケールが可能かどうか - `true` \| `false` - - `true`: オートスケールを使用 - `false`: オートスケールを使用しない |
| `autoscale.max` | Integer | Optional | オートスケールが可能な最大ノード数 - 250以下 |
| `autoscale.min` | Integer | Optional | オートスケールが可能な最小ノード数 - 1以上 |
| `labels[]` | Array | Optional | ノードプールに属するすべてのノードに適用するラベル |
| `labels[].key` | String | Conditional | ラベルのキー - ラベル設定時、必須 |
| `labels[].value` | String | Conditional | ラベルの値 - ラベル設定時、必須 |
| `taints[]` | Array | Optional | スケジューラが特定の Podのノードを使用しないように管理 |
| `taints[].key` | String | Conditional | taintのキー - taint設定時、必須 |
| `taints[].value` | String | Optional | taintの値 - taint設定時にも任意入力 |
| `taints[].effect` | String | Conditional | スケジューラの管理方式 - `NoSchedule` \| `PreferNoSchedule` \| `NoExecute` - taint設定時、必須 |
| `serverRoleId` | String | Optional | ノードプールサーバのロールを付与するための ID - コンソールまたは[Roleリストの照会](/docs/ja/management-subaccount-getroles)アクションを通じて確認 |
| `zoneCode` | String | Conditional | ノードプールのゾーンコード - マルチゾーン(Regional)クラスタの場合、必須 - シングルゾーンクラスタでは無視される - [getZoneList](/docs/ja/compute-vserver-server-common-getzonelist)アクションを通じて確認 |
| `fabricCluster` | Object | Conditional | Fabric Cluster情報 - Fabric Clusterサポートサーバスペックの使用時、必須 |
| `fabricCluster.poolName` | String | Conditional | Fabric Cluster Pool名 - Fabric Clusterの設定時、必須 |
| `fabricCluster.poolNo` | Integer | Conditional | Fabric Cluster Pool番号 - Fabric Clusterの設定時、必須 |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location 'https://nks.apigw.ntruss.com/vnks/v2/clusters/{uuid}/node-pool' \
--header 'x-ncp-apigw-timestamp: {timestamp}' \
--header 'x-ncp-iam-access-key: {access key}' \
--header 'x-ncp-apigw-signature-v2: {API gateway signature}' \
--data '{
"name": "np4",
"nodeCount": 2,
"softwareCode": "SW.VSVR.OS.LNX64.UBNTU.SVR22.WRKND.G003",
"serverSpecCode": "s2-g3",
"storageSize": 100,
"autoscale": {
"enabled": true,
"max": 2,
"min": 1
},
"labels": [
{
"key": "label_key",
"value": "value"
}
],
"taints": [
{
"key": "taints_key",
"value": "value",
"effect": "NoExecute"
}
]
}'
```

## レスポンス

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

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

Ncloud Kubernetes Service APIで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud Kubernetes Serviceのレスポンスステータス コード](/docs/ja/compute-vpckubernetesservice#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。