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 |
String | Required | ノードプール名 |
nodeCount |
Integer | Conditional | 登録されるノード数
|
softwareCode |
String | Optional | サーバイメージコード |
serverSpecCode |
String | Optional | サーバスペックコード |
storageSize |
Integer | Optional | ストレージ容量 |
autoscale |
Array | Optional | オートスケールオプション |
autoscale.enabled |
Boolean | Optional | オートスケールが可能かどうか
|
autoscale.max |
Integer | Optional | オートスケールが可能な最大ノード数
|
autoscale.min |
Integer | Optional | オートスケールが可能な最小ノード数
|
labels[] |
Array | Optional | ノードプールに属するすべてのノードに適用するラベル |
labels[].key |
String | Conditional | ラベルのキー
|
labels[].value |
String | Conditional | ラベルの値
|
taints[] |
Array | Optional | スケジューラが特定の Podのノードを使用しないように管理 |
taints[].key |
String | Conditional | taintのキー
|
taints[].value |
String | Optional | taintの値
|
taints[].effect |
String | Conditional | スケジューラの管理方式
|
serverRoleId |
String | Optional | ノードプールサーバのロールを付与するための ID
|
zoneCode |
String | Conditional | ノードプールのゾーンコード
|
fabricCluster |
Object | Conditional | Fabric Cluster情報
|
fabricCluster.poolName |
String | Conditional | Fabric Cluster Pool名
|
fabricCluster.poolNo |
Integer | Conditional | Fabric Cluster Pool番号
|
リクエスト例
リクエストのサンプルコードは次の通りです。
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のレスポンスステータス
コードをご参照ください。