NodePoolの作成

Prev Next

VPC環境で利用できます。

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

リクエスト

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

メソッド URI
POST /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[].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
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のレスポンスステータスコードをご参照ください。