リクエスト

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

メソッド	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"

}

リクエストボディ

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

フィールド	タイプ	必須の有無	説明
`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リストの照会アクションを通じて確認

リクエスト例

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

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

この記事は役に立ちましたか?

リクエスト
レスポンス
- レスポンスステータスコード