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

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

查看PDF

创建节点池

功能介绍

创建节点池。

调试

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

URI

POST /v2/{project_id}/pools/{pool_name}/nodepools

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	用户项目ID。获取方法请参见获取项目ID和名称。
pool_name	是	String	资源池名称。

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
apiVersion	是	String	API版本。可选值如下： v2
kind	是	String	节点池类型。可选值如下： NodePool：节点池
metadata	是	CreateNodePoolMetaVO object	节点池的metadata信息。
spec	否	NodePoolSpec object	节点池创建请求体。

表3 CreateNodePoolMetaVO
参数	是否必选	参数类型	描述
name	是	String	节点池名称。
annotations	否	CreateNodePoolAnnotations object	节点池的注释信息。

表4 CreateNodePoolAnnotations
参数	是否必选	参数类型	描述
os.modelarts/billing.mode	否	String	计费模式，可选值如下： 0：按需计费 1：包周期计费
os.modelarts/period.num	否	String	包周期订购周期，比如2。当计费模式为包周期时该参数必传。
os.modelarts/period.type	否	String	包周期订购类型。可选值如下： 2：月 3：年 4：小时当计费模式为包周期时该参数必传。
os.modelarts/auto.renew	否	String	是否自动续费.可选值如下： 0：不自动续费，默认值 1：自动续费
os.modelarts/promotion.info	否	String	用户在运营平台选择的折扣信息。
os.modelarts/service.console.url	否	String	订购订单支付完成后跳转的url地址。
os.modelarts/order.id	否	String	订单id，包周期资源创建或者计费模式变更的时候该参数必需。

表5 NodePoolSpec
参数	是否必选	参数类型	描述
resources	是	PoolResource object	节点池中的资源信息列表，包括资源规格和相应规格的资源数量，自定义配置等。

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

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

表8 Taint
参数	是否必选	参数类型	描述
key	是	String	键。
value	否	String	值。
effect	是	String	作用效果。

表9 UserTag
参数	是否必选	参数类型	描述
key	是	String	键。不得以"CCE-"或"__type_baremetal"开头
value	是	String	值。

**表10** NodeNetwork
参数	是否必选	参数类型	描述
vpc	否	String	vpc id。
subnet	否	String	子网id。
securityGroups	否	Array of strings	安全组id集合。

**表11** CreatingStep
参数	是否必选	参数类型	描述
step	否	Integer	创建步长。
type	否	String	批量创建类型。可选值如下： rack：表示整柜。

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

响应参数

状态码：200

**表13** 响应Body参数
参数	参数类型	描述
apiVersion	String	API版本。可选值如下： v2
kind	String	节点池类型。可选值如下： NodePool：节点池
metadata	CreateNodePoolMetaVO object	节点池的metadata信息。
spec	NodePoolSpec object	节点池创建请求体。

**表14** CreateNodePoolMetaVO
参数	参数类型	描述
name	String	节点池名称。
annotations	CreateNodePoolAnnotations object	节点池的注释信息。

**表15** CreateNodePoolAnnotations
参数	参数类型	描述
os.modelarts/billing.mode	String	计费模式，可选值如下： 0：按需计费 1：包周期计费
os.modelarts/period.num	String	包周期订购周期，比如2。当计费模式为包周期时该参数必传。
os.modelarts/period.type	String	包周期订购类型。可选值如下： 2：月 3：年 4：小时当计费模式为包周期时该参数必传。
os.modelarts/auto.renew	String	是否自动续费.可选值如下： 0：不自动续费，默认值 1：自动续费
os.modelarts/promotion.info	String	用户在运营平台选择的折扣信息。
os.modelarts/service.console.url	String	订购订单支付完成后跳转的url地址。
os.modelarts/order.id	String	订单id，包周期资源创建或者计费模式变更的时候该参数必需。

**表16** NodePoolSpec
参数	参数类型	描述
resources	PoolResource object	节点池中的资源信息列表，包括资源规格和相应规格的资源数量，自定义配置等。

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

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

**表19** Taint
参数	参数类型	描述
key	String	键。
value	String	值。
effect	String	作用效果。

**表20** UserTag
参数	参数类型	描述
key	String	键。不得以"CCE-"或"__type_baremetal"开头
value	String	值。

**表21** NodeNetwork
参数	参数类型	描述
vpc	String	vpc id。
subnet	String	子网id。
securityGroups	Array of strings	安全组id集合。

**表22** CreatingStep
参数	参数类型	描述
step	Integer	创建步长。
type	String	批量创建类型。可选值如下： rack：表示整柜。

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

状态码：400

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

请求示例

创建节点池。

POST https://{endpoint}/v2/{project_id}/pools/{pool_name}/nodepools

{
  "kind" : "NodePool",
  "apiVersion" : "v2",
  "metadata" : {
    "name" : "nodepool-1",
    "annotations" : { }
  },
  "spec" : {
    "resources" : {
      "nodePool" : "nodepool-1",
      "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。

{
  "kind" : "NodePool",
  "apiVersion" : "v2",
  "metadata" : {
    "name" : "nodepool-1",
    "annotations" : { }
  },
  "spec" : {
    "resources" : {
      "nodePool" : "nodepool-1",
      "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提问云社区提问