Updated on 2026-08-14 GMT+08:00

Modifying a Single Disk Attached to an ECS

This API is used to modify the information about a single disk attached to an ECS.

Currently, only the delete_on_termination parameter can be modified.

PUT /v1/{project_id}/cloudservers/{server_id}/block_device/{volume_id}

Table 1 lists the parameters.

**Table 1** Parameter description
Parameter	Mandatory	Description
project_id	Yes	Definition Specifies the project ID. For details about how to obtain the ID, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A
server_id	Yes	Definition Specifies the ECS ID. Constraints N/A Range N/A Default Value N/A
volume_id	Yes	Definition Specifies the disk ID. Constraints N/A Range N/A Default Value N/A

**Table 2** Request parameter
Parameter	Mandatory	Type	Description
block_device	Yes	Object	Definition Updates the information about a disk attached to the ECS. For details, see Table 3. Constraints N/A Range N/A Default Value N/A

**Table 3** **block_device** parameter
Parameter	Mandatory	Type	Description
delete_on_termination	Yes	Boolean	Definition Specifies whether the disk attached to the ECS is deleted when the ECS is deleted. Constraints Yearly/monthly-billed disks cannot be modified. Shared disks cannot be modified. System disks cannot be modified. Range true: The disk is deleted when the ECS is deleted. false: The disk is not deleted when the ECS is deleted. Default Value N/A

None

Set a disk to be deleted together with the ECS when the attached ECS is deleted.

PUT https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/block_device/{volume_id}
{
	"block_device": {
		"delete_on_termination": true
	}
}

None

Parent topic: Disk Management