文档首页/ AI开发平台ModelArts/ API参考/ 节点池管理/ 更新节点池

更新时间：2025-10-10 GMT+08:00

查看PDF

更新节点池

功能介绍

更新节点池接口用于修改指定节点池的配置信息。该接口适用于以下场景：当需要扩展节点池容量、调整节点规格、优化资源分配或修复节点池配置时，用户可通过此接口更新节点池的相关信息。使用该接口的前提条件是节点池已存在且用户具有管理员权限。更新操作完成后，节点池的配置将被更新，包括节点数量、规格、网络配置等参数。若节点池不存在、用户无权限操作或配置参数错误，接口将返回相应的错误信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

PATCH /v2/{project_id}/pools/{pool_name}/nodepools/{nodepool_name}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：用户项目ID。获取方法请参见获取项目ID和名称。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
pool_name	是	String	参数解释：资源池名称。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
nodepool_name	是	String	参数解释：节点池名称。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	是	String	参数解释：消息体的类型（格式）。约束限制：不涉及。取值范围：可选值如下： application/merge-patch+json 默认取值：不涉及。

表3 请求Body参数
参数	是否必选	参数类型	描述
spec	是	NodePoolSpec object	参数解释：更新节点池的请求体。约束限制：不涉及。

表4 NodePoolSpec
参数	是否必选	参数类型	描述
resources	是	PoolResource object	参数解释：节点池中的资源信息列表，包括资源规格和相应规格的资源数量，自定义配置等。取值范围：不涉及。

表5 PoolResource
参数	是否必选	参数类型	描述
flavor	是	String	参数解释：资源规格名称，比如：modelarts.vm.gpu.t4u8。取值范围：不涉及。
count	是	Integer	参数解释：规格保障使用量。取值范围：不涉及。
maxCount	是	Integer	参数解释：资源规格的弹性使用量，物理池该值和count相同，逻辑池该值大于等于count。取值范围：不涉及。
azs	否	Array of PoolNodeAz objects	参数解释：节点池az分布。
nodePool	否	String	参数解释：节点池名称。比如：nodePool-1。取值范围：不涉及。
taints	否	Array of Taints objects	参数解释：支持给创建出来的节点加taints来设置反亲和性，非特权池不能指定。
labels	否	Map<String,String>	参数解释： k8s标签，格式为key/value键值对。取值范围：不涉及。
tags	否	Array of UserTags objects	参数解释：资源标签，非特权池不能指定。取值范围：不涉及。
network	否	NodeNetwork object	参数解释：网络配置，非特权池不能指定。
extendParams	否	Map<String,String>	参数解释：自定义配置参数。 "dockerBaseSize": 指定资源池节点的容器引擎空间大小。值为0时表示不限制大小。
creatingStep	否	CreatingStep object	参数解释：批量创建信息。
os	否	Os object	参数解释：操作系统镜像信息。

表6 PoolNodeAz
参数	是否必选	参数类型	描述
az	是	String	参数解释：可用区名称。取值范围：不涉及。
count	是	Integer	参数解释：可用区资源实例的数量。取值范围：不涉及。

表7 Taints
参数	是否必选	参数类型	描述
key	是	String	参数解释：键。取值范围：不涉及。
value	否	String	参数解释：值。取值范围：不涉及。
effect	是	String	参数解释：作用效果。取值范围：不涉及。

表8 UserTags
参数	是否必选	参数类型	描述
key	是	String	参数解释：键。不得以"CCE-"或"__type_baremetal"开头"。取值范围：不涉及。
value	是	String	参数解释：值。取值范围：不涉及。

表9 NodeNetwork
参数	是否必选	参数类型	描述
vpc	否	String	参数解释：vpc id。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
subnet	否	String	参数解释：子网id。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
securityGroups	否	Array of strings	参数解释：安全组id集合。约束限制：不涉及。

**表10** CreatingStep
参数	是否必选	参数类型	描述
step	否	Integer	参数解释：超节点的步长。仅支持资源规格详情中包含的步长。取值范围：不涉及。
type	否	String	参数解释：批量创建类型。取值范围：可选值如下： hyperinstance：超节点。

**表11** Os
参数	是否必选	参数类型	描述
name	否	String	参数解释：操作系统名称。取值范围：不涉及。
imageId	否	String	参数解释：操作系统镜像ID。取值范围：不涉及。
imageType	否	String	参数解释：操作系统镜像类型。取值范围：可选值如下： private：私有镜像。

响应参数

状态码：200

**表12** 响应Body参数
参数	参数类型	描述
spec	NodePoolSpec object	参数解释：更新节点池的请求体。约束限制：不涉及。

