Updated on 2026-05-30 GMT+08:00

Deleting Nodes from an Instance

Function

This API is used to delete nodes from an instance.

Constraints

Nodes in different groups cannot be deleted at the same time.

URI

DELETE /v3/{project_id}/instances/{instance_id}/nodes

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID of a tenant in a region

To obtain this value, see Obtaining a Project ID.

instance_id

Yes

String

DDM instance ID

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token

You can obtain the token by calling the IAM API used to obtain a user token.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

node_ids

Yes

Array of strings

ID list of nodes to be deleted. Only nodes in the same group can be selected. After a specified node is deleted from a group, there must be at least one node in the group.

Example Request

Deleting nodes
DELETE https://{endpoint}/v3/{project_id}/instances/{instance_id}/nodes
{
  "node_ids": ["116ba14da45678d28ecd83a38c218907no02"]
}

Response Parameters

  • Normal response
    Table 4 Response body parameters

    Parameter

    Type

    Description

    job_id

    String

    Job ID.

    order_id

    String

    Order ID. This parameter is returned only when nodes of a yearly/monthly instance are deleted.

  • Normal response example
    {
      "job_id" : "9fe84a77-6a6b-4b03-9a3e-db910a548657"
    }

    Buying a yearly/monthly instance:

    {
      "order_id" : "CS1810251738L8VVD"
    }

Status Codes

Error Codes

For details, see Error Codes.