文档首页/ AI开发平台ModelArts/ API参考/ 资源管理/ 批量为节点绑定逻辑子池
更新时间:2025-10-11 GMT+08:00
分享

批量为节点绑定逻辑子池

功能介绍

批量为节点绑定逻辑子池接口用于在物理专属池开启节点绑定功能时,对逻辑子池中的节点进行逻辑子池的换绑操作。该接口适用于以下场景:当需要重新分配资源、调整业务负载或优化资源使用效率时,用户可通过此接口将指定节点从当前逻辑子池迁移到另一个逻辑子池。使用该接口的前提条件是物理专属池已开启节点绑定功能,且目标逻辑子池已存在并具备足够的资源容量。绑定操作完成后,节点将从原逻辑子池解绑并绑定到目标逻辑子池,原逻辑子池的节点数减少,目标逻辑子池的节点数增加。若节点未绑定到任何逻辑子池、目标逻辑子池不存在或资源不足,或用户无权限操作,接口将返回相应的错误信息。

调试

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

URI

POST /v2/{project_id}/pools/{pool_name}/nodes/batch-bind

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:用户项目ID。获取方法请参见获取项目ID和名称

约束限制:1 - 64字符,字母、数字和中划线。

取值范围:不涉及。

默认取值:不涉及。

pool_name

String

参数解释: 资源池ID。取值资源池详情的metadata.name字段。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

nodes

Array of BindNodeItem objects

参数解释:需要进行换绑的节点列表。

约束限制:不涉及。

drain

Boolean

参数解释:是否对换绑的节点进行排水。

约束限制:不涉及。

取值范围

  • true:排水

  • false:不排水

默认取值:不涉及。

表3 BindNodeItem

参数

是否必选

参数类型

描述

name

String

参数解释:换绑的节点的名称。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

quotaname

String

参数解释:节点绑定的逻辑子池的ID。值为空则节点不绑定任何逻辑子池。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

响应参数

状态码:200

OK。

状态码:404

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:ModelArts错误码。

取值范围:不涉及。

error_msg

String

参数解释:具体错误信息。

取值范围:不涉及。

请求示例

将节点绑定到逻辑子池pool-a26d-prjid中。

POST /v2/{project_id}/pools/{pool_name}/nodes/batch-bind

{
  "nodes" : [ {
    "name" : "os-node-created-8888g",
    "quotaname" : "pool-a26d-prjid"
  } ]
}

响应示例

状态码:200

OK。

{ }

状态码:404

Not Found。

{
  "error_code" : "ModelArts.50015001",
  "error_msg" : "pool not found"
}

状态码

状态码

描述

200

OK。

404

Not Found。

错误码

请参见错误码

相关文档