Help Center/ ModelArts/ API Reference/ Node Management/ Changing the Node Specifications
Updated on 2025-08-20 GMT+08:00
View PDF
Share

Changing the Node Specifications

Function

This API is used to change the node specifications (step). For example, the number of nodes can be increased from 8 to 16.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

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

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details, see Obtaining a Project ID and Name.

pool_name

Yes

String

Resource pool ID. The value is the metadata.name field in the resource pool details.

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

nodes

Yes

Array of ResizeNodeInfo objects

Definition: Information about the batch of supernodes to be scaled.

Constraints: A maximum of 50 supernodes can be scaled at a time.

Range: N/A

Default Value: N/A

source

Yes

NodeResizeParams object

Definition: Source node pool and specifications information of the supernode to be changed.

Constraints: N/A

Range: N/A

Default Value: N/A

target

Yes

NodeResizeParams object

Definition: Target node pool and specifications information of the supernode to be changed.

Constraints: N/A

Range: N/A

Default Value: N/A
Table 3 ResizeNodeInfo

Parameter

Mandatory

Type

Description

batchUID

No

String

Node batch ID, which is required for batch change and can be obtained from the os.modelarts.node/batch.uid tag of the node.

deleteNodeNames

No

Array of strings

List of nodes to be scaled in a batch scale-in scenario.
Table 4 NodeResizeParams

Parameter

Mandatory

Type

Description

nodePool

No

String

Node pool.

flavor

No

String

Specifications.

creatingStep

No

creatingStep object

Step.
Table 5 creatingStep

Parameter

Mandatory

Type

Description

type

No

String

Step type.

step

No

String

Step size.

Response Parameters

Status code: 200

OK

Status code: 404

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

  • Definition: ModelArts error code.

Range: N/A

error_msg

String

Definition: Error message.

Range: N/A

Example Requests

Increasing the number of nodes from 8 to 10 in a supernode batch e7d2ad87-f082-445e-ade0-e493147a1570

/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
    }
  }
}

Example Responses

Status code: 200

OK

{ }

Status code: 404

Not found

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

Status Codes

Status Code

Description

200

OK

404

Not found

Error Codes

See Error Codes.

Parent topic: Node Management