Locking Node Functions in Batches¶

Function¶

This API is used to lock node functions in batches. Locked functions cannot be used on the console.

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

**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.

**Table 2** Request body parameters¶
Parameter	Mandatory	Type	Description
nodeNames	Yes	Array of strings	Names of nodes to be locked.
actions	Yes	Array of strings	Action performed for a lock. The options are as follows: delete: Delete a lock.

Status code: 200

**Table 3** Response body parameters¶
Parameter	Type	Description
nodes	Array of strings	Names of nodes that are successfully updated.

Status code: 404

**Table 4** Response body parameters¶
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Lock node functions in batches.

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

{
  "nodeNames" : [ "os-node-created-xzz78" ],
  "actions" : [ "delete" ]
}

Status code: 200

OK.

{
  "nodes" : [ {
    "name" : "os-node-created-xzz78"
  } ]
}

Status code: 404

Not found.

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

Status Code	Description
200	OK.
404	Not found.

last updated: 2025-08-26 08:17 UTC - commit: 1ba1873d960563c60759f67898a855d9ba3c3502