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のリクエストヘッダをご参照ください。

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

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

フィールド	タイプ	必須の有無	説明
`uuid`	String	Required	クラスタの UUID クラスタリストの照会を参照

リクエスト構文

リクエスト構文は次の通りです。

{
  "name": "np4",
  "nodeCount": 2,
  "softwareCode": "SW.VSVR.OS.LNX64.UBNTU.SVR22.WRKND.G003",
  "serverSpecCode": "s2-g3",
  "storageSize": 100,
  "autoscale": {
    "enabled": false,
    "max": 3,
    "min": 1
  },
  "labels": [
    {
      "key": "label_key",
      "value": "value"
    }
  ],
  "taints": [
    {
      "key": "taints_key",
      "value": "value",
      "effect": "NoExecute"
    }
  ],
  "serverRoleId": "string",
  "fabricCluster": {
    "poolName": "string",
    "poolNo": 1
  }

}

リクエストボディ

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

フィールド	タイプ	必須の有無	説明
`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
`taints`	Array	Optional	スケジューラが特定の Podのノードを使用しないように管理: taints
`serverRoleId`	String	Optional	ノードプールサーバのロールを付与するための ID コンソールまたはRoleリストの照会を参照
`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の設定時、必須

`labels`

labelsの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`key`	String	Conditional	ラベルのキーラベル設定時、必須
`value`	String	Conditional	ラベルの値ラベル設定時、必須

`taints`

taintsの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`key`	String	Conditional	taintのキー taint設定時、必須
`value`	String	Optional	taintの値 taint設定時にも任意入力
`effect`	String	Conditional	スケジューラの管理方式 `NoSchedule` \| `PreferNoSchedule` \| `NoExecute` taint設定時、必須

リクエスト例

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

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のレスポンスステータスコードをご参照ください。