更新时间:2026-11-12 GMT+08:00

批量为节点绑定逻辑子池 - BatchBindPoolNodes

功能介绍

批量为节点绑定逻辑子池接口用于在物理专属池开启节点绑定功能时,将指定节点从原逻辑子池换绑至目标逻辑子池。该接口适用于以下场景:当用户需优化资源分配策略、调整逻辑子池归属以匹配业务需求、或因逻辑子池配置变更需重新绑定节点时,可通过此接口批量完成节点归属关系的更新。使用该接口的前提条件包括:物理专属池已开启节点绑定功能且用户具备管理员权限,目标节点与逻辑子池需处于可操作状态(如非锁定或维护中),原逻辑子池与目标逻辑子池需属于同一物理专属池且资源类型兼容,同时需提供有效的节点列表及目标逻辑子池标识符作为输入参数。操作完成后,指定节点将归属至目标逻辑子池,其资源分配策略与原逻辑子池解绑。若物理专属池未开启绑定功能、用户权限不足、节点或逻辑子池不存在、资源类型不匹配或输入参数缺失,接口将返回对应错误信息(如403权限拒绝、404未找到资源、400参数校验失败等)。

调试

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

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    modelarts:pool:updatePool

    Write

    pool *

    • g:ResourceTag/<tag-key>

    • g:EnterpriseProjectId

    modelarts:pool:update

    -

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

无

状态码: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

{ }

状态码:404

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

状态码

状态码

描述

200

OK。

404

Not Found。

错误码

请参见错误码。