Help Center/ ModelArts/ API Reference/ Node Management/ Binding Nodes to a Logical Subpool in Batches
Updated on 2025-11-19 GMT+08:00
View PDF
Share

Binding Nodes to a Logical Subpool in Batches

Function

This API is used to bind nodes in a logical subpool to another logical subpool when node binding is enabled for a physical dedicated pool.

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-bind

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition: User project ID. For details, see Obtaining a Project ID and Name.

Constraints: N/A

Range: N/A

Default Value: N/A

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 BindNodeItem objects

List of nodes to be bound with another pool.

drain

No

Boolean

Specifies whether to drain the node to be bound with another pool. true: The node will be drained.
Table 3 BindNodeItem

Parameter

Mandatory

Type

Description

name

Yes

String

Name of the node to be bound with another pool.

quotaname

No

String

ID of the logical subpool bound to the node. If the value is empty, the node is not bound to any logical subpool.

Response Parameters

Status code: 200

Request succeeded.

Status code: 404

Table 4 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

Bind nodes to logical subpool pool-a26d-prjid.

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

{
  "nodes" : [ {
    "name" : "os-node-created-8888g",
    "quotaname" : "pool-a26d-prjid"
  } ]
}

Example Responses

Status code: 200

Request succeeded.

{ }

Status code: 404

Not found.

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

Status Codes

Status Code

Description

200

Request succeeded.

404

Not found.

Error Codes

See Error Codes.

Parent topic: Node Management