批量为节点绑定逻辑子池
功能介绍
批量为节点绑定逻辑子池接口用于在物理专属池开启节点绑定功能时,对逻辑子池中的节点进行逻辑子池的换绑操作。该接口适用于以下场景:当需要重新分配资源、调整业务负载或优化资源使用效率时,用户可通过此接口将指定节点从当前逻辑子池迁移到另一个逻辑子池。使用该接口的前提条件是物理专属池已开启节点绑定功能,且目标逻辑子池已存在并具备足够的资源容量。绑定操作完成后,节点将从原逻辑子池解绑并绑定到目标逻辑子池,原逻辑子池的节点数减少,目标逻辑子池的节点数增加。若节点未绑定到任何逻辑子池、目标逻辑子池不存在或资源不足,或用户无权限操作,接口将返回相应的错误信息。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/pools/{pool_name}/nodes/batch-bind
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释:用户项目ID。获取方法请参见获取项目ID和名称。 约束限制:1 - 64字符,字母、数字和中划线。 取值范围:不涉及。 默认取值:不涉及。 |
|
pool_name |
是 |
String |
参数解释: 资源池ID。取值资源池详情的metadata.name字段。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
nodes |
是 |
Array of BindNodeItem objects |
参数解释:需要进行换绑的节点列表。 约束限制:不涉及。 |
|
drain |
否 |
Boolean |
参数解释:是否对换绑的节点进行排水。 约束限制:不涉及。 取值范围:
默认取值:不涉及。 |
响应参数
状态码:200
OK。
状态码:404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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。 |
错误码
请参见错误码。