节点规格变更
功能介绍
节点规格变更接口用于调整指定节点的规格（如步长），例如将节点从8节点超节点扩容到16节点超节点。该接口适用于以下场景：当需要根据业务需求调整节点的资源容量、优化资源利用率或进行系统升级时，用户可通过此接口变更节点的规格。使用该接口的前提条件是节点已创建且处于可变更状态，目标规格在支持范围内，且用户具有管理员权限。规格变更完成后，节点的资源容量将按新规格调整，相关服务和配置将重新加载以适应新的规格。若节点不存在、节点状态不允许变更、目标规格不支持或用户无权限操作，接口将返回相应的错误信息。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/pools/{pool_name}/nodes/batch-resize
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释：用户项目ID。获取方法请参见获取项目ID和名称。 约束限制：1 - 64字符，字母、数字和中划线。 取值范围：不涉及。 默认取值：不涉及。 |
|
pool_name |
是 |
String |
参数解释：资源池ID。取值资源池详情的metadata.name字段。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
nodes |
是 |
Array of ResizeNodeInfo objects |
参数解释：扩缩容的超节点批次信息。 约束限制：单次最多50个超节点。 |
|
source |
是 |
NodeResizeParams object |
参数解释：超节点变更的源节点池和规格信息。 约束限制：不涉及。 |
|
target |
是 |
NodeResizeParams object |
参数解释：超节点变更的目标节点池和规格信息。 约束限制：不涉及。 |
响应参数
状态码：200
OK。
状态码：404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释：ModelArts错误码。 取值范围：不涉及。 |
|
error_msg |
String |
参数解释：具体错误信息。 取值范围：不涉及。 |
请求示例
将超节点批次e7d2ad87-f082-445e-ade0-e493147a1570从8节点扩容到10节点。
/v2/{project_id}/pools/{pool_name}/nodes/scale-hyperinstance-batch
{
"nodes" : [ {
"batchUID" : "e7d2ad87-f082-445e-ade0-e493147a1570"
} ],
"source" : {
"nodePool" : "np01",
"flavor" : "modelarts.bm.npu.arm.snt9c",
"creatingStep" : {
"type" : "hyperinstance",
"step" : 8
}
},
"target" : {
"nodePool" : "np02",
"flavor" : "modelarts.bm.npu.arm.snt9c",
"creatingStep" : {
"type" : "hyperinstance",
"step" : 10
}
}
}
响应示例
状态码：200
OK。
{ }
状态码：404
Not Found。
{
"error_code" : "ModelArts.50015001",
"error_msg" : "pool not found"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK。 |
|
404 |
Not Found。 |
错误码
请参见错误码。