**表13** NodePoolSpec
参数	参数类型	描述
resources	PoolResource object	参数解释：节点池中的资源信息列表，包括资源规格和相应规格的资源数量，自定义配置等。取值范围：不涉及。

**表14** PoolResource
参数	参数类型	描述
flavor	String	参数解释：资源规格名称，比如：modelarts.vm.gpu.t4u8。取值范围：不涉及。
count	Integer	参数解释：规格保障使用量。取值范围：不涉及。
maxCount	Integer	参数解释：资源规格的弹性使用量，物理池该值和count相同，逻辑池该值大于等于count。取值范围：不涉及。
azs	Array of PoolNodeAz objects	参数解释：节点池az分布。
nodePool	String	参数解释：节点池名称。比如：nodePool-1。取值范围：不涉及。
taints	Array of Taints objects	参数解释：支持给创建出来的节点加taints来设置反亲和性，非特权池不能指定。
labels	Map<String,String>	参数解释： k8s标签，格式为key/value键值对。取值范围：不涉及。
tags	Array of UserTags objects	参数解释：资源标签，非特权池不能指定。取值范围：不涉及。
network	NodeNetwork object	参数解释：网络配置，非特权池不能指定。
extendParams	Map<String,String>	参数解释：自定义配置参数。 "dockerBaseSize": 指定资源池节点的容器引擎空间大小。值为0时表示不限制大小。
creatingStep	CreatingStep object	参数解释：批量创建信息。
os	Os object	参数解释：操作系统镜像信息。

**表15** PoolNodeAz
参数	参数类型	描述
az	String	参数解释：可用区名称。取值范围：不涉及。
count	Integer	参数解释：可用区资源实例的数量。取值范围：不涉及。

**表16** Taints
参数	参数类型	描述
key	String	参数解释：键。取值范围：不涉及。
value	String	参数解释：值。取值范围：不涉及。
effect	String	参数解释：作用效果。取值范围：不涉及。

**表17** UserTags
参数	参数类型	描述
key	String	参数解释：键。不得以"CCE-"或"__type_baremetal"开头"。取值范围：不涉及。
value	String	参数解释：值。取值范围：不涉及。

**表18** NodeNetwork
参数	参数类型	描述
vpc	String	参数解释：vpc id。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
subnet	String	参数解释：子网id。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
securityGroups	Array of strings	参数解释：安全组id集合。约束限制：不涉及。

**表19** CreatingStep
参数	参数类型	描述
step	Integer	参数解释：超节点的步长。仅支持资源规格详情中包含的步长。取值范围：不涉及。
type	String	参数解释：批量创建类型。取值范围：可选值如下： hyperinstance：超节点。

**表20** Os
参数	参数类型	描述
name	String	参数解释：操作系统名称。取值范围：不涉及。
imageId	String	参数解释：操作系统镜像ID。取值范围：不涉及。
imageType	String	参数解释：操作系统镜像类型。取值范围：可选值如下： private：私有镜像。

状态码：400

**表21** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：ModelArts错误码。取值范围：不涉及。
error_msg	String	参数解释：具体错误信息。取值范围：不涉及。

请求示例

更新节点池。

PATCH https://{endpoint}/v2/{project_id}/pools/{pool_name}/nodepools/{nodepool_name}

{
  "spec" : {
    "resources" : {
      "nodePool" : "modelarts.vm.2u4g.dcc-Default",
      "flavor" : "modelarts.vm.2u4g.dcc",
      "count" : 1,
      "maxCount" : 1,
      "network" : {
        "vpc" : "277e9abc-0e6b-431a-9232-cfd25d5fc566",
        "subnet" : "03796378-c356-4c14-826b-e4913aa9c8b9",
        "securityGroups" : [ "0a15b48d-06f1-41e4-b782-ade90087bf59" ]
      }
    }
  }
}

响应示例

状态码：200

OK。

{
  "spec" : {
    "resources" : {
      "nodePool" : "modelarts.vm.2u4g.dcc-Default",
      "flavor" : "modelarts.vm.2u4g.dcc",
      "count" : 1,
      "maxCount" : 1,
      "network" : {
        "vpc" : "277e9abc-0e6b-431a-9232-cfd25d5fc566",
        "subnet" : "03796378-c356-4c14-826b-e4913aa9c8b9",
        "securityGroups" : [ "0a15b48d-06f1-41e4-b782-ade90087bf59" ]
      }
    }
  }
}

状态码：400

Bad request

{
  "error_code" : "ModelArts.50004000",
  "error_msg" : "Bad request."
}

状态码

状态码	描述
200	OK。
400	Bad request

错误码

请参见错误码。

父主题： 节点池管理

上一篇：查询指定节点池详情

下一篇：删除节点池

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问