# 获取节点详情（待废弃） - GetNodeByConsole #### 功能介绍 该API用于获取指定集群下的指定节点详情。 ![](https://support.huaweicloud.com/api-cce/public_sys-resources/note_3.0-zh-cn.png) 该接口待废弃，推荐使用如下接口替代： [获取指定的节点](https://support.huaweicloud.com/api-cce/cce_02_0243.html)。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-cce/cce_02_0099.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cce/cce_02_0395.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI GET /api/v3.1/projects/{project_id}/clusters/{cluster_id}/nodes/{node_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html)。 **约束限制：** 不涉及 **取值范围：** 账号的项目ID **默认取值：** 不涉及 | | cluster_id | 是 | String | **参数解释：** 集群ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html)。 **约束限制：** 不涉及 **取值范围：** 集群ID **默认取值：** 不涉及 | | node_id | 是 | String | **参数解释**： 节点ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html)。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Content-Type | 是 | String | **参数解释：** 消息体的类型（格式） **约束限制：** GET方法不做校验 **取值范围：** - application/json - application/json;charset=utf-8 - application/x-pem-file - multipart/form-data（注：存在FormData参数时使用） **默认取值：** 不涉及 | | X-Auth-Token | 是 | String | **参数解释：** 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值，获取方式请参见[获取token](https://support.huaweicloud.com/api-cce/cce_02_0004.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | kind | String | **参数解释**： API类型 **约束限制**： 该值不可修改 **取值范围**： 不涉及 **默认取值**： Node | | apiVersion | String | **参数解释**： API版本 **约束限制**： 该值不可修改 **取值范围**： 不涉及 **默认取值**： v3.1 | | metadata | [NodeMetadata] object | **参数解释**： metadata是节点对象的元数据定义，是集合类的元素类型，包含一组由不同名称定义的属性。 **约束限制**： 不涉及 | | spec | [NodeForConsoleSpec] object | **参数解释**： spec是集合类的元素类型，用户对需要管理的节点对象进行详细描述的主体部分都在spec中给出。系统通过spec的描述来创建或更新对象。 **约束限制**： 不涉及 | | status | [NodeForConsoleStatus] object | **参数解释**： 节点状态，动态记录，创建或修改时指定无意义. **约束限制**： 不涉及 | 表4NodeMetadata | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释**： 节点名称 **约束限制**： - 命名规则：以小写字母开头，由小写字母、数字、中划线(-)、点(.)组成，长度范围1-56位，且不能以中划线(-)结尾。 - 若name未指定或指定为空字符串，则按照默认规则生成节点名称。默认规则为："集群名称-随机字符串"，若集群名称过长，则只取前36个字符。 - 若节点数量(count)大于1时，则按照默认规则会在用户输入的节点名称末尾添加随机字符串。默认规则为："用户输入名称-随机字符串"，若用户输入的节点名称长度范围超过50位时，系统截取前50位，并在末尾添加随机字符串。 **取值范围**： 命名规则：以小写字母开头，由小写字母、数字、中划线(-)、点(.)组成，长度范围1-56位，且不能以中划线(-)结尾。 **默认取值**： 若name未指定或指定为空字符串，则按照默认规则生成节点名称。默认规则为："集群名称-随机字符串"，若集群名称过长，则只取前36个字符。 | | uid | String | **参数解释**： 节点ID，资源唯一标识，创建成功后自动生成，填写无效 **约束限制**： 创建成功后自动生成，填写无效 **取值范围**： 不涉及 **默认取值**： 不涉及 | | annotations | Map\ | **参数解释**： CCE自有节点注解，非Kubernetes原生annotations，格式为key/value键值对。 说明： Annotations不用于标识和选择对象。Annotations中的元数据可以是small或large，structured或unstructured，并且可以包括标签不允许使用的字符。 **约束限制**： 仅用于查询，不支持请求时传入，填写无效。 **取值范围**： Annotations不用于标识和选择对象。Annotations中的元数据可以是small或large，structured或unstructured，并且可以包括标签不允许使用的字符。 **默认取值**： 不涉及 示例： ``` "annotations": { "key1" : "value1", "key2" : "value2" } ``` | | creationTimestamp | String | **参数解释**： 创建时间 **约束限制**： 创建成功后自动生成，填写无效 **取值范围**： 不涉及 **默认取值**： 不涉及 | | updateTimestamp | String | **参数解释**： 更新时间 **约束限制**： 更新成功后自动生成，填写无效 **取值范围**： 不涉及 **默认取值**： 不涉及 | | ownerReferences | [ownerReferences] object | **参数解释**： 属主对象。 **约束限制**： - 创建成功后自动生成，填写无效。 - 创建节点接口返回内容中无该参数 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表5ownerReferences | 参数 | 参数类型 | 描述 | |:---|:---|:---| | nodepoolName | String | **参数解释**： 节点池名称 **约束限制**： 创建成功后自动生成，填写无效。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | nodepoolID | String | **参数解释**： 节点池ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html)。 **约束限制**： 创建成功后自动生成，填写无效。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | hyperNodeName | String | **参数解释**： 超节点名称。如果节点不属于超节点，此字段不展示。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | hyperNodeID | String | **参数解释**： 超节点ID。如果节点不属于超节点，此字段不展示。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表6NodeForConsoleSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | flavor | String | **参数解释**： 节点的规格，CCE支持的节点规格请参考[节点规格说明](https://support.huaweicloud.com/api-cce/cce_02_0368.html)获取。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | az | String | **参数解释**： 待创建节点所在的可用区，需要指定可用区（AZ）的名称，通过api创建节点不支持随机可用区。 CCE支持的可用区请参考[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/CCE)。 **约束限制**： 创建节点池并设置伸缩组时，该参数不允许填写为random。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | os | String | **参数解释**： 节点的操作系统类型。具体支持的操作系统请参见[节点操作系统说明](https://support.huaweicloud.com/api-cce/node-os.html)。 **约束限制**： - 若在创建节点时未指定该配置，CCE会根据集群版本自动选择支持的OS版本。 - 若当前集群版本不支持该OS类型，则会自动替换为当前集群版本支持的同系列OS类型。 - 若在创建节点时指定了extendParam中的alpha.cce/NodeImageID参数，节点将使用私有镜像，则该参数为非必选参数。 - 若在创建节点时指定了extendParam中的securityReinforcementType参数为cybersecurity，节点将开启安全等保加固功能，则节点的操作系统类型必须使用HCE2.0。当用户未配置私有镜像时，该参数必须为"Huawei Cloud EulerOS 2.0"；当用户配置了私有镜像且私有镜像操作系统类型为HCE2.0，则该参数为非必选参数。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | login | [Login] object | **参数解释**： 节点的登录方式。不配置将保留所选择镜像的密码，为了保证您的正常使用，请确保所选择镜像中已经设置了密码。 **约束限制**： 不涉及 | | rootVolume | [Volume] object | **参数解释**： 节点的磁盘信息。 **约束限制**： 不涉及 | | dataVolumes | Array of [Volume] objects | **参数解释**： 节点的数据盘参数。针对专属云节点，参数解释与rootVolume一致。 **约束限制**： - 磁盘挂载上限为虚拟机不超过16块，裸金属不超过10块。在此基础上还受限于虚拟机/裸金属规格可挂载磁盘数上限。（目前支持通过控制台和API为CCE节点添加多块数据盘）。 - 如果数据盘正供容器运行时和Kubelet组件使用，则不可被卸载，否则将导致节点不可用。 - 仅在选择系统盘作为系统组件存储磁盘时，允许为空。 | | storage | [Storage] object | **参数解释**： 磁盘初始化配置管理参数。 该参数配置逻辑较为复杂，详细说明请参见[节点磁盘挂载](https://support.huaweicloud.com/api-cce/node_storage_example.html)。 **约束限制**： - v1.15.11-r0及以上集群版本支持此字段。不支持集群版本填写此字段将被忽略。 - 如存在节点规格涉及本地盘并同时使用云硬盘场景时，请勿缺省此参数，避免出现将用户未期望的磁盘分区。 - 如希望数据盘取值范围调整至20-32768，请勿缺省此参数。 - 如希望使用共享磁盘空间(取消runtime和kubernetes分区)，请勿缺省此参数，共享磁盘空间请参考[数据盘空间分配说明](https://support.huaweicloud.com/api-cce/cce_01_0341.html)。 - 如希望系统组件存储在系统盘中，请勿缺省此参数。 | | publicIP | [NodePublicIP] object | **参数解释**： 节点的弹性公网IP。 **约束限制**： 创建节点池添加节点时不支持该参数。 | | nodeNicSpec | [NodeNicSpec] object | **参数解释**： 节点的网卡信息。 **约束限制**： 不涉及 | | count | Integer | **参数解释**： 批量创建时节点的个数。 **约束限制**： - 作用于节点池时该项可以不填写。 - 创建、更新节点池场景返回中无该参数。 - 创建节点时该参数为必填参数 **取值范围**： 必须为大于等于1，小于等于最大限额的正整数。 **默认取值**： 不涉及 | | billingMode | Integer | **参数解释**： 节点的计费模式。 **约束限制**： 不涉及 **取值范围**： - 0: 按需付费 - 1: 包周期 - 2: 已废弃：自动付费包周期 **默认取值**： 0 | | taints | Array of [Taint] objects | **参数解释**： 支持给创建出来的节点加Taints来设置反亲和性。每条Taints包含以下3个参数： - Key：必须以字母或数字开头和结尾，可以包含字母、数字、连字符、下划线和点，最长63个字符；另外可以使用DNS子域作为前缀。 - Value：必须以字符或数字开头和结尾，可以包含字母、数字、连字符、下划线和点，最长63个字符。 - Effect：只可选NoSchedule，PreferNoSchedule或NoExecute。 字段使用场景：在节点创建场景下，支持指定初始值，查询时不返回该字段；在节点池场景下，创建节点池时节点模板参数中支持指定初始值，查询时支持返回该字段；在其余场景下，查询时都不会返回该字段。 示例： ``` "taints": [{ "key": "status", "value": "unavailable", "effect": "NoSchedule" }, { "key": "looks", "value": "bad", "effect": "NoSchedule" }] ``` **约束限制**： taints配置不超过20条。 | | waitPostInstallFinish | Boolean | **参数解释：** 该参数用于控制创建节点时 **post-install脚本执行完成前允许节点调度** 行为。当该参数未设置或者为false时，在kubernetes节点就绪时，容器即可被调度到可用节点。当该参数为true时，在kubernetes节点就绪时且post-install脚本执行完成时，容器才可被调度到可用节点。 **约束限制：** 不涉及 **取值范围：** - false：在kubernetes节点就绪时，容器即可被调度到可用节点。 - true：在kubernetes节点就绪时且post-install脚本执行完成时，容器才可被调度到可用节点。 **默认取值：** false | | k8sTags | Map\ | **参数解释**： 格式为key/value键值对。 - Key：必须以字母或数字开头和结尾，可以包含字母、数字、连字符、下划线和点，最长63个字符；另外可以使用DNS子域作为前缀，例如example.com/my-key，DNS子域最长253个字符。 - Value：可以为空或者非空字符串，非空字符串必须以字符或数字开头和结尾，可以包含字母、数字、连字符、下划线和点，最长63个字符。 字段使用场景：在节点创建场景下，支持指定初始值，查询时不返回该字段；在节点池场景下，创建节点池时节点模板参数中支持指定初始值，查询时支持返回该字段；在其余场景下，查询时都不会返回该字段。 示例： ``` "k8sTags": { "key": "value" } ``` **约束限制**： 键值对个数不超过20条。 | | ecsGroupId | String | **参数解释**： 云服务器组ID，若指定，将节点创建在该云服务器组下。 **约束限制**： 创建、更新节点池时该配置不会生效，若要保持节点池中的节点都在同一个云服务器组内，请在节点池 nodeManagement 字段中配置。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | dedicatedHostId | String | **参数解释**： 指定DeH主机的ID，将节点调度到自己的DeH上。 **约束限制**： 创建节点池添加节点时不支持该参数。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | userTags | Array of [UserTag] objects | **参数解释**： 云服务器标签（资源标签）。字段使用场景：在节点创建场景下，支持指定初始值，查询时不返回该字段；在节点池场景下，创建节点池时节点模板参数中支持指定初始值，查询时支持返回该字段；在其余场景下，查询时都不会返回该字段。 **约束限制**： - 键必须唯一，CCE支持的最大用户自定义标签数量依region而定，自定义标签数上限为8个。 | | runtime | [Runtime] object | **参数解释**： 容器运行时, 默认场景： - 1.25以下集群：默认为"docker" - 1.25及以上集群，随操作系统变化，默认的容器运行时不同 - 操作系统为欧拉2.5、欧拉2.8的节点仅支持"docker"，其余操作系统的节点默认为"containerd" **约束限制**： 不涉及 | | initializedConditions | Array of strings | **参数解释**： 自定义初始化标记，默认值为空。 CCE节点在初始化完成之前，会打上初始化未完成污点（node.cloudprovider.kubernetes.io/uninitialized）防止pod调度到节点上。用户在创建节点时，可以通过设置initializedConditions参数，控制污点的移除时间（默认不设置超时时间）。 使用示例如下： 1. 创建节点，传入参数 "initializedConditions": \["CCEInitial", "CustomedInitial"\]； 2. 用户在执行完自定义初始化操作后，调用k8s接口（例如PATCH /v1/nodes/{node_ip}/status）更新节点的conditions，插入type为CCEInitial、CustomedInitial的两个标记，状态为True，如下所示： 3. CCE组件轮询节点的status.Conditions，查看是否存在type为CCEInitial、CustomedInitial的condition，若存在且status字段值为True，认为节点初始化完成，则移除初始化污点； 4. initializedConditions支持设置超时时间，用户可以在创节点时传入，如："initializedConditions": \["CCEInitial:15m", "CustomedInitial:15m"\]，表示超时时间为15分钟，达到超时时间后，当CCE组件轮询到节点时会自动忽略初始化condition，移除初始化污点。 ``` status: conditions: - type: CCEInitial status: 'True' - type: CustomedInitial status: 'True' ``` **约束限制**： - initializedConditions中超时时间取值范围为\[1-99\]秒 - 必须以字母、数字组成，长度范围1-20位。 - 标记数量不超过2个。 - 超时时间仅支持分钟(m)单位。 | | extendParam | [NodeExtendParam] object | **参数解释**： 创建节点时的扩展参数。 **约束限制**： 不涉及 | | hostnameConfig | [HostnameConfig] object | **参数解释**： K8S节点名称配置参数。 **约束限制**： 支持的集群版本为v1.23.6-r0到v1.25或者v1.25.2-r0及以上。 | | serverEnterpriseProjectID | String | **参数解释**： 服务器企业项目ID。CCE服务不实现EPS相关特性，该字段仅用于同步服务器企业项目ID。 **约束限制**： 创建节点/节点池场景：可指定已存在企业项目，当取值为空时，该字段继承集群企业项目属性。 更新节点池场景：配置修改后仅会对新增节点的服务器生效，存量节点需前往EPS界面迁移。 **取值范围**： 不涉及 **默认取值**： 如果更新时不指定值，不会更新该字段。 当该字段为空时，返回集群企业项目。 | | partition | String | **参数解释**： 表示节点所属分区。分区可以选择中心云或者[边缘小站](https://support.huaweicloud.com/usermanual-cloudpond/ies_02_0401.html)。 **约束限制**： 仅开启了对分布式云支持的Turbo集群支持指定该字段。 **取值范围**： - center: 中心云 - 边缘小站的可用区ID **默认取值**： 不涉及 | | nodeNameTemplate | [nodeNameTemplate] object | **参数解释**： 节点名称固定前后缀配置参数。假设集群内不同节点池被用户所在公司不同部门使用，可以通过前后缀的名称区分部门和使用方式，如设置nodeNamePrefix为finance-，代表部门名称，nodeNameSuffix为-product，代表生产使用，节点池名称为gpu，代表业务类型，则最终的节点名称为finance-gpu(五位随机数)-product **约束限制**： 仅 v1.28.1/v1.27.3/v1.25.6/v1.23.11/v1.21.12 及以上集群支持配置节点名称固定前后缀，该配置参数仅在节点池场景有效 **取值范围**： 不涉及 **默认取值**： 不涉及 | | cpu | Integer | **参数解释**： 节点CPU核数。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | memory | Integer | **参数解释**： 节点内存大小，单位M **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表7Login | 参数 | 参数类型 | 描述 | |:---|:---|:---| | sshKey | String | **参数解释**： 选择密钥对方式登录时的密钥对名称。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | userPassword | [UserPassword] object | **参数解释**： 选择密码方式登录时的账号密码信息，之后可通过此账号密码登录节点。 **约束限制**： 不涉及 | | removeUserPassword | Boolean | **参数解释**： 更新节点池时，移除当前节点池密码方式登录的配置 **约束限制**： 仅更新节点池场景支持该参数，设置为true时不允许设置userPassword **取值范围**： 不涉及 **默认取值**： false | | removeSSHKey | Boolean | **参数解释**： 更新节点池时，移除当前节点池密钥对方式登录的配置 **约束限制**： 仅更新节点池场景支持该参数，设置为true时不允许设置sshKey **取值范围**： 不涉及 **默认取值**： false | 表8UserPassword | 参数 | 参数类型 | 描述 | |:---|:---|:---| | username | String | **参数解释**： 登录账号，默认为"root"。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： root。 | | password | String | **参数解释**： 登录密码，若创建节点通过用户名密码方式，即使用该字段，则响应体中该字段作屏蔽展示。 **约束限制**： 创建节点时password字段需要加盐加密，具体方法请参见[创建节点时password字段加盐加密](https://support.huaweicloud.com/api-cce/add-salt.html)。 **取值范围**： 密码复杂度要求： - 长度为8-26位。 - 密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%\^-_=+\[{}\]:,./?）中的三种。 - 密码不能包含用户名或用户名的逆序。 **默认取值**： 不涉及 | 表9Volume | 参数 | 参数类型 | 描述 | |:---|:---|:---| | size | Integer | **参数解释**： 磁盘大小，单位为GiB。 **约束限制**： 不涉及 **取值范围**： - 系统盘取值范围：40\~1024 - 第一块数据盘取值范围：20\~32768(当缺省磁盘初始化配置管理参数storage时，数据盘取值范围：100-32768) - 其他数据盘取值范围：10\~32768(当缺省磁盘初始化配置管理参数storage时，数据盘取值范围：100-32768) **默认取值**： 不涉及 | | volumetype | String | **参数解释**： 磁盘类型，取值请参见创建云服务器 中"root_volume字段数据结构说明"。 **约束限制**： 不涉及 **取值范围**： - SAS：高IO，是指由SAS存储提供资源的磁盘类型。 - SSD：超高IO，是指由SSD存储提供资源的磁盘类型。 - SATA：普通IO，是指由SATA存储提供资源的磁盘类型。EVS已下线SATA磁盘，仅存量节点有此类型的磁盘。 - ESSD：极速型SSD云硬盘，是指由极速型SSD存储提供资源的磁盘类型。 - GPSSD：通用型SSD云硬盘，是指由通用型SSD存储提供资源的磁盘类型。 - ESSD2：极速型SSD V2云硬盘，是指由极速型SSD V2存储提供资源的磁盘类型。 - GPSSD2：通用型SSD V2云硬盘，是指由通用型SSD V2存储提供资源的磁盘类型。 说明： 了解不同磁盘类型的详细信息，链接请参见[磁盘类型及性能介绍](https://support.huaweicloud.com/productdesc-evs/zh-cn_topic_0044524691.html)。 **默认取值**： 不涉及 | | iops | Integer | **参数解释**： 给云硬盘配置iops。 **约束限制**： - 购买GPSSD2、ESSD2类型的云硬盘时必填，其他类型不能设置。 - 只支持按需计费。 **取值范围**： 了解GPSSD2、ESSD2类型的iops大小范围，请参见[云硬盘类型及性能介绍里面的云硬盘性能数据表](https://support.huaweicloud.com/productdesc-evs/zh-cn_topic_0044524691.html)。 **默认取值**： 不涉及 | | throughput | Integer | **参数解释**： 给云硬盘配置吞吐量，单位是MiB/s。 **约束限制**： - 购买GPSSD2类型云硬盘时必填，其他类型不能设置。 - 只支持按需计费。 **取值范围**： 了解GPSSD2类型的吞吐量大小范围，请参见[云硬盘类型及性能介绍里面的云硬盘性能数据表](https://support.huaweicloud.com/productdesc-evs/zh-cn_topic_0044524691.html)。 **默认取值**： 不涉及 | | extendParam | Map\ | **参数解释**： 磁盘扩展参数，取值请参见创建云服务器中"extendparam"参数的描述。 链接请参见[创建磁盘的extendparam字段数据结构说明](https://support.huaweicloud.com/api-ecs/zh-cn_topic_0167957246.html#section8)。 **约束限制**： 不涉及 | | cluster_id | String | **参数解释**： 云服务器系统盘对应的存储池的ID。仅用作专属云集群，专属分布式存储DSS的存储池ID，即dssPoolID。 获取方法请参见[获取单个专属分布式存储池详情](https://support.huaweicloud.com/api-dss/dss_02_1001.html)中"表3 响应参数"的ID字段。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | cluster_type | String | **参数解释**： 云服务器系统盘对应的磁盘存储类型。 **约束限制**： 不涉及 **取值范围**： 仅用作专属云集群，固定取值为dss。 **默认取值**： 不涉及 | | hw:passthrough | Boolean | **参数解释**： - 使用SDI规格创建虚拟机时请关注该参数，如果该参数值为true，说明创建的为SCSI类型的卷； - 节点池类型为ElasticBMS时，此参数必须填写为true； - 如存在节点规格涉及本地盘并同时使用云硬盘场景时，请设置磁盘初始化配置管理参数，配置参考：[节点磁盘挂载](https://support.huaweicloud.com/api-cce/node_storage_example.html)。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | metadata | [VolumeMetadata] object | **参数解释**： 云硬盘加密信息，仅在创建节点系统盘或数据盘需加密时须填写。 **约束限制**： 不涉及 | 表10VolumeMetadata | 参数 | 参数类型 | 描述 | |:---|:---|:---| | __system__encrypted | String | **参数解释**： 表示云硬盘加密功能的字段，'0'代表不加密，'1'代表加密。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 该字段不存在时，云硬盘默认为不加密。 | | __system__cmkid | String | **参数解释**： 用户主密钥ID，是metadata中的表示加密功能的字段，与__system__encrypted配合使用。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表11Storage | 参数 | 参数类型 | 描述 | |:---|:---|:---| | storageSelectors | Array of [StorageSelectors] objects | **参数解释**： 磁盘选择，根据matchLabels和storageType对匹配的磁盘进行管理。磁盘匹配存在先后顺序，靠前的匹配规则优先匹配。 **约束限制**： 不涉及 | | storageGroups | Array of [StorageGroups] objects | **参数解释**： 由多个存储设备组成的存储组，用于各个存储空间的划分。 **约束限制**： 不涉及 | 表12StorageSelectors | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释**： selector的名字，作为storageGroup中selectorNames的索引。 **约束限制**： 各个selector间的名字不能重复。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | storageType | String | **参数解释**： 存储类型。 **约束限制**： - local存储类型不支持磁盘选择，所有本地盘将被组成一个VG，因此也仅允许只有一个local类型的storageSelector。 - system存储类型不支持磁盘选择，选择系统盘作为系统组件存储磁盘。因此也仅允许只有一个system类型的storageSelector，且name必须为cceUse。 **取值范围**： 当前仅支持evs（云硬盘）、local（本地盘）和system（系统盘）。 **默认取值**： 不涉及 | | matchLabels | [matchLabels] object | **参数解释**： evs盘的匹配字段。 **约束限制**： storageType设置为system（系统盘）时，无需设置此字段。 **取值范围**： 支持DataVolume中的size、volumeType、iops、throughput、metadataEncrypted、metadataCmkid、count字段。 **默认取值**： 不涉及 | 表13matchLabels | 参数 | 参数类型 | 描述 | |:---|:---|:---| | size | String | **参数解释**： 匹配的磁盘大小，不填则无磁盘大小限制。例如：100。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | volumeType | String | **参数解释**： 云硬盘类型，目前支持SSD、GPSSD、SAS、ESSD、SATA等，不填则无云硬盘类型限制。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | iops | String | **参数解释**： 匹配的磁盘iops大小，不填则无磁盘iops大小限制。当需要选择GPSSD2或ESSD2类型磁盘时，配置iops来准确选择磁盘。例如：3000。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | throughput | String | **参数解释**： 匹配的磁盘吞吐量大小，不填则无磁盘吞吐量大小限制。当需要选择GPSSD2类型磁盘时，配置throughput来准确选择磁盘。例如：125。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | metadataEncrypted | String | **参数解释**： 磁盘加密标识符，0代表不加密，1代表加密，不填则无磁盘加密标识符限制。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | metadataCmkid | String | **参数解释**： 加密磁盘的用户主密钥ID，长度为36字节的字符串，不填则无磁盘密钥ID限制。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | count | String | **参数解释**： 磁盘选择个数，不填则选择所有此类磁盘。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表14StorageGroups | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释**： storageGroups的名字，作为虚拟存储组的名字，因此各个group名字不能重复。 **约束限制**： 不涉及 **取值范围**： - 当cceManaged=true时，name必须为：vgpaas。 - 当数据盘作为临时存储卷时：name必须为：vg-everest-localvolume-ephemeral。 - 当数据盘作为持久存储卷时：name必须为：vg-everest-localvolume-persistent。 **默认取值**： 不涉及 | | cceManaged | Boolean | **参数解释**： k8s及runtime所属存储空间。有且仅有一个group被设置为true，不填默认false。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | selectorNames | Array of strings | **参数解释**： 对应storageSelectors中的name，一个group可选择多个selector；但一个selector只能被一个group选择。 **约束限制**： 系统组件无法分别存储于系统盘与数据盘中，因此选择selector的type为system时，group只能选择一个selector。 | | virtualSpaces | Array of [VirtualSpace] objects | **参数解释**： group中空间配置的详细管理。 **约束限制**： 不涉及 | 表15VirtualSpace | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释**： virtualSpace的名称，当前仅支持四种类型：share、kubernetes、runtime、user。 **约束限制**： 不涉及 **取值范围**： - kubernetes：k8s空间配置，需配置lvmConfig； - runtime：运行时空间配置，需配置runtimeConfig； - user：用户空间配置，需配置lvmConfig。 **默认取值**： 不涉及 | | size | String | **参数解释**： virtualSpace的大小，仅支持整数百分比。例如：90%。 **约束限制**： 不涉及 **取值范围**： 该参数取值范围\[10-90\]，一个group中所有virtualSpace的百分比之和不得超过100% **默认取值**： 不涉及 | | lvmConfig | [LVMConfig] object | **参数解释**： lvm配置管理，适用于share、kubernetes和user空间配置。 **约束限制**： 一个virtualSpace仅支持一个config配置。 | | runtimeConfig | [RuntimeConfig] object | **参数解释**： runtime配置管理，适用于运行时空间配置。 **约束限制**： 一个virtualSpace仅支持一个config配置。 | 表16LVMConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | lvType | String | **参数解释**： LVM写入模式：linear、striped。linear：线性模式；striped：条带模式，使用多块磁盘组成条带模式，能够提升磁盘性能。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | path | String | **参数解释**： 磁盘挂载路径，仅在用户配置中生效，支持包含：数字、大小写字母、点、中划线、下划线的绝对路径。 **约束限制**： 挂载路径请填写业务目录路径，不可设置为空或根目录等操作系统关键路径。不可填写的操作系统关键路径如下： /, /home, /home/, /bin, /bin/, /lib, /lib/, /root, /root/, /boot, /boot/, /dev, /dev/, /etc, /etc/, /lost+found, /lost+found/, /mnt, /mnt/, /proc, /proc/,/sbin, /sbin/, /srv, /srv/, /tmp, /tmp/, /var, /var/, /media, /media/, /opt, /opt/, /selinux, /selinux/, /sys, /sys/, /usr, /usr/, /opt/cloud/*, /mnt/paas/* , /home/paas/*, /var/paas/* , /var/lib/*, /var/script/* **取值范围**： 不涉及 **默认取值**： 不涉及 | 表17RuntimeConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | lvType | String | **参数解释**： LVM写入模式：linear、striped。linear：线性模式；striped：条带模式，使用多块磁盘组成条带模式，能够提升磁盘性能。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表18NodePublicIP | 参数 | 参数类型 | 描述 | |:---|:---|:---| | ids | Array of strings | **参数解释**： 已有的弹性IP的ID列表。 **约束限制**： - 数量不得大于待创建节点数； - 若已配置ids参数，则无需配置count和eip参数。 | | count | Integer | **参数解释**： 要动态创建的弹性IP个数。 **约束限制**： count参数与eip参数必须同时配置。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | eip | [NodeEIPSpec] object | **参数解释**： 弹性IP参数。 **约束限制**： 创建节点池时不支持此参数 | 表19NodeEIPSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | iptype | String | **参数解释**： 弹性IP类型，取值请参见申请EIP接口中publicip.type说明。 链接请参见[申请EIP](https://support.huaweicloud.com/api-eip/eip_api_0001.html)。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | bandwidth | [NodeBandwidth] object | **参数解释**： 弹性IP的带宽参数。 **约束限制**： 不涉及 | 表20NodeBandwidth | 参数 | 参数类型 | 描述 | |:---|:---|:---| | chargemode | String | **参数解释**： 带宽的计费类型。 说明： - 按带宽计费：按公网传输速率（单位为Mbps）计费。当您的带宽利用率高于10%时，建议优先选择按带宽计费。 - 按流量计费：只允许在创建按需节点时指定，按公网传输的数据总量（单位为GB）计费。当您的带宽利用率低于10%时，建议优先选择按流量计费。 **约束限制**： 不涉及 **取值范围**： - 未传该字段，表示按带宽计费。 - 字段值为空，表示按带宽计费。 - 字段值为"traffic"，表示按流量计费。 - 字段为其它值，会导致创建云服务器失败。 **默认取值**： 不涉及 | | size | Integer | **参数解释**： 带宽大小，取值请参见申请EIP接口中bandwidth.size说明。 链接请参见[申请EIP](https://support.huaweicloud.com/api-eip/eip_api_0001.html)。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | sharetype | String | **参数解释**： 带宽的共享类型，共享类型枚举：PER，表示独享，目前仅支持独享。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表21NodeNicSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | primaryNic | [NicSpec] object | **参数解释**： 主网卡的描述信息。 **约束限制**： 不涉及 | | extNics | Array of [NicSpec] objects | **参数解释**： 扩展网卡。 **约束限制**： 创建节点池添加节点时不支持该参数。 | 表22NicSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | subnetId | String | **参数解释**： 网卡所在子网的网络ID。若节点池同时配置了subnetList，则节点池扩容子网以subnetList字段为准。 **约束限制**： - 主网卡创建时若未指定subnetId,将使用集群子网； - 扩展网卡创建时必须指定subnetId。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | fixedIps | Array of strings | **参数解释**： 主网卡的IP将通过fixedIps指定，数量不得大于创建的节点数。 **约束限制**： - fixedIps或ipBlock同时只能指定一个 - 扩展网卡不支持指定fixedIps - 创建节点池场景不支持该配置参数 - 节点池场景响应内容中无该字段 | | ipBlock | String | **参数解释**： 主网卡的IP段的CIDR格式，创建的节点IP将属于该IP段内。 **约束限制**： - fixedIps或ipBlock同时只能指定一个。 - 创建节点池场景不支持该配置参数 - 节点池场景响应内容中无该字段 **取值范围**： 不涉及 **默认取值**： 不涉及 | | subnetList | Array of strings | **参数解释**： 网卡所在子网的网络ID列表，支持节点池配置多个子网。 **约束限制**： 最多支持配置20个子网。 | 表23Taint | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释**： K8s污点的键。 **约束限制**： 必须以字母或数字开头和结尾，可以包含字母、数字、连字符、下划线和点，最长63个字符。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | value | String | **参数解释**： K8s污点的值。 **约束限制**： 必须以字母或数字开头和结尾，可以包含字母、数字、连字符、下划线和点，最长63个字符。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | effect | String | **参数解释**： K8s污点的作用效果。 **约束限制**： 不涉及 **取值范围**： 只可选NoSchedule，PreferNoSchedule或NoExecute。 **默认取值**： 不涉及 | 表24UserTag | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释**： 云服务器标签的键。 **约束限制**： 不得以"CCE-"、"__type_baremetal"或"_sys_"开头。 **取值范围**： 标签键不能重复，首尾不能为空，不能包含特殊字符"="，"\*"，"\<"，"\>"，"\\"，","，"\|"，"/"，不能包含非打印字符ASCII(0-31)，长度不超过128个字符。 **默认取值**： 不涉及 | | value | String | **参数解释**： 云服务器标签的值。 **约束限制**： 不涉及 **取值范围**： 标签值首尾不能为空，不能包含特殊字符"="，"\*"，"\<"，"\>"，"\\"，","，"\|"，不能包含非打印字符ASCII(0-31)，长度不超过255个字符。 **默认取值**： 不涉及 | 表25Runtime | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释**： 容器运行时。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： - v1.25以下集群：默认为"docker"； - v1.25及以上集群，随操作系统变化，默认的容器运行时不同； - 操作系统为EulerOS 2.5、EulerOS 2.8的节点默认为"docker"，其余操作系统的节点默认为"containerd"。 | 表26NodeExtendParam | 参数 | 参数类型 | 描述 | |:---|:---|:---| | ecs:performancetype | String | **参数解释**： 云服务器规格的分类。响应中会返回此字段。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | orderID | String | **参数解释**： 订单ID。 **约束限制**： 节点付费类型为自动付费包周期类型时，响应中会返回此字段(仅创建场景涉及)，节点池场景响应返回中无该参数。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | productID | String | **参数解释**： 产品ID。 **约束限制**： 节点付费类型为自动付费包周期类型或者节点池类型是包周期节点池时，响应中会返回此字段。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | maxPods | Integer | **参数解释**： 节点最大允许创建的实例数(Pod)，该数量包含系统默认实例。 该设置的目的为防止节点因管理过多实例而负载过重，请根据您的业务需要进行设置。 节点可以创建多少个Pod，受多个参数影响，具体请参见[节点可创建的最大Pod数量说明](https://support.huaweicloud.com/api-cce/maxPods.html)。 **约束限制**： 不涉及 **取值范围**： 取值范围为16\~256。 **默认取值**： 不涉及 | | periodType | String | **参数解释**： 订购周期类型。 **约束限制**： - 作为请求参数，billingMode为1（包周期）或2（已废弃：自动付费包周期）时生效，且为必选。 - 作为响应参数，仅在创建包周期节点时返回。 **取值范围**： - month：月 - year：年 **默认取值**： 不涉及 | | periodNum | Integer | **参数解释**： 订购周期数。 **约束限制**： - 作为请求参数，billingMode为1（包周期）或2（已废弃：自动付费包周期）时生效，且为必选。 - 作为响应参数，仅在创建包周期节点时返回。 **取值范围**： - periodType=month（周期类型为月）时，取值为\[1-9\]。 - periodType=year（周期类型为年）时，取值为\[1-3\]。 **默认取值**： 不涉及 | | isAutoRenew | String | **参数解释**： 是否自动续订。 **约束限制**： billingMode为1或2（已废弃）时生效，不填写此参数时默认不会自动续费。 **取值范围**： - "true"：自动续订 - "false"：不自动续订 **默认取值**： 不涉及 | | isAutoPay | String | **参数解释**： 下单订购后，是否自动从客户的账户中支付，而不需要客户手动去进行支付。 **约束限制**： billingMode为1或2（已废弃）时生效，billingMode为1时不填写此参数时默认不会自动扣款。（已废弃：billingMode为2时不填写此参数时默认会自动扣款）。 **取值范围**： - "true"：是（自动扣款） - "false"：否（不自动扣款） **默认取值**： 不涉及 | | DockerLVMConfigOverride | String | **参数解释**： Docker数据盘配置项（已废弃，请使用storage字段）。默认配置示例如下： ``` "DockerLVMConfigOverride":"dockerThinpool=vgpaas/90%VG;kubernetesLV=vgpaas/10%VG;diskType=evs;lvType=linear" ``` 默认配置在无VD类型磁盘时，会由于数据盘查找失败而出错，请根据真实盘符类型填写diskType。 **约束限制**： 不涉及 **取值范围**： 包含如下字段： - userLV（可选）：用户空间的大小，示例格式：vgpaas/20%VG - userPath（可选）：用户空间挂载路径，示例格式：/home/wqt-test - diskType：磁盘类型，目前只有evs、hdd和ssd三种格式 - lvType：逻辑卷的类型，目前支持linear和striped两种，示例格式：striped - dockerThinpool：Docker盘的空间大小，示例格式：vgpaas/60%VG - kubernetesLV：Kubelet空间大小，示例格式：vgpaas/20%VG **默认取值**： 不涉及 | | dockerBaseSize | Integer | **参数解释**： 节点上单容器的可用磁盘空间大小（已废弃，请优先使用containerBaseSize参数），单位G。 CCE节点容器运行时空间配置请参考[数据盘空间分配说明](https://support.huaweicloud.com/api-cce/cce_01_0341.html)。 **约束限制**： - Devicemapper模式下建议dockerBaseSize配置不超过80G，设置过大时可能会导致容器运行时初始化时间过长而启动失败，若对容器磁盘大小有特殊要求，可考虑使用挂载外部或本地存储方式代替。 - dockerBaseSize设置仅在v1.19.16-r0、v1.21.3-r0、v1.23.3-r0及以上的集群版本中的EulerOS/HCEOS2.0节点上生效。 **取值范围**： 10-500。 **默认取值**： 不配置该值或值为0时将使用默认值： - Devicemapper模式下默认值为10； - OverlayFS模式默认不限制单容器可用空间大小。 | | containerBaseSize | Integer | **参数解释**： 节点上单容器的可用磁盘空间大小，单位G。 CCE节点容器运行时空间配置请参考[数据盘空间分配说明](https://support.huaweicloud.com/api-cce/cce_01_0341.html)。 **约束限制**： - Devicemapper模式下建议containerBaseSize配置不超过80G，设置过大时可能会导致容器运行时初始化时间过长而启动失败，若对容器磁盘大小有特殊要求，可考虑使用挂载外部或本地存储方式代替；Devicemapper模式在新版中仅有共池裸机使用，已逐步废弃。 - containerBaseSize设置仅在新版本集群（v1.23.14-r0/v1.25.9-r0/v1.27.6-r0/v1.28.4-r0及以上）的EulerOS/HCEOS2.0节点上生效。 - 更新节点池时，不支持更新此参数。 **取值范围**： 10-500。 **默认取值**： 不配置该值或值为0时将使用默认值： - Devicemapper模式下默认值为10； - OverlayFS模式默认不限制单容器可用空间大小。 | | publicKey | String | **参数解释**： 节点的公钥，应用于ssh密钥登录。 **约束限制**： - 当选择使用密钥对方式登录节点时该配置无效 - 创建、更新节点池场景不支持该参数 **取值范围**： 不涉及 **默认取值**： 不涉及 | | alpha.cce/preInstall | String | **参数解释**： 安装前执行脚本。 输入的值需要经过Base64编码，方法如下： ``` echo -n "待编码内容" | base64 ``` **约束限制**： 安装前/后执行脚本统一计算字符，转码后的字符总数不能超过10240。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | alpha.cce/postInstall | String | **参数解释**： 安装后执行脚本。 输入的值需要经过Base64编码，方法如下： ``` echo -n "待编码内容" | base64 ``` **约束限制**： 安装前/后执行脚本统一计算字符，转码后的字符总数不能超过10240。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | alpha.cce/NodeImageID | String | **参数解释**： 节点自定义镜像ID，从IMS控制台获取，需要使用自定义镜像时使用此参数。 **约束限制**： 不涉及 说明： - 若指定了extendParam中的securityReinforcementType参数为cybersecurity，节点将开启安全等保加固功能，则节点的操作系统类型必须使用HCE2.0。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | chargingMode | Integer | **参数解释**： 节点的计费模式。已废弃，请使用NodeSpec中的billingMode字段。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | agency_name | String | **参数解释**： 委托的名称。 委托是由租户管理员在统一身份认证服务（Identity and Access Management，IAM）上创建的，可以为CCE节点提供访问云服务器的临时凭证。 作为响应参数仅在创建节点传入时返回该字段。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | kubeReservedMem | Integer | **参数解释**： 节点内存预留，Kubernetes相关组件预留值。随节点规格变动，具体请参见[节点预留资源策略说明](https://support.huaweicloud.com/usermanual-cce/cce_10_0178.html)。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | systemReservedMem | Integer | **参数解释**： 节点内存预留，系统组件预留值。随节点规格变动，具体请参见[节点预留资源策略说明](https://support.huaweicloud.com/usermanual-cce/cce_10_0178.html)。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | init-node-password | String | **参数解释**： 节点密码，仅作为响应参数时，固定展示星号，节点池场景响应返回中无该参数。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | securityReinforcementType | String | **参数解释**： 指定节点安全加固类型，当前仅支持HCE2.0镜像等保2.0三级安全加固。 等保加固会对身份鉴别、访问控制、安全审计、入侵防范、恶意代码防范进行检查并加固。详情请参见[Huawei Cloud EulerOS 2.0等保2.0三级版镜像概述](https://support.huaweicloud.com/productdesc-hce/hce_sec_0001.html)。 若未指定此参数，则尝试用原有的值补全。如：原先HCE2.0镜像已配置安全加固，更新节点池时未指定此参数，则仍旧保持安全加固配置，若要取消，需显式指定参数值为"null"。 **约束限制**： 不涉及 **取值范围**： - 空值：表示不开启等保加固 - cybersecurity：表示开启等保加固 **默认取值**： 不涉及 | 表27HostnameConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | **参数解释**： K8S节点名称配置类型, 默认为"privateIp"。 **约束限制**： - 配置为cceNodeName的节点, 其节点名称、K8S节点名称以及虚机名称相同。节点名称不支持修改, 并且在ECS侧修改了虚机名称，同步云服务器时，不会将修改后的虚机名称同步到节点。 - 配置为cceNodeName的节点，为了避免K8S节点名称冲突，系统会自动在节点名称后添加后缀，后缀的格式为中划线(-)+五位随机字符，随机字符的取值为\[a-z0-9\]。 **取值范围**： - privateIp: 将节点私有IP作为K8S节点名称 - cceNodeName: 将CCE节点名称作为K8S节点名称 **默认取值**： 默认为"privateIp"。 | 表28nodeNameTemplate | 参数 | 参数类型 | 描述 | |:---|:---|:---| | nodeNamePrefix | String | **参数解释**： 节点名称前缀。如果用户填写为空串或缺省，则节点名称不会增加前缀。 **约束限制**： 仅支持小写字母、数字、连字符（-）和点（.），必须以小写字母开头，并且符合[RFC 1123](https://tools.ietf.org/html/rfc1123)中定义的DNS子域名命名规范。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | nodeNameSuffix | String | **参数解释**： 节点名称后缀。如果用户填写为空串或缺省，则节点名称不会增加后缀。 **约束限制**： 仅支持小写字母、数字、连字符（-）和点（.），后缀结尾必须为小写字母或者数字，并且符合[RFC 1123](https://tools.ietf.org/html/rfc1123)中定义的DNS子域名命名规范。 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表29NodeForConsoleStatus | 参数 | 参数类型 | 描述 | |:---|:---|:---| | phase | String | **参数解释**： 节点状态：节点资源生命周期管理（如安装卸载等）状态和集群内k8s node状态的综合体现 **约束限制**： 创建节点接口返回中无该参数。 **取值范围**： 节点资源生命周期管理（如安装卸载等）状态和集群内K8s node状态的综合体现，取值如下 - Build：创建中，表示节点正处于创建过程中。 - Installing：安装中，表示节点正处于纳管过程中。 - Upgrading：升级中，表示节点正处于升级过程中。 - Active：运行中，表示节点处于正常状态。 - Abnormal：不可用，表示节点处于异常状态。 - Deleting： 删除中，表示节点正处于删除过程中。 - Error：错误，表示节点处于故障状态。 **默认取值**： 不涉及 | | lastProbeTime | String | **参数解释**： 节点最近一次状态检查时间。集群处于异常、冻结或者中间态（例如创建中）时，节点的状态检查动作可能受影响。检查时间超过5分的节点状态不具有参考意义。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | jobID | String | **参数解释**： 创建或删除时的任务ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | serverId | String | **参数解释**： 底层云服务器或裸金属节点ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | privateIP | String | **参数解释**： 节点主网卡私有网段IP地址。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | privateIPv6IP | String | **参数解释**： 节点主网卡私有网段IPv6地址。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | publicIP | String | **参数解释**： 节点弹性公网IP地址。如果ECS的数据没有实时同步，可在界面上通过"同步节点信息"手动进行更新。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | deleteStatus | [DeleteStatus] object | **参数解释**： 删除资源时表示资源删除状态 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | configurationUpToDate | Boolean | **参数解释**： 节点配置是否与所属节点池的节点模板最新配置一致。 当更新节点池os或runtime后，该节点池中存量节点的os或runtime便与节点池存在差异，configurationUpToDate参数值即为false。 重置节点后，存量节点的os和runtime与节点池配置保持一致，configurationUpToDate参数值即为true。 **约束限制**： 创建、更新节点接口返回中无该参数。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | imageID | String | **参数解释**： 节点OS镜像ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表30DeleteStatus | 参数 | 参数类型 | 描述 | |:---|:---|:---| | previous_total | Integer | **参数解释**： 集群删除时已经存在的集群资源记录总数 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | current_total | Integer | **参数解释**： 基于当前集群资源记录信息，生成实际最新资源记录总数 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | updated | Integer | **参数解释**： 集群删除时更新的资源记录总数 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | added | Integer | **参数解释**： 集群删除时新增的资源记录总数 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | deleted | Integer | **参数解释**： 集群删除时删除的资源记录总数 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | #### 请求示例 无 #### 响应示例 **状态码：200** ``` { "kind" : "Node", "apiVersion" : "v3.1", "metadata" : { "name" : "myhost", "uid" : "4d1ecb2c-229a-11e8-9c75-0255ac100ceb", "creationTimestamp" : "2018-08-02 07:37:24.005071325 +0000 UTC", "updateTimestamp" : "2018-08-02 07:44:04.965500815 +0000 UTC", "annotations" : { "kubernetes.io/node-pool.id" : "az1.dc1#s1.medium#EulerOS 2.2" } }, "spec" : { "flavor" : "s1.medium", "az" : "az1.dc1", "os" : "EulerOS 2.2", "login" : { "sshKey" : "KeyPair-001" }, "rootVolume" : { "volumetype" : "SAS", "size" : 40 }, "dataVolumes" : [ { "volumetype" : "SAS", "size" : 100 } ], "publicIP" : { "eip" : { "bandwidth" : { } } }, "billingMode" : 0, "cpu" : 2, "memory" : 4096 }, "status" : { "phase" : "Active", "serverId" : "456789abc-9368-46f3-8f29-d1a95622a568", "publicIP" : "10.34.56.78", "privateIP" : "192.168.1.23", "imageID" : "456789abc-9368-46f3-8f29-d1a95622a568" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cce/ErrorCode.html)。