批量更新节点 - BatchUpdatePoolNodes
功能介绍
批量更新节点接口用于同时修改多个节点的配置或属性，支持批量操作时各节点独立执行更新流程。该接口适用于以下场景：当用户需统一升级节点软件版本、批量处理选中节点的资源标签、调整资源分配策略、应用安全补丁或同步配置变更时，可通过此接口批量更新目标节点，确保每个节点的更新过程互不影响。使用该接口的前提条件包括：目标节点已存在且用户具备管理员权限，节点需处于可操作状态（如非锁定或维护中），批量操作时需提供有效的节点列表及更新参数（如配置项、版本号等）作为输入。操作完成后，指定节点将应用新配置并更新状态为可用，原有配置将被覆盖。若节点不存在、用户权限不足、节点状态异常（如正在维护）、更新参数不合规或输入参数缺失，接口将返回对应错误信息（如404未找到节点、403权限拒绝、400参数校验失败等）。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
POST /v2/{project_id}/pools/{pool_name}/nodes/batch-update
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释：用户项目ID。获取方法请参见获取项目ID和名称。 约束限制：1 - 64字符，字母、数字和中划线。 取值范围：不涉及。 默认取值：不涉及。 |
|
pool_name |
是 |
String |
参数解释：资源池ID。取值资源池详情的metadata.name字段。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
nodeNames |
是 |
Array of strings |
参数解释：需要更新的节点名称列表。 约束限制：不涉及。 |
|
action |
是 |
String |
参数解释：节点更新的类型。 约束限制：不涉及。 取值范围：可选值如下：
默认取值：不涉及。 |
|
haRedundantEnable |
否 |
Boolean |
参数解释：高可用冗余标签,true为开启节点的高可用冗余。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
|
haRedundantEffect |
否 |
String |
参数解释：高可用冗余标签效果。 约束限制：不涉及。 取值范围：可选值如下：
默认取值：不涉及。 |
|
driver |
否 |
NodeDriver object |
参数解释：节点的驱动状版本和状态信息。 约束限制：不涉及。 |
|
tags |
否 |
Array of NodeTag objects |
参数解释：需要批量操作的资源标签列表。 约束限制：不涉及。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
successNodeNames |
Array of strings |
参数解释：更新成功的节点名称列表。 |
|
failNodeNames |
Array of strings |
参数解释：更新失败的节点名称列表。 |
状态码：404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释：ModelArts错误码。 取值范围：不涉及。 |
|
error_msg |
String |
参数解释：具体错误信息。 取值范围：不涉及。 |
请求示例
开启节点高可用冗余。
POST /v2/{project_id}/pools/{pool_name}/nodes/batch-update
{
"nodeNames" : [ "os-node-created-xzz78" ],
"action" : "openHaRedundant"
}
响应示例
状态码：200
OK。
{
"successNodeNames" : [ {
"name" : "os-node-created-xzz78",
"status" : "success"
} ]
}
状态码：404
Not Found。
{
"error_code" : "ModelArts.50015001",
"error_msg" : "pool not found"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK。 |
|
404 |
Not Found。 |
错误码
请参见错误码。
