# 修改UK8S节点池 - UpdateUK8SNodeGroup

## 简介

修改UK8S节点池





## 定义

### 公共参数

| 参数名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **Action**     | string  | 对应的 API 指令名称，当前 API 为 `UpdateUK8SNodeGroup`                        | **Yes** |
| **PublicKey**  | string  | 用户公钥，可从 [控制台](https://console.sigcalcloud.com/uaccount/api_manage) 获取                                             | **Yes** |
| **Signature**  | string  | 根据公钥及 API 指令生成的用户签名，参见 [签名算法](/docs/api/summary/signature.md)  | **Yes** |

### 请求参数

| 参数名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **Region** | string | 地域。 参见 [地域和可用区列表](/docs/api/summary/regionlist) |**Yes**|
| **Zone** | string | 可用区。参见 [可用区列表](/docs/api/summary/regionlist) |No|
| **ProjectId** | string | 项目ID。不填写为默认项目，子帐号必须填写。 请参考[GetProjectList接口](/docs/api/summary/get_project_list) |No|
| **NodeGroupId** | string | 要修改的节点池Id |**Yes**|
| **ClusterId** | string | 要修改的集群ID |**Yes**|
| **NodeGroupName** | string | 节点池名字 |No|
| **ImageId** | string | 镜像ID |No|
| **MachineType** | string | 云主机机型。枚举值["N", "C", "G", "O", "OS"]。参考[云主机机型说明](api/uhost-api/uhost_type)。 |No|
| **MinimalCpuPlatform** | string | 最低cpu平台，枚举值["Intel/Auto", "Intel/IvyBridge", "Intel/Haswell", "Intel/Broadwell", "Intel/Skylake", "Intel/Cascadelake"；"Intel/CascadelakeR"; “Amd/Epyc2”,"Amd/Auto"],默认值是"Intel/Auto" |No|
| **UHostFamily** | string | 主机规格族 |No|
| **CPU** | int | GPU卡核心数。仅GPU机型支持此字段（可选范围与MachineType+GpuType相关） |No|
| **Mem** | int | 内存大小。单位：MB |No|
| **GpuType** | string | GPU类型 |No|
| **GPU** | int | GPU卡核心数 |No|
| **BootDiskType** | string | 磁盘类型 |No|
| **DataDiskSize** | int | 数据磁盘大小 |No|
| **DataDiskType** | string | 磁盘类型 |No|
| **Tag** | string | 业务组 |No|
| **ChargeType** | string | 计费模式 |No|
| **BootDiskSize** | int | 系统盘大小，单位GB。默认40。范围：[40, 500]。注意SSD本地盘无法调整。 |No|
| **SubnetId** | string | 子网 ID。默认为集群创建时填写的子网ID，也可以填写集群同VPC内的子网ID。 |No|
| **ZoneBaned** | string | 重复 待删除 可用区。参见 [可用区列表](/docs/api/summary/regionlist) |No|
| **IsolationGroupId** | string | 硬件隔离组id。可通过DescribeIsolationGroup获取。 |No|
| **MaxPods** | string | 默认110，生产环境建议小于等于110。 |No|
| **UserData** | string | 用户自定义数据。当镜像支持Cloud-init Feature时可填写此字段。注意：1、总数据量大小不超过 16K；2、使用base64编码。 |No|
| **InitScript** | string | 用户自定义Shell脚本。与UserData的区别在于InitScript在节点初始化完毕后才执行，UserData则是云主机初始化时执行。 |No|
| **Taints** | string | Node节点污点，形式为key=value:effect，多组taints用”,“隔开,最多支持五组。 |No|
| **Labels** | string | Node节点标签。key=value形式,多组用”,“隔开，最多5组。 如env=pro,type=game |No|
| **NetCapability** | string | 网络增强特性。枚举值：Normal，不开启; Super，开启网络增强1.0； Ultra，开启网络增强2.0；Extreme，开启网络增强3.0; Infiniband, 开启网络增强4.0（详情参考主机官网文档） |No|
| **UNIFeature** | boolean | 弹性网卡特性。开启了弹性网卡权限位，此特性才生效，默认 false 未开启，true 开启。 |No|
| **SecurityMode** | string | 主机安全模式。Firewall：防火墙；SecGroup：安全组；默认值：Firewall。 |No|
| **NodeNamePrefix** | string | 自定义主机名前缀。完整的自定义主机名为{NodeNamePrefix}-{NodeIP}。 |No|
| **SecGroupId.N.Id** | string | 安全组 ID。至多可以同时绑定5个安全组。 |No|
| **SecGroupId.N.Priority** | string | 安全组优先级。取值范围[1, 5] |No|
| **SecGroupId.N.Name** | string | 安全组名称。 |No|
| **SecurityGroupId** | string | 防火墙ID，默认：Web推荐防火墙。如何查询SecurityGroupId请参见 [DescribeFirewall](api/unet-api/describe_firewall.html)。 |No|
| **NetworkInterface.N.EIP.Bandwidth** | int | 【若绑定EIP，此参数必填】弹性IP的外网带宽, 单位为Mbps. 共享带宽模式下非必传, 非共享带宽模式必须指定非0Mbps带宽. 各地域非共享带宽的带宽范围如下： 流量计费[1-300]，带宽计费[1-800] |No|
| **NetworkInterface.N.EIP.PayMode** | string | 弹性IP的计费模式. 枚举值: "Traffic", 流量计费; "Bandwidth", 带宽计费; "ShareBandwidth",共享带宽模式. "Free":免费带宽模式,默认为 "Bandwidth" |No|
| **NetworkInterface.N.EIP.ShareBandwidthId** | string | 绑定的共享带宽Id，仅当PayMode为ShareBandwidth时有效 |No|
| **NetworkInterface.N.EIP.OperatorName** | string | 【若绑定EIP，此参数必填】弹性IP的线路。枚举值: 国际: International, BGP: Bgp。 各地域允许的线路参数如下: cn-sh1: Bgp cn-sh2: Bgp cn-gd: Bgp cn-bj1: Bgp cn-bj2: Bgp hk: International us-ca: International th-bkk: International kr-seoul:International us-ws:International ge-fra:International sg:International tw-kh:International.其他海外线路均为 International |No|
| **NetworkInterface.N.EIP.CouponId** | string | 当前EIP代金券id。请通过DescribeCoupon接口查询，或登录用户中心查看。 |No|
| **KubeletConfiguration.ContainerLogMaxFiles** | int | 全量KubeletConfiguration.XXX定义参考AddUK8SNodeGroup接口: https://uxiao.ucloudadmin.com/#/api-manager/api/detail/UK8S/AddUK8SNodeGroup |No|

### 响应字段

| 字段名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **RetCode** | int | 返回状态码，为 0 则为成功返回，非 0 为失败 |**Yes**|
| **Action** | string | 操作指令名称 |**Yes**|
| **Message** | string | 返回错误消息，当 `RetCode` 非 0 时提供详细的描述信息 |No|
| **NodeGroupId** | string | 节点池ID |**Yes**|




## 示例

### 请求示例
    
```
https://api.sigcalcloud.com/?Action=UpdateUK8SNodeGroup
&Region=cn-zj
&Zone=cn-zj-01
&ProjectId=jGvFXuLi
&NodeGroupName=jMalkMOR
&ClusterId=xbANtphK
&ImageId=ZcHuAIea
&MachineType=syykyLFL
&MinimalCpuPlatform=NWsCCuDR
&CPU=8
&Mem=9
&GpuType=KlcXcUnG
&GPU=1
&BootDiskType=AWrsyArX
&DataDiskSize=1
&DataDiskType=xavyLLjp
&Tag=iKcJBEtL
&ChargeType=PHcXveTq
&BootDiskSize=9
&SubnetId=APmrxuYa
&ZoneBaned=ePUXgfTQ
&IsolationGroupId=FdEubxwL
&MaxPods=pRXeZOwJ
&UserData=RSJaayKm
&InitScript=DRARcPTQ
&Taints=FtCZuKaj
&Labels=VakcHxnw
&NetCapability=UVkHyrhe
&UNIFeature=true
&NodeGroupId=GIPRLyoC
&SecGroupId=qEKzLFoT
&NodeNamePrefix=oEubHlQf
&SecGroupId.N.Priority=ucMCmbxE
&SecGroupId.N.Name=dusVrmAF
&SecurityGroupId=ErUXSmnK
&SecurityMode=qwUsDUBr
&NetworkInterface.N.EIP.Bandwidth=EefpTrnV
&NetworkInterface.N.EIP.PayMode=HjeSWpYA
&NetworkInterface.N.EIP.ShareBandwidthId=yjMCrwBi
&NetworkInterface.N.EIP.OperatorName=MKjAAafB
&NetworkInterface.N.EIP.CouponId=OtZqxfCN
&KubeletConfiguration.ContainerLogMaxFiles=1
&KubeletConfiguration.ContainerLogMaxFiles=7
&UHostFamily=eZPxsXKS
```

### 响应示例
    
```json
{
  "Action": "UpdateUK8SNodeGroupResponse",
  "Message": "iZtGFxEL",
  "NodeGroupId": "DYbEFmyI",
  "RetCode": 0
}
```