NodePool Labelの変更

VPC環境で利用できます。

作成されたノードプールのラベルを変更します。ラベルはノードプールに属するすべてのノードに適用され、ラベルを通じてノードの予約を管理できます。

リクエスト

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

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

リクエストヘッダ

Ncloud Kubernetes Service APIで共通して使用されるヘッダの詳細は、Ncloud Kubernetes Serviceのリクエストヘッダをご参照ください。

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

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

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

リクエスト構文

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

{
  "labels": [
    {
      "key": "string",
      "value": "string"
    }
  ]
}

リクエストボディ

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

フィールド	タイプ	必須の有無	説明
`labels`	Array	Required	変更対象のノードプールのラベルリスト: labels

`labels`

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

フィールド	タイプ	必須の有無	説明
`key`	String	Required	ノードプールラベルのキー英数字、記号の「-」、「_」、「.」が入力可能で、文字列の先頭と末尾は英字または数字のみ使用
`value`	String	Required	ノードプールラベルの値英数字、記号の「-」、「_」、「.」が入力可能で、文字列の先頭と末尾は英字または数字のみ使用

リクエスト例

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

curl --location --request PUT 'https://nks.apigw.ntruss.com/vnks/v2/clusters/{uuid}/node-pool/{instanceNo}/labels' \
--header 'x-ncp-apigw-timestamp: {timestamp}' \
--header 'x-ncp-iam-access-key: {access key}' \
--header 'x-ncp-apigw-signature-v2: {API gateway signature}' \
--data '{
  "labels": [
    {
      "key": "label-key",
      "value": "label-value"
    }
  ]
}'

レスポンス

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

レスポンス構文

レスポンス構文は次の通りです。

{
    "uuid": "string",
    "instanceNo": "integer"
}

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`uuid`	String	-	クラスタの UUID
`instanceNo`	Integer	-	ノードプールのインスタンス番号

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

Ncloud Kubernetes Service APIで共通して使用されるレスポンスステータスコードの詳細は、Ncloud Kubernetes Serviceのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "uuid": "1a1111a1-4d44-99b9-88c8-9e99a99e9e99",
    "instanceNo": 23323233
}